fix-coderabbit-review について
fix-coderabbit-reviewは、CodeRabbitのPRレビュー指摘に対応するスキルです。各指摘を検証してから修正し、1つのコミットにまとめ、レビュー スレッドを解決します。
主な機能
- 01未解決のPR指摘をエクスポート
- 02指摘ごとの技術的な妥当性確認
- 03妥当な問題の修正とテスト更新
- 04修正内容を1つのコミットに集約
- 05コミット後のレビュー スレッド解決
活用シーン
- 01PR内のCodeRabbit指摘への一括対応
- 02レビュー項目ごとの妥当性判断の記録
- 03修正完了の確認と該当スレッドの解決
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ pedronauck/ skills --skill fix-coderabbit-reviewインストール後、Claude Code で/fix-coderabbit-reviewを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlscripts/pr_review.pyresolve_pr_issues.py詳細
CodeRabbit のレビューを修正
PR レビューの修正を厳密な順序で実行します。課題をエクスポートし、すべての課題を修正してから、1 回だけコミットし、スレッドを解決します。
基本原則:コードを変更する前に、各レビュー項目を技術的に評価してください。提案を盲目的に適用しないでください。
必須入力
- PR 番号(整数)。
- 環境内の
GITHUB_TOKEN。 - 対象リポジトリで認証済みの
gh。
ワークフロー
- PR のレビュー課題をエクスポートします。
- 未解決の課題をすべてトリアージして検証します。
- 検証済みの課題をすべて完全に修正します。
- すべての修正を 1 つのコミットにまとめます。
- レビュースレッドを解決し、エクスポートした課題を解決済みにします。
コマンドはリポジトリのルートから実行してください。
ステップ 1:CodeRabbit の課題をエクスポートする
同梱のエクスポータースクリプトを使用します。
PR_NUMBER=<pr-number>
uv run .claude/skills/fix-coderabbit-review/scripts/pr_review.py "$PR_NUMBER" --hide-resolved
次の場所に生成されたファイルを読みます。
ai-docs/reviews-pr-<PR_NUMBER>/_summary.mdai-docs/reviews-pr-<PR_NUMBER>/issues/*.md
_summary.md に未解決の課題がある場合は、コードですべて対処するまで続行してください。
ステップ 2:課題をトリアージして検証する
実装する前に、未解決の課題ファイルをそれぞれ確認します。
各課題について:
- 必要な具体的な技術変更を言い換えて明確にします。
- 現在のコードベースの動作とテストに照らして検証します。
- 次のいずれかを決定します。
VALID:提案は正しく、実装すべきです。INVALID:提案は誤っているか、このコードベースでは実行できません。
ルール:
- 課題が曖昧な場合は
INVALIDとして扱い、根拠と前提を課題ファイルに記録して、実行を続けます。 - 課題が
INVALIDの場合は、技術的な根拠を課題ファイルに直接記録し、無理に不適切な変更を加えないでください。 - 同意を示す表現よりも、技術的な証拠を優先してください。
ステップ 3:課題を完全に修正する
ai-docs/reviews-pr-<PR_NUMBER>/issues/ 以下にある未解決の課題ファイルをすべて処理します。
- ソースコードに本番品質の修正を実装します。
- 各修正を検証できるように、テストを追加または更新します。
- 課題を 1 つずつ修正し、次に進む前にそれぞれを検証します。
- 部分的な修正を残さないでください。
- 課題が無効な場合を除き、課題を飛ばさないでください。無効な課題については、その根拠を課題ファイルに記録してください。
すべての課題の修正後、コミット前に完全な検証を実行します。
pnpm run lint
pnpm run typecheck
pnpm run test
ステップ 4:すべての修正をまとめてコミットする
関連するコード、テスト、課題追跡の変更をすべて含む修正コミットを、必ず 1 つだけ作成します。
git add -A
git commit -m "fix(repo): resolve PR #<PR_NUMBER> review issues"
修正を複数のコミットに分けないでください。
ステップ 5:レビュースレッドを解決する
1 つのコミットを作成した後、エクスポートした課題のスレッドを解決します。
課題ファイルから課題の範囲を確認し(例:001 から 018)、次を実行します。
uv run .claude/skills/fix-coderabbit-review/scripts/resolve_pr_issues.py \
--pr-dir ai-docs/reviews-pr-<PR_NUMBER> \
--from <first-issue-number> \
--to <last-issue-number>
ai-docs/reviews-pr-<PR_NUMBER>/_summary.md を開き直し、未解決数が 0 であることを確認します。
特定の ID でスレッドの解決に失敗した場合は、その課題を未解決のままにし、完了したと偽らず、正確な失敗内容を報告してください。
出力要件
次の内容を提出します。
- すべての修正を含む 1 つのコミット。
- トリアージ時に記録した、課題ごとの技術的な判定(
VALIDまたはINVALID)。 - 更新済みの
ai-docs/reviews-pr-<PR_NUMBER>/issues/*.mdのステータス。 - 更新済みの
ai-docs/reviews-pr-<PR_NUMBER>/_summary.mdの件数とチェックリスト。 - 対応済みの課題のレビュースレッドを解決した状態。