mcpField
H
heyeddi-pr-review

heyeddi-pr-review

github.com/heyeddi-comテスト・品質077 回インストール今日更新
リポジトリ

heyeddi-pr-review について

heyeddi-pr-review は、QA リード、作者、製品・エンジニアリングのレビュアー向けのレビュー用スキルです。コミット済みの PR 差分だけを対象にし、チェックリストに沿って情報収集から判定まで進めます。

主な機能

  1. 01コミット済みの PR 差分のみをレビュー
  2. 02ドキュメントのずれとテスト不足を確認
  3. 03製品コンテキストと受け入れ条件を読み込む
  4. 04変更パスに応じた専門レビューを実施
  5. 05承認・修正依頼・ブロックの判定を定義

活用シーン

  1. 01チームメンバーの PR をレビュー
  2. 02レビュー依頼前のセルフチェック
  3. 03製品要件とドキュメントの整合性確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/heyeddi-com/heyeddi-skills --skill heyeddi-pr-review

インストール後、Claude Code で/heyeddi-pr-reviewを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

manifest.json
reference.md
context/
ANTI_PATTERNS.md
EXAMPLES.md
PROSE_ANTI_SLOP.md
VOCABULARY.md
fixtures/
sample-pr-diff.json
reference/
review-checklist.md
subagents.md
scripts/
_auto_sync.py
_heyeddi_paths.py
_pr_context.py
_skill_cli.py
_untrusted_doc.py
audit_pr_changes.py
check_doc_drift.py
fetch_pr_context.py
README.md
verify_pr_review.py
write_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-excellenceaudit_pr_changes が問題を検出した場合の詳細な監査
@pre-merge-gate最終的な必須ゲート
@heyeddi-pr-respondレビュー後に人間からのフィードバックに対応

タスク完了時:次のスキルを提案する

このスキルについてユーザーの依頼を完了した後(ツール呼び出しやサブエージェントの各フェーズの後ではありません)に、次に実行する内容を提案してください。

  1. 次を実行します。

    python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill heyeddi-pr-review --project-root .
    

    特定のルートを対象に作業した場合は、--route /path を追加します。

  2. スクリプトの ### Next step ブロックを最終返信に含めます。ユーザーは Prompt 行をチャットにコピーして使用します(例:@heyeddi-design craft /settings)。

直前に完了したサブコマンドが分かる場合は、--mode shape(または craft、audit など)を指定します。

@heyeddi → reference/next-skill-handoff.md を参照してください。

コメント