zr-validate

zr-validate

目的

完了したピアレビューを独立して検証します。

入力

• kind: ValidateReview を含むディスパッチ済みのアクションペイロード
• ルーティングされたレビュー／タスク／PR のコンテキスト

検証要件

ルーティングされたレビューについて、次の3項目すべてを確認します。

1. レビュアーの独立性

   • レビュアーがタスクの担当者／PR の作成者ではない
   • 検証者がレビュアーとは異なるエージェントである

2. 結果が証拠に基づいていること

   • すべてのレビューコメントを確認する
   • 「Critical」重大度の問題を確認する
   • 重大またはブロッキングな問題がある状態で「Request changes」となっていないことを確認する

3. 概要に実質的な内容があること

   • 単なる「LGTM」の追認ではない
   • レビューでタスク要件に言及している
   • 少なくとも何らかのコード品質に関するフィードバックがある（軽微なものでも可）

検証チェックリスト

PR: [URL]
Task: #[ID]
Review: #[REVIEW_ID]

Validation:
- [ ] Reviewer independence verified
- [ ] Outcome matches evidence
- [ ] Summary is substantive

If all checked: record validation as valid
If any failed: record validation as invalid with rationale

手順

1. ルーティングされたレビュー／タスク／PR のコンテキストを読み込みます。
2. レビューの概要と、それを裏付ける PR のコンテキストを確認します。
3. 上記の3つの検証項目を適用します。
4. valid または invalid を決定します。
5. GitHub のレビュー／コメントの記録を残し、その後 Probe で完了します。

probe action show <action-id> --json
probe task get <task-id>
gh pr view <number> --repo <org.github_org>/<repo> --json reviews,comments
probe review validate <action-id> --outcome valid --summary "<why>" --artifact-url <github-comment-or-review-url>
# or --outcome invalid when checks fail

このスキルで行わないこと

• 詳細なコードレビュー
• タスク担当者の割り当て
• 最終的なマージの実行

このスキルはルーティングされたレビューを検証し、その検証をアクションの完了として記録します。

アンチパターン

• 自分自身のレビューを検証する
• 明らかなブロッキング懸念を無視する
• 1行だけの追認的な検証概要
• ルーティングされたコンテキストを確認せずに検証を完了する

出力契約

• ルーティングされた ValidateReview アクションが valid または invalid で完了している。
• 検証の概要が明確で、監査しやすい。

マージ準備完了のディスパッチ（MergeReadyTask）

検証ではなく、マージ準備完了のタスクアクションがルーティングされた場合：

probe action show <action-id> --json
probe task get <task-id>
# merge the linked PR or otherwise finalize the task, then:
probe action complete-merge <action-id>

マージ準備完了のルートでは probe action complete を呼び出さないでください。