
元記事: receiving-code-reviewでPRのレビュー指摘に根拠を持って対応(cccskills)
スキルのページ: receiving-code-review
この記事の結論
PRで受けたレビュー指摘を、そのまま直すべきか迷うことがあります。
receiving-code-reviewを入れると、指摘をコードと対応環境に照らして確かめてから返答し、修正できます。
この記事では、スキルが進める確認の手順とインストール方法、依頼文の例、入れる前に知っておきたい注意点をまとめました。
エージェントは指摘をすぐには実装しません。
まずコードと照らし合わせ、根拠つきの返答案を出します。
たとえば外部レビューで古い実装の削除を求められたときの依頼文は、次のとおりです。
PRのレビューで「レガシーなコードは削除して」と指摘されました。
消してよいか、コードと対応環境を照らして確かめてください。
エージェントは指摘を読み、要件を自分の言葉で言い直します。
そのうえで、ビルド対象のバージョンや、使っているAPIの要件を調べる流れです。
SKILL.mdの例で示される結論は「ビルド対象は10.15以上で、このAPIは13以上が必要。
後方互換のため古い実装が要る」というもの。
続けて、13未満のサポートをやめるかどうかを利用者に問い返しています。
返答には「おっしゃる通りです」のような同調も、お礼の言葉も入りません。
正しい指摘なら「修正しました」と変更点を短く伝え、誤りのある指摘にはコードやテストを根拠に反論します。
**指摘をうのみにせず、確かめてから直す。
これがこのスキルの中心です。
**
このスキルは、レビュー指摘への対応を決まった6段階で進めます。
判断の基準は、相手の機嫌ではなく技術的に正しいかどうかです。
指摘の中に分からない項目が1つでもあれば、エージェントは実装を止めます。
項目どうしが関係していると、一部だけ理解して進めても誤った実装になるからです。
そのため「1、2、3、6は理解した。
4と5は確認が必要」のように、分かる項目と分からない項目を分けて伝えます。
利用者本人からの指示か、外部レビュアーからの指摘かで、扱いが変わります。
違いは次のとおりです。
| 指摘の出どころ | 扱い |
|---|---|
| 利用者本人 | 信頼して扱う。理解したら実装し、範囲が曖昧なら質問する |
| 外部レビュアー | 実装前に確かめる。このコードベースで正しいか、既存機能を壊さないか、今の実装の理由、すべての環境・バージョンで動くか、レビュアーが全体の文脈を知っているかを確認する |
外部の提案が、利用者が以前に決めた設計とぶつかることもあるでしょう。
その場合は、先に利用者と相談します。
「きちんと実装すべき」という提案を受けたら、まずコードベースを検索して実際の利用箇所を探します。
どこからも呼ばれていなければ、「このエンドポイントは呼ばれていない。
削除してよいか」と問い返す流れです。
必要のない機能は作らないという考え方(YAGNI)に沿った確認といえます。
指摘が多いときは、不明点を解消してから次の順で直します。
修正するたびに個別にテストし、最後に既存機能が壊れていないか(回帰がないか)を確かめる手順です。
まとめて直してから一度にテストするやり方は、よくある失敗として避けられています。
反論したあとで自分の誤りに気づいても、長い謝罪や弁明はしません。
「確認したら指摘どおりだった。
理由は〜。
修正する」と事実を述べ、作業に戻ります。
ターミナルで次のコマンドを実行してください。
npx skills addでは、Claude CodeやCodexなど、入れる先のエージェントを選べます。
npx skills add https://github.com/obra/superpowers --skill receiving-code-review
エージェントに入れてもらう場合は、次の文面をそのまま送ってください。
次の Agent Skill をインストールしてください。
https://github.com/obra/superpowers/tree/main/skills/receiving-code-review
まず SKILL.md と付属ファイルの中身を確認し、不審な処理(外部への送信、認証情報の読み取りなど)がないことを確かめてから、Claude Code なら ~/.claude/skills/receiving-code-review/、Codex なら ~/.agents/skills/receiving-code-review/ に配置してください。
置き場所は、使う範囲によって次の2通りです。
| エージェント | すべてのプロジェクトで使う | 特定のプロジェクトだけで使う |
|---|---|---|
| Claude Code | ~/.claude/skills/ | プロジェクトの.claude/skills/ |
| Codex | ~/.agents/skills/ | プロジェクトの.agents/skills/ |
スキルの中身はSKILL.mdの1ファイルだけで、スクリプトは含まれていません。
エージェントの進め方を決める手順書なので、手元の環境で動きます。
外部と通信するのは、GitHubへ返信を投稿するときにghコマンドを使う場面だけです。
依頼文は日本語で構いません。
以下は目的別の3つの例です。
このPRのレビューコメントをコードと照らし合わせて、妥当な指摘と不明な指摘に分けてください。
指摘ごとに、要件の言い直しとコードとの照合結果が返ってきます。
不明な項目については、何を確かめたいかを質問の形でまとめて提示。
この段階では、どの修正にも手を付けません。
レビュアーから「メトリクス集計をデータベースと日付フィルター、CSV出力つきでちゃんと作って」と言われました。
本当に必要か調べてください。
エージェントはコードベースを検索し、該当するエンドポイントの呼び出し元を探します。
呼び出しがなければ、「どこからも呼ばれていない。
削除してよいか、見落としている利用箇所はあるか」と確認を返します。
合意できた指摘を1件ずつ修正して、それぞれテストしてください。
最後に既存機能への影響も確認してください。
修正は、動作やセキュリティに関わる指摘から順に進みます。
1件直すごとにテストを行い、終わったら変更内容を短く報告。
最後に回帰がないかを確かめて、作業が終わります。
何を直すかの最終判断は、レビュアーと利用者の合意で決めてください。
このスキルは反論の根拠をそろえますが、設計に関わる判断は利用者に相談する手順になっています。
手元で確かめられない指摘については、「〜がないと検証できない。
調べるか、聞くか、進めるか」と方針を尋ねてきます。
GitHubの行ごとのコメントには、そのコメントのスレッド内で返信します。
PR全体へのコメントとしては投稿しません。
投稿にはgh apiを使うので、ghコマンドが使える環境が前提です。
返答文からは、感謝や同調の言葉が意図的に外されています。
チームの慣習として一言添えたいなら、投稿前に自分で書き足してください。
ライセンスはMITで、原文は英語で書かれています。
**入れる前にSKILL.mdの中身を読み、手順が自分の運用に合うかを確かめてください。
**
同じobra/superpowersのスキルを組み合わせると、レビューの前後の作業もつなげられます。
requesting-code-reviewは、実装後やマージ前に別のエージェントへレビューを依頼するスキルです。
返ってきた指摘をreceiving-code-reviewで確かめてから直す、という流れが作れます。
systematic-debuggingは、バグやテスト失敗の原因を、再現手順やログ、直近の変更から調べるスキル。
修正後のテストで失敗が出たときの調査に向いています。
finishing-a-development-branchは、実装の完了後に全テストを確認し、マージやPull Requestの作成を選んで進めます。
レビュー対応を終えたあとの仕上げ向けです。
いいえ、反論が前提ではありません。
正しい指摘はそのまま直し、変更点を短く伝えます。
反論するのは、既存機能を壊す、レビュアーの文脈が足りない、使われていない機能を足すといった技術的な理由がある場合だけです。
利用者本人の指示は信頼して扱い、理解したうえで実装します。
ただし、範囲が曖昧なときは質問が返ってきます。
返信先は、行ごとのレビューコメントならそのコメントのスレッド内です。
PR全体へのコメントとしては投稿しません。
receiving-code-reviewは、レビュー指摘を確認、返答、修正とテストの順で進めるためのスキルです。
不明点は先にまとめて聞き、外部の提案はコードと対応環境に照らして確かめます。
修正は1件ずつテストし、最後に既存機能への影響まで確認するのが特徴です。
指摘を直すべきか迷う場面が多い人は、まず1つのPRで試してください。
詳しくはcccskillsのページをご覧ください。
この記事は cccskills の読みもの「receiving-code-reviewでPRのレビュー指摘に根拠を持って対応」の転載です。
スキルの詳細とインストール方法は cccskills の receiving-code-review のページ にあります。