PR の CodeRabbit インラインコメントを確認し、指摘への対応・リプライを行う。
npx skills add https://github.com/gotomts/dotfiles --skill coderabbit-reviewانسخ والصق هذا الأمر في Claude Code لتثبيت المهارة
Obsidian の vault 配下にサービス設計ドキュメントを段階的に積み上げて構築する（Obsidian MCP が使えない環境では Notion に退避）。新規サービス（個人開発・業務問わず）の設計セッションを最初から最後まで支援するときも、既存サービスの情報を整理して体系化するときも、このスキルを使う。ユーザーが「サービス設計したい」「サービス設計のドキュメントを作りたい」「既存サービスを整理したい」「設計ドキュメントの体系を作りたい」と言ったとき、あるいはサービスのアイデア・コンセプトを話し始めたときは、たとえ「設計」という言葉が使われていなくても、このスキルを使うべきかどうかを必ず検討する。
Spec / plan を入力に、Linear または GitHub の親 Issue + sub-issue 群を自律的に登録する。対話深掘りステップは持たず、`pick-next` / ユーザー直接実行から呼ばれる独立スキル。tracker は `.claude/project.yml` の `tracker.type` から自己解決する。
実装専任のチーム展開スキル。実装対象 (issue 番号/ID または spec/plan パス) を引数で受け取り、developer 並列起動 → reviewer 観点別 → pr-publisher で PR まで自走する。要件定義 (brainstorming/grill-me/grill-with-docs) や issue 作成 (create-issue) は外部スキルの責務でこのスキルではやらない。
「次に何をやるか」を対話で決定する。既存 active issue（Linear / GitHub）の優先度推奨、新規テーマの候補出しと 3 軸スコア比較、判断結果に応じて Issue 作成・既存 Issue 選定・保留の 3 分岐に振り分ける。「次に何やる？」「Linear/GitHub 確認して」「優先度教えて」「次の開発内容を相談したい」と聞かれたら必ず使う。引数なし or 任意のヒント文字列で起動。
PR 作成済みまたはマージ済みの worktree を検出し、一括クリーンアップする
データの欠損・古い値・期待と異なる表示など「データが正しく見えない」系の調査を始めるとき。クライアントコードに潜る前に、まず backend のデプロイ状態と、デプロイ環境側の構成（feature flag / config / 環境差分）を確認させる。ローカルの .env や secrets ファイルは読みに行かない。
| name | coderabbit-review |
| description | PR の CodeRabbit インラインコメントを確認し、指摘への対応・リプライを行う。 |
| argument-hint | <PR番号 or PR URL> |
| allowed-tools | ["Bash"] |
PR に対する CodeRabbit のインラインコメントを確認し、指摘への修正・反論・保留を仕分けてリプライを実行する。
gh CLI が認証済みであること.coderabbit.yaml の事前確認ポーリング開始前にリポジトリ直下の .coderabbit.yaml を確認する。
test -f .coderabbit.yaml && cat .coderabbit.yaml || echo "(no .coderabbit.yaml — defaults)"
確認ポイント:
reviews.path_filters: !**/*.yaml / !**/*.md / !**/*.lock 等が宣言されている場合、それらの拡張子のみで構成される PR は CodeRabbit が自動レビューしない。タイムアウト判定 (section 1) で除外検出に使うreviews.profile: assertive: nitpick も含めて積極的に指摘する設定。nitpick の扱い方針 (section 3-1) をユーザーに確認するファイルが存在しない、または読み出せない場合はデフォルト挙動 (除外なし / プロファイル未指定) として進める。
gh repo view --json owner,name -q '{owner: .owner.login, repo: .name}'
取得する値:
OWNER: リポジトリオーナーREPO: リポジトリ名引数が PR 番号の場合はそのまま使用。PR URL の場合は番号を抽出する。
PR 指定
│
├─ .coderabbit.yaml チェック (path_filters / profile)
│
├─ コメント待機 (actual review ポーリング)
│ │
│ ├─ タイムアウト
│ │ ├─ issues/<N>/comments に "No actionable comments..." → ✅ 完了 (指摘なし)
│ │ ├─ 変更ファイルが path_filters で除外 → 除外通知して終了
│ │ └─ それ以外 → 未設定 / 遅延の可能性をユーザー確認
│ │
│ └─ レビュー検出 → コメント収集 (3 経路: inline root / inline reply / issues comments)
│ │
│ ├─ unresolved 0 件 + issues comments も walkthrough のみ → 完了 (指摘なし)
│ └─ unresolved あり or issues comments に「その他」あり → 対応サイクル
│ │
│ ├─ 仕分け: 修正 / 反論 / 保留
│ ├─ 各コメントにインラインリプライ
│ ├─ 修正コミットを push (修正があった場合)
│ └─ `@coderabbitai review` 一般コメントで再レビュー要求
│ │
│ ├─ 新規コメントなし → 完了
│ └─ 新規コメントあり (2 回目) → ユーザー確認
│
└─ 完了報告
CodeRabbit のレビューフローは 2 段階に分かれる:
issues/<N>/comments へ「processing in progress」コメントが投稿されるpulls/<N>/reviews へ actionable comments を含む正式レビューが投稿されるこのスキルは Step B (actual review) を待つ。gh pr view --json reviews は walkthrough だけで埋まる瞬間があり判定がブレるため、gh api .../pulls/<N>/reviews を直接叩いて coderabbitai[bot] 投稿の有無で判定する。
# Step B (actual review) を 30 秒間隔・最大 5 分でポーリング
OWNER=<owner>; REPO=<repo>; PR=<number>
DEADLINE=$(($(date +%s) + 300))
LATEST_REVIEW_ID=0
while [ "$(date +%s)" -lt "${DEADLINE}" ]; do
LATEST_REVIEW_ID=$(gh api "repos/${OWNER}/${REPO}/pulls/${PR}/reviews" \
--jq '[.[] | select(.user.login=="coderabbitai[bot]")] | (last // {}).id // 0' 2>/dev/null)
[ "${LATEST_REVIEW_ID}" != "0" ] && break
sleep 30
done
⚠️ bot 識別子は coderabbitai[bot] (suffix 付き)。gh api 系では user.login がこの値になる。素の coderabbitai でフィルタすると 0 件になるので注意。
5 分待っても LATEST_REVIEW_ID == 0 の場合、PR の変更ファイルが .coderabbit.yaml の path_filters で除外されている可能性を切り分ける。
gh pr diff "${PR}" --name-only
path_filters の除外パターン (例: **/*.yaml / **/*.yml / **/*.md / **/*.lock) に該当 → 「path_filters により CodeRabbit が自動レビューから除外されている可能性が高い」と報告して完了 (結果: ⏭️ Excluded by path_filters)単に「CodeRabbit 未設定」と片付けず、除外設定との突合を先に行う。
pulls/<N>/reviews 側がタイムアウトしても、issues/<N>/comments に CodeRabbit から No actionable comments were generated が投稿されているケースがある (Step B が review でなく一般コメントで終端する経路)。タイムアウト前に以下も並行チェックする:
gh api "repos/${OWNER}/${REPO}/issues/${PR}/comments" \
--jq 'any(.[]; .user.login == "coderabbitai[bot]" and (.body | test("No actionable comments were generated")))'
true が返れば結果 ✅ No issues として完了報告へ。
CodeRabbit のコメントは 2 つの API endpoint に分散し、さらに pulls/<N>/comments 内には root (in_reply_to_id == null) と reply (in_reply_to_id != null) が混在する。3 経路として漏れなく集約する。
gh api "repos/${OWNER}/${REPO}/pulls/${PR}/comments" --paginate > /tmp/cr_inline.json
このエンドポイントには root と reply が混在する。スレッド単位で 最新発話者 と <!-- <review_comment_addressed> --> マーカーを見て resolved / unresolved を判定する:
jq '
# CodeRabbit が立てた root とその reply だけをスレッド化
group_by(.in_reply_to_id // .id)
| map(select((sort_by(.created_at) | .[0].user.login) == "coderabbitai[bot]"))
| map({
root_id: (.[0].in_reply_to_id // .[0].id),
path: .[0].path,
line: .[0].line,
root_body: .[0].body,
latest_author: (sort_by(.created_at) | last | .user.login),
latest_body: (sort_by(.created_at) | last | .body)
})
| map(. + {
resolved: (
(.latest_author != "coderabbitai[bot]")
or (.latest_body | test("<!-- <review_comment_addressed> -->"))
)
})
| map(select(.resolved | not))
' /tmp/cr_inline.json
判定ロジック:
| 状態 | シグナル | 扱い |
|---|---|---|
| 最新発話者 = user (自分) | latest_author != "coderabbitai[bot]" | ✅ resolved (返信済み) |
| 最新発話者 = CodeRabbit, addressed マーカーあり | body に <!-- <review_comment_addressed> --> | ✅ resolved (対応確認済) |
| 最新発話者 = CodeRabbit, addressed マーカーなし | 上記いずれでもない | ⚠️ unresolved (要対応) |
CodeRabbit は inline reply で「ありがとう」返信 + <!-- <review_comment_addressed> --> を残すため、これを resolved シグナルとして信頼する。
gh api "repos/${OWNER}/${REPO}/issues/${PR}/comments" --paginate \
--jq '[.[] | select(.user.login == "coderabbitai[bot]") | {id, body, created_at}]'
CodeRabbit が /issues/<N>/comments に投稿するコメントは本文パターンで仕分ける:
| 種別 | シグナル | アクション |
|---|---|---|
| walkthrough (no-issues) | No actionable comments were generated を含む | ✅ 終端シグナル。section 1 のポーリング完了判定にも使う |
| auto-reply (Analysis chain) | <details> 内に Analysis chain を含む | ℹ informational。サマリ表示のみ。リプライ不要 |
| その他 | 上記いずれにも該当しない | 内容を確認し section 3 の仕分けに含める |
<details> 除去raw body には Analysis chain などの <details> ブロックがそのまま含まれ、仕分けの S/N 比が悪化する。プレビュー表示時のみ sed で除去する (raw body は反論時の根拠引用用に保持):
echo "${BODY}" | sed -E '/<details>/,/<\/details>/d'
3 経路をマージし、unresolved 件数で次工程を分岐:
1 回自動対応を試み、2 回目の指摘が残った場合にユーザーへ判断を仰ぐ。
各インラインコメントを以下の 3 カテゴリに仕分ける。
| カテゴリ | 判断基準 | アクション |
|---|---|---|
| (a) 修正 | 指摘が妥当でコード変更で解決可能 | コード修正 → リプライで対応内容を返す |
| (b) 反論 | 誤検知・誤指摘の可能性、または意図的な設計判断 | 実機検証で根拠を集め、リプライで反証 |
| (c) 保留 | 別 PR で扱うべき範囲、本 PR スコープ外 | 別 issue/PR を起票し、リプライで理由とリンクを返す |
反論 (b) の進め方:
docker run --rm <image> ls <path> / 該当 API の dry-run / bun test --bail 等保留 (c) の進め方:
Nitpick の扱い:
.coderabbit.yaml の reviews.profile: assertive 下では nitpick も多く含まれる。デフォルトは「対応する」 (assertive を選んだ意図 = 軽微でも拾う、に従う)。ただし時間的制約がある場合はユーザーに方針を確認する:
nitpick 指摘が <N> 件含まれています。対応方針を選択してください:
1. 🔧 nitpick も含めてすべて対応
2. ⏩ Critical / Major のみ対応、nitpick はスキップ (リプライで「nitpick は別途検討」と返す)
各コメントに対し、カテゴリに応じたリプライを返す。
gh api "repos/${OWNER}/${REPO}/pulls/${PR}/comments/<COMMENT_ID>/replies" \
-f body="@coderabbitai <対応内容の説明>
---
🤖 *via Claude Code*"
文面の方針:
末尾に 🤖 *via Claude Code* を付与し、自動対応であることを明示する。
CodeRabbit はインライン返信や push 単独では再レビューが trigger されない場合がある。3 点セット を必ず実行する。
git add <修正ファイル>
git commit -m "fix: CodeRabbit の指摘を修正"
git push
section 3-2 のリプライを送信する。push 後に SHA を含めて再送する必要はないが、コミット SHA をリプライ本文に含めておくと CodeRabbit が修正コミットと対応関係を把握しやすい。
gh pr comment "${PR}" --body "@coderabbitai review
修正概要:
- <ファイル>:<行> — <対応内容>
- ...
---
🤖 *via Claude Code*"
なぜ必要か: 修正コミット push のみだと再レビューが confirm されないケースを実体験している。インライン返信だけでも trigger されない場合がある。@coderabbitai review を一般コメントで明示するのが最も確実。
修正が無く反論・保留のみの場合: 再レビュー要求の必要性が低い。投稿するかをユーザーに確認するか、スキップしてよい。
(1) の push と (3) のコメント投稿後、再度 section 1 のポーリングで actual review を待機する。
## ⚠️ CodeRabbit レビュー指摘 (2 回目)
### 残存するインラインコメント
- <ファイルパス>:<行番号> — <指摘内容>
- ...
### 試行した対応
1. 1 回目: <修正 / 反論 / 保留 の内訳と結果>
2. 2 回目: <内訳と結果>
### 選択肢
1. 🔧 修正を続行
2. ⏩ 指摘を残したまま続行
3. 🛑 中断する
CodeRabbit レビュー対応完了:
- PR: <PR URL>
- 結果: ✅ No issues / 🔧 Fixed (<N>件修正) / 💬 Disputed (<N>件反論) / 📅 Deferred (<N>件保留) / ⚠️ Issues remaining / ⏭️ Excluded by path_filters / ⏭️ Not configured
- inline unresolved: <N> 件 (うち修正 <a> / 反論 <b> / 保留 <c>)
- issues comments: walkthrough <X> 件 / informational <Y> 件 / その他 <Z> 件
- リプライ済みコメント: <N> 件
- 再レビュー要求: ✅ 投稿済み / —