ship-pr
PR を新規作成し、続けて AI レビューを N 周回すところまでを一続きで実行する。プロジェクト側に深いレビューのスキルがあれば PR 作成前に回したうえで、/create-pr と /loop-ai-reviews を順に呼ぶラッパーで、点検・コミット・PR 本文の組み立て・レビュー対応は各スキルが担う。ユーザーが「PR を出してレビューまで回して」「/ship-pr」等を指示したときに使う。
SKILL.mdhome/.claude/skills/ship-pr/SKILL.md
GitHub/create-pr → /loop-ai-reviews を順に呼ぶラッパーです。判定基準も手順も持たず、順序だけを管理します。
| やること | 担当 |
|---|---|
| 差分を多角的に見る深いレビュー | プロジェクト側のスキル(あるリポジトリだけ) |
| 点検・コミット・PR 作成 | create-pr |
| AI レビューの起動 → 完了待ち → 指摘対応を N 周 | loop-ai-reviews |
| 周回後の仕上げ(点検・PR 説明の更新) | loop-ai-reviews が内部で finalize-prs を1回呼ぶ |
finalize-prs をこのスキルから呼びません。 loop-ai-reviews が担っており、重ねると点検3種が二重に走ります。指摘ゼロで終わった周は差分が動いていないので、そもそも仕上げが要りません( create-pr の時点で点検済み)。
進め方
1. 周回数の決定
--rounds N で指定し、省略時は2 とする。上限5は loop-ai-reviews 側で丸められる。
裸の数値を周回数として解釈しない。 残りの引数は create-pr へそのまま渡す情報として扱う。
--screenshot と --video はそのまま create-pr へ渡す。 判定は update-pr-description が持つので、ここでは通過だけ。
AI レビューは1周ごとに課金される。 開始前に「PR を作成し、AI レビューを N 周回す」と1行伝える。Step 2の深いレビューを回すなら、それも含めて先に伝える(サブエージェントを並列起動するぶん重い)。
2. 深いレビュー(プロジェクト側にあれば)
差分をレイヤー別・観点別に分けて見るプロジェクトスキルが利用可能なら、create-pr より先に呼ぶ。無いリポジトリでは黙って飛ばす。
- 判定は利用可能なスキルの一覧で行う。グローバル側には無いものなので、名前を決め打ちしない
- 指摘の採否は
create-prと同じ基準([must]相当は原則対応、[imo]/[nits]は直した結果が良くなるかで判断)。非対応にしたものは理由をユーザーへ報告する - ここでコミットしない。 直した分は次の
create-prが点検・コミットまで面倒を見る - PR を作る前に置く理由は、指摘を取り込んでから出すとレビュアーが見る差分が最初から整うため。周回の後に回すと、追加コミットが積み上がる
3. PR の作成
create-pr を Skill ツールで呼ぶ。ユーザーから渡された情報(ブランチ・base・Backlog 等)はそのまま引数に載せる。
既に PR があるなら中断する。 create-pr は新規作成の責務で、既存 PR の更新は update-pr-description が担う。この場合は loop-ai-reviews だけを呼べばよい旨を伝えて終了する。
4. AI レビューの周回
create-pr の完了を待ってから、loop-ai-reviews を Skill ツールで呼び、Step 1で決めた周回数を渡す。PR が無い状態ではレビューを起動できないので、順序を入れ替えない。
5. 完了報告
各スキルの報告をそのまま二重に貼らない。要点だけ拾って1つにまとめる。
- 深いレビューを回したなら、その指摘件数と採否(回していないなら触れない)
- 作成した PR の URL(draft 状態・assignees・reviewers を1行で)
- 周ごとの結果(run ID / 指摘件数 / 対応したコミット)
- 打ち止めた理由
出力の目安
- 3〜6行。PR の URL と、周回の結果を1行ずつ
- 途中で止まったときは、どのステップで何が起きたかを明記する
やってはいけないこと
finalize-prsを呼ぶこと。loop-ai-reviewsが担う- 各スキルの手順・判定基準をこの本文で再定義すること。順序だけを管理する
- 深いレビューのスキル名をこの本文に書くこと。プロジェクト側にしか無いものを名指しすると、それが無いリポジトリで存在しないものを案内することになる(
ask_before_editing_claude_assets.md) - 深いレビューが無いリポジトリで、無いことを報告すること。黙って飛ばす
- 深いレビューの指摘をコミットまでしてしまうこと。
create-prの点検を経てからまとめて1回にする create-prの完了を待たずにloop-ai-reviewsを呼ぶこと- 周回数の省略時に1周で済ませること。既定は2(1周目の指摘に対応した差分を、もう1周見てもらうため)
- PR を ready 化すること(
no_auto_ready_pr.md)
例外
- ユーザーが「レビューは要らない」と明示した場合は
create-prだけで終える - ユーザーが「深いレビューは要らない」と明示した場合は Step 2を飛ばす
- 既に PR があり、ユーザーがレビュー周回だけを求めている場合は Step 2・3を飛ばす