gentle-ai-chained-pr について
変更が定められた規模を超える場合やレビュー単位の分割を求められた場合に、コーディングエージェントが連鎖 PR を計画するためのスキルです。戦略の選択、PR の境界、依存関係、検証手順を定めます。
主な機能
- 01400 行の PR 閾値と判断基準
- 02スタック型と機能ブランチチェーン
- 03PR の背景情報と依存関係図
- 04個別検証と差分の確認
活用シーン
- 01大きな変更をレビュー可能な PR に分割
- 02機能ブランチチェーンの依存関係を計画
- 03PR の境界と検証計画を確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/gentle-ai-chained-prを入力して読み込まれたか確認します。
同梱ファイルreferences/chaining-details.md
詳細
有効化条件
予定されている PR が 変更行数 400 行を超える可能性がある場合、SDD が 400-line budget risk: High または Chained PRs recommended: Yes と予測する場合、あるいはユーザーが連鎖型／スタック型 PR、レビュー単位の分割、レビュー担当者の負荷調整を求めた場合に、このスキルを読み込みます。
厳守事項
- メンテナーが
size:exceptionを明示的に承認しない限り、変更行数 400 行を超える PR は分割します。 - 各 PR のレビュー時間は約 60 分以内に収めます。
- 1 つの PR につき、成果物となる作業単位を 1 つにします。テストやドキュメントは、それらが検証する作業単位に含めます。
- 連鎖型 PR の各 PR には、開始地点、終了地点、先行する依存関係、後続作業、対象外項目を記載します。
- すべての子 PR に、現在の PR を
📍で示した依存関係図を含めます。 - Feature Branch Chain では、ドラフト／マージ禁止の追跡用 PR を作成します。子 PR #1 のターゲットは追跡用ブランチとし、それ以降の子 PR のターゲットは直前の親ブランチとします。
- 差分の混入はベースブランチの不具合として扱います。現在の作業単位のみが表示されるまで、ターゲット変更またはリベースを行います。
- ユーザーが戦略を選んだ後は、チェーン戦略を混在させません。
判断基準
| 条件 | 対応 |
|---|---|
| PR が変更行数 400 行以下で、対象が明確 | 単一の PR のままにします。 |
| PR が変更行数 400 行を超え、各分割単位を個別にマージできる | main へのスタック型 PR を使用します。 |
| PR が変更行数 400 行を超え、main へのマージ前に機能を統合する必要がある | 追跡用 PR を用いた Feature Branch Chain を使用します。 |
| 生成ファイル／ベンダーファイル／マイグレーションの差分を適切に分割できない | メンテナーに size:exception を求めます。 |
SDD に delivery_strategy がある | 適用や PR 作成の前に、それに従います。 |
実行手順
- 変更行数を見積もり、独立した作業単位を特定します。
- 予算を超過しており、戦略がまだ記録されていない場合は、チェーン戦略を確認します。
- 選択された戦略のみを使用して、ブランチ／PR を作成します。
- リポジトリの PR テンプレートを置き換えずに、各 PR に Chain Context を追加します。
- 各 PR を個別に検証します。CI／テスト／ドキュメント／手動確認、ロールバック範囲、差分のクリーンさを確認します。
- すべての子 PR のレビューと統合が完了するまで、追跡用 PR をドラフト／マージ禁止の状態に保ちます。
出力要件
選択した戦略、PR の順序、現在の PR の範囲、依存関係図、レビュー予算（additions + deletions）、検証計画、size:exception を適用する場合はその理由を提示します。
参考資料
- references/chaining-details.md — 戦略図、PR 本文のセクション、ブランチコマンド、レビュー担当者向けガイダンス。
コメント
Markdown 対応