本文へ移動
cccskills
receiving-code-review開発

receiving-code-reviewでPRのレビュー指摘に根拠を持って対応

cccskills 編集部読了 約 9 分

この記事の結論

こんな人に
PRで受けたレビュー指摘をそのまま直してよいか迷い、根拠を持って返答や修正をしたい開発者
入れると
  • 「この指摘は正しいか」と頼めば、コードと対応環境を調べた判断と根拠が返ってくる
  • 分からない指摘は修正の前に質問としてまとまるので、誤解したまま直すことがなくなる
  • 修正を1件ずつテストしながら進め、最後に既存機能が壊れていないかまで確かめられる
向かない人
レビュー指摘を受ける機会がない人や、コードの調査・修正をエージェントに任せない人

PRで受けたレビュー指摘を、そのまま直すべきか迷うことがあります。receiving-code-reviewを入れると、指摘をコードと対応環境に照らして確かめてから返答し、修正できます。この記事では、スキルが進める確認の手順とインストール方法、依頼文の例、入れる前に知っておきたい注意点をまとめました。

目次

使うとこうなる

エージェントは指摘をすぐには実装しません。まずコードと照らし合わせ、根拠つきの返答案を出します。たとえば外部レビューで古い実装の削除を求められたときの依頼文は、次のとおりです。

PRのレビューで「レガシーなコードは削除して」と指摘されました。消してよいか、コードと対応環境を照らして確かめてください。

エージェントは指摘を読み、要件を自分の言葉で言い直します。そのうえで、ビルド対象のバージョンや、使っているAPIの要件を調べる流れです。

SKILL.mdの例で示される結論は「ビルド対象は10.15以上で、このAPIは13以上が必要。後方互換のため古い実装が要る」というもの。続けて、13未満のサポートをやめるかどうかを利用者に問い返しています。

返答には「おっしゃる通りです」のような同調も、お礼の言葉も入りません。正しい指摘なら「修正しました」と変更点を短く伝え、誤りのある指摘にはコードやテストを根拠に反論します。指摘をうのみにせず、確かめてから直す。これがこのスキルの中心です。

receiving-code-reviewでできること

このスキルは、レビュー指摘への対応を決まった6段階で進めます。判断の基準は、相手の機嫌ではなく技術的に正しいかどうかです。

  1. 指摘を最後まで読む
  2. 要件を自分の言葉で言い直す(分からなければ質問する)
  3. 実際のコードと照らし合わせる
  4. このコードベースにとって妥当かを評価する
  5. 技術的な了承か、根拠のある反論で返す
  6. 1件ずつ実装し、そのつどテストする

不明点は先にまとめて聞く

指摘の中に分からない項目が1つでもあれば、エージェントは実装を止めます。項目どうしが関係していると、一部だけ理解して進めても誤った実装になるからです。そのため「1、2、3、6は理解した。4と5は確認が必要」のように、分かる項目と分からない項目を分けて伝えます。

指摘の出どころで確認の厚さを変える

利用者本人からの指示か、外部レビュアーからの指摘かで、扱いが変わります。違いは次のとおりです。

指摘の出どころ扱い
利用者本人信頼して扱う。理解したら実装し、範囲が曖昧なら質問する
外部レビュアー実装前に確かめる。このコードベースで正しいか、既存機能を壊さないか、今の実装の理由、すべての環境・バージョンで動くか、レビュアーが全体の文脈を知っているかを確認する

外部の提案が、利用者が以前に決めた設計とぶつかることもあるでしょう。その場合は、先に利用者と相談します。

使われていない機能は足さない

「きちんと実装すべき」という提案を受けたら、まずコードベースを検索して実際の利用箇所を探します。どこからも呼ばれていなければ、「このエンドポイントは呼ばれていない。削除してよいか」と問い返す流れです。必要のない機能は作らないという考え方(YAGNI)に沿った確認といえます。

複数の指摘は順番を決めて1件ずつ直す

指摘が多いときは、不明点を解消してから次の順で直します。

  1. 動作を壊す問題や、セキュリティに関わる問題
  2. 誤字やimportの漏れなどの簡単な修正
  3. リファクタリングやロジック変更などの複雑な修正

修正するたびに個別にテストし、最後に既存機能が壊れていないか(回帰がないか)を確かめる手順です。まとめて直してから一度にテストするやり方は、よくある失敗として避けられています。

反論が間違っていたら事実だけ伝える

反論したあとで自分の誤りに気づいても、長い謝罪や弁明はしません。「確認したら指摘どおりだった。理由は〜。修正する」と事実を述べ、作業に戻ります。

インストール方法

ターミナルで次のコマンドを実行してください。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の作成を選んで進めます。レビュー対応を終えたあとの仕上げ向けです。

まとめ

receiving-code-reviewは、レビュー指摘を確認、返答、修正とテストの順で進めるためのスキルです。不明点は先にまとめて聞き、外部の提案はコードと対応環境に照らして確かめます。修正は1件ずつテストし、最後に既存機能への影響まで確認するのが特徴です。

指摘を直すべきか迷う場面が多い人は、まず1つのPRで試してください。詳しくはcccskillsのページをご覧ください。

よくある質問

レビュアーの指摘に必ず反論するのですか
いいえ、反論が前提ではありません。正しい指摘はそのまま直し、変更点を短く伝えます。反論するのは、既存機能を壊す、レビュアーの文脈が足りない、使われていない機能を足すといった技術的な理由がある場合だけです。
自分の指示も疑われますか
利用者本人の指示は信頼して扱い、理解したうえで実装します。ただし、範囲が曖昧なときは質問が返ってきます。
GitHubの返信はどこに投稿されますか
返信先は、行ごとのレビューコメントならそのコメントのスレッド内です。PR全体へのコメントとしては投稿しません。

このスキルを試す

receiving-code-review の入れ方とインストールコマンドは、cccskills のスキルページにまとめてあります。

この記事は、公開されている SKILL.md と cccskills の紹介文をもとに AI(Claude)が下書きし、cccskills 編集部の方針に沿って推敲・公開しています。正確な仕様はスキルのページで原文を確認してください。

他の記事