| id | pr-description |
| name | PR Description Review |
| description | Review whether the PR description is review-ready and consistent with the diff (Why/What, impact, tests, linked issues). |
| version | 0.2.0 |
| category | midstream |
| phase | midstream |
| applyTo | ["**/*"] |
| tags | ["pr-description","consistency","midstream"] |
| severity | minor |
| inputContext | ["diff","prDescription"] |
| outputKind | ["findings","actions"] |
| modelHint | balanced |
Pattern declaration
Primary pattern: Reviewer
Secondary patterns: Inversion
Why: PR 本文の品質と差分整合をレビューする。PR 本文が無い場合は実行不要。
Goal / 目的
- PR 本文が「レビュー可能な状態」かを確認する（Why/What、影響範囲、テスト方針、関連リンク）。
- 本文の説明と差分の不整合（説明にあるが差分に無い／差分にあるが説明に無い）を検出する。
Non-goals / 扱わないこと
- コード品質・命名・型の指摘（他の midstream skill が担当）。
- 差分に存在しないコードへの推測。
- PR 本文の文体・体裁の好みの指摘。
Pre-execution Gate / 実行前ゲート
このスキルは以下が満たされない限り NO_REVIEW を返す。
ゲート不成立時の出力: NO_REVIEW: pr-description — PR 本文が利用できないため評価対象なし
Guidance
- Why（変更理由）と What（変更内容）が PR 本文に明記されているか確認する。
- 本文の説明が差分と一致しているか確認する（記載と実装の乖離を指摘）。
- 影響範囲・破壊的変更の有無が書かれているか確認する。
- テスト方針 / 動作確認方法が書かれているか確認する。
- 関連 Issue / 仕様 / 設計へのリンクがあるか確認する。
Closes #N / Fixes #N について、リンク先 Issue の完了条件（受入条件・チェックリスト）が入力から読み取れる場合のみ diff と突合する。未達の条件があれば Refs への変更または残課題の明記を提案する。完了条件が入力から読み取れない場合、この突合は reviewee 側（/pr command）の責務として指摘しない。- ja/en 対訳ファイル（
*.md と *.en.md、pages/ 配下の対）の片側のみが diff に含まれ、本文にその理由が無い場合は指摘する。
- 本文の宣言（「〜は変更しない」等の変更対象外の宣言、件数・列挙）が実 diff と矛盾していないか確認する。
- PR 本文に関する指摘は対象を
PR-DESCRIPTION:0 として出力する。
False-positive guards / 抑制条件
- 軽微な変更（タイポ修正等）で本文が簡潔な場合は過剰に要求しない。
- テンプレート未記入のセクションが明らかに不要な場合は黙る。
Output / 出力例
findings:
- severity: minor
file: PR-DESCRIPTION:0
issue: PR 本文に変更理由(Why)が書かれておらず、レビュアーが意図を判断できない
suggestion: 「なぜこの変更が必要か」を1〜2文で本文冒頭に追記する
