bcquality/microsoft/skills/review
Jesper Schulz-Wedde b11f3ec506 Improve PR-review parity: suggestion blocks, missing KB articles, privacy cross-ref
Adds the contract field, skill instructions, and two knowledge articles
that BCAppsBCQuality's PR-review agent needs to match (and exceed) the
coverage of the embedded review agent in BCAppsCampAIRHack:

skills/do.md
- New optional findings[].suggested-code field. Documents what it MUST
  contain (a literal line-replacement payload) and when to emit it.

microsoft/skills/review/al-code-review.md
- Instructs both the agent self-review pass and rolled-up sub-skill
  findings to populate suggested-code when the fix is mechanical.
- Lists examples (dead code removal, Count > 0 -> IsEmpty, object-scope
  Label) that map to issues observed in the parity comparison.

microsoft/knowledge/style/telemetry-event-id-stable-unique.{md,bad.al,good.al}
- New knowledge article: telemetry event IDs must be stable, unique,
  and non-placeholder. Closes a gap surfaced by the parity comparison.

microsoft/knowledge/style/labels-declared-at-object-scope.{md,bad.al,good.al}
- New knowledge article: Labels must live in the object-level var
  block, not in procedure-local var blocks. Closes the second gap.

microsoft/knowledge/privacy/no-pii-in-telemetry-message-string.md
- Adds an explicit note that changing DataClassification alone does not
  make embedding PII into the message string acceptable, plus links to
  the two adjacent privacy articles. Resolves the privacy advice the
  parity comparison flagged as ambiguous.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-05-27 15:45:49 +02:00
..
al-code-review.md Improve PR-review parity: suggestion blocks, missing KB articles, privacy cross-ref 2026-05-27 15:45:49 +02:00
al-performance-review.md Sync knowledge articles with review agent instructions 2026-05-05 14:08:32 +02:00
al-privacy-review.md Sync knowledge articles with review agent instructions 2026-05-05 14:08:32 +02:00
al-security-review.md Sync knowledge articles with review agent instructions 2026-05-05 14:08:32 +02:00
al-style-review.md Expand review skills to match the 6-domain knowledge corpus 2026-04-23 17:18:17 +02:00
al-ui-review.md Sync knowledge articles with review agent instructions 2026-05-05 14:08:32 +02:00
al-upgrade-review.md Sync knowledge articles with review agent instructions 2026-05-05 14:08:32 +02:00