heyeddi-pr-review について
heyeddi-pr-review は、QA リード、作者、製品・エンジニアリングのレビュアー向けのレビュー用スキルです。コミット済みの PR 差分だけを対象にし、チェックリストに沿って情報収集から判定まで進めます。
主な機能
- 01コミット済みの PR 差分のみをレビュー
- 02ドキュメントのずれとテスト不足を確認
- 03製品コンテキストと受け入れ条件を読み込む
- 04変更パスに応じた専門レビューを実施
- 05承認・修正依頼・ブロックの判定を定義
活用シーン
- 01チームメンバーの PR をレビュー
- 02レビュー依頼前のセルフチェック
- 03製品要件とドキュメントの整合性確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ heyeddi-com/ heyeddi-skills --skill heyeddi-pr-reviewインストール後、Claude Code で/heyeddi-pr-reviewを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
manifest.jsonreference.mdcontext/ANTI_PATTERNS.mdEXAMPLES.mdPROSE_ANTI_SLOP.mdVOCABULARY.mdfixtures/sample-pr-diff.jsonreference/review-checklist.mdsubagents.mdscripts/_auto_sync.py_heyeddi_paths.py_pr_context.py_skill_cli.py_untrusted_doc.pyaudit_pr_changes.pycheck_doc_drift.pyfetch_pr_context.pyREADME.mdverify_pr_review.pywrite_pr_review.py詳細
HeyEddi PR レビュー
提出済みPRのレビューワークフロー:ローカルのWIPではなく、コミット済みの変更(base...head)のみを判定します。
このワークフローでは、あなたはレビューワーです。すべての判定の対象をPRの差分(base...head)に限定してください。未コミットのファイルは無視してください。
成果物: .heyeddi/docs/pr-<N>-review.md と pr-<N>-context.json は一時的なセッション用スクラッチです。リポジトリのルートには置かず、コミットしないでください。永続的な記録にはGitHub(任意で gh pr review)を使用します。
使用する場面
| 状況 | 担当者 |
|---|---|
| チームメイトのPRをレビューして承認する | QA/リード |
| レビューを依頼する前に作成者がセルフチェックする | 作成者 |
| プロダクトとドキュメントの整合性についてPM/エンジニアが承認する | @heyeddi-product がPRの範囲についてこちらに委任 |
このスキルの対象外: 人間によるレビューコメントへの返信 → @heyeddi-pr-respond。
サブエージェント(デフォルト)
reference/subagents.md を参照してください。最終判定はメインチャットが行い、取得とスキャンは Task shell 経由で委任します。
必須のパイプライン
reference/review-checklist.md を読んでください。
fetch_pr_context --pr <N> → cache + paths; title/body not in stdout
check_doc_drift --pr <N> → product.md / design.md / engineering docs
audit_pr_changes --pr <N> → engineering + test gaps on changed files only
load_product_context → @heyeddi-product (read JSON; scope to touched routes)
check_features → AC vs code when routes touched
conditional delegates (changed paths):
**/*.vue → @visual-auditor, @no-duplicate-ui, @vue-design-system
**/composables/** → @composable-patterns
backend/** → @engineering-excellence audit_engineering
pre_merge_gate → tests, build, types (hard gate)
write_pr_review --pr <N> --force → scaffold + merge tool JSON into report
→ YOU fill: Summary verdict, Product fit, PM judgment
verify_pr_review --pr <N> --check → report complete before posting
判定(あなたが記述)
| 判定 | 条件 |
|---|---|
| 承認 | ゲートに合格し、ドキュメントが整合していて、新しい動作がテスト済みであり、ブロッカーがない |
| 変更を要求 | ドキュメントの不整合、テスト不足、プロダクト/ACの不足、ゲートの失敗 |
| ブロック | 主要ルートを破壊する、セキュリティ上の懸念がある、または product.md と矛盾する |
ユーザーから依頼された場合は、GitHubでレビューを投稿できます(gh pr review)。デフォルトでは .heyeddi/docs/ にのみ報告します。
禁止事項
- 未コミットの作業ツリーの変更をレビューする
- 必須チェックに対して
pre_merge_gateを実行せずに承認する - PRでルートまたは公開APIを変更しているのに、ドキュメントの不整合を見逃す
- テストの証拠(ユニット、統合、または手順が文書化された手動AC)なしに、ユーザー向けの新しい動作を承認する
関連スキル
| スキル | このワークフローでの役割 |
|---|---|
@heyeddi-product | プロダクトの背景情報、機能マトリクス、AC |
@engineering-excellence | audit_pr_changes が問題を検出した場合の詳細な監査 |
@pre-merge-gate | 最終的な必須ゲート |
@heyeddi-pr-respond | レビュー後に人間からのフィードバックに対応 |
タスク完了時:次のスキルを提案する
このスキルについてユーザーの依頼を完了した後(ツール呼び出しやサブエージェントの各フェーズの後ではありません)に、次に実行する内容を提案してください。
-
次を実行します。
python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill heyeddi-pr-review --project-root .特定のルートを対象に作業した場合は、
--route /pathを追加します。 -
スクリプトの
### Next stepブロックを最終返信に含めます。ユーザーは Prompt 行をチャットにコピーして使用します(例:@heyeddi-design craft /settings)。
直前に完了したサブコマンドが分かる場合は、--mode shape(または craft、audit など)を指定します。
@heyeddi → reference/next-skill-handoff.md を参照してください。