mcpField
E
end-pr-review

end-pr-review

github.com/koruworksテスト・品質0131 回インストール2 週間前に更新
リポジトリ

end-pr-review について

Pull Request レビューを記録とともに締めくくるスキルです。指摘事項、セッション中のコミット、受け入れ確認の結果、残作業を対応づけ、根拠のあるレビュー判断を提案します。

主な機能

  1. 01コミットを指摘事項と結果に対応づけ
  2. 02ドキュメントの変更を確認
  3. 03指摘事項と判断を要約
  4. 04受け入れ確認と残作業を報告
  5. 05レビュー判断を提案

活用シーン

  1. 01修正後のレビューを締めくくる
  2. 02セッション中のコミットを PR 作者に説明
  3. 03失敗または未実施の確認項目を記録

インストール

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

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

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

詳細

プルリクエストレビューを終える

この変更の作成者はセッションに参加していません。PR を開くと、自分が書いていないコメント、新しいコミット、受け入れ記録を見つけることになります。 このスキルでは、作成者が目にする内容から、何を確認し、何を決定し、作成者の作業に何を加えたのか、そしてその理由まで、すべてが分かるようにします。目的は次の PR で同じレビューが不要になることなので、責めるのではなく、教えるような口調で伝えます。

記録を集める

  1. PR 自体:セッション中に投稿したレビューコメントとその判断、説明、レビューの基準となった仕様(start-pr-review を参照)。
  2. 作成者の最後のコミット以降のコミット: git log --oneline <author's last commit>..<branch> と、そのメッセージ。いずれもこのセッション中に作成されたものです。
  3. docs/<feature>/ACCEPTANCE.md のチェック項目に対応する受け入れ結果と、start-acceptance を実行した場合は候補ファイル docs/acceptances/ATTENTION.<feature>.md。

すべての変更が記録されていることを確認する

コミット一覧と記録を照らし合わせます。各コミットについて、作成者が、そのコミットがどの指摘または受け入れ結果に対応するのか、そしてなぜほかの変更ではなくその変更を行ったのかを確認できる必要があります。記録に対応するものがないコミットは抜けです。変更の説明がないままにするのではなく、要約を書く前に不足しているコメントを追加します。次に逆の方向も確認します。ユーザーが修正を求めた指摘に対応するコミットがなければ、その指摘は未解決のままです。要約にその旨を記載します。

変更によってプロジェクトのドキュメントに記載されている動作が変わった場合は、ドキュメントも変更されていることを確認するか、フォローアップ作業として記録します。

要約

作成者に向けた、PR へのコメントを 1 件投稿します。

  • 何を、何に照らしてレビューしたか — 仕様、原則、受け入れチェックリスト。
  • 指摘事項:各項目を 1 行で、その結果とともに記載します。修正済み(対応するコミットも記載)、フォローアップ作業として受け入れ済み(記録先も記載)、または却下(理由も記載)のいずれかです。指摘の出どころが原則または ATTENTION.md の項目である場合は、その旨を明記します。そこに、次の PR に引き継ぐべき内容があります。
  • 作成者の作業に何を加え、その理由は何か — 各コミットについて、平易な言葉で説明します。差分は作成者が確認できるため、差分よりも理由が重要です。
  • 受け入れで分かったこと:成功、失敗、未実行のチェックと、テストでは確認できなかった実際の人の目による確認結果。
  • 未対応のことと担当者:あれば記載します。

可能であれば投稿し、そうでなければユーザーが投稿できるように渡し、その旨を伝えます。これは記録の要約であり、記録そのものに代わるものではありません。行ごとのコメントとコミットはそのまま残します。

受け入れを完了する

end-acceptance を実行します。このレビューで挙がった候補についてユーザーと話し合い、ユーザー自身の言葉で結論を記録したうえで、機能の候補ファイルを廃止します。体系的な教訓を見つけたのに昇格させなかったレビューでは、次の PR でも同じ教訓に直面することになります。

判定

承認、変更を要求、または未解決項目を添えて作成者に差し戻す、のいずれかを、理由を 2 文で述べて推奨します。最終判断はユーザーが行います。マージはこのスキルではなく、merge-branch のゲートです。作成者が確認できるようセッションのコミットをプッシュするかどうかはユーザーの判断に委ね、確認は 1 回だけ行います。

コメント