decompose-fat-pr-to-stacked-prs

Decompose Fat PR to Stacked PRs

既存の巨大な Pull Request（またはその tip ブランチ上の大きな差分）を、ジュニアが追える粒度の PR 群へ再分割し、GitHub 上に公開する。依存がある塊は Stacked PR、独立できる塊は独立 PR にする。

いつ使うか

• ユーザーが本 SKILL を明示的にコールしたとき
• 既存の Pull Request（番号・URL・「この巨大 PR」）の分割・再スタックが指示されたとき
• 「fat PR を Stacked に」「巨大 PR を分解して出し直して」など、既存差分の再分割が論点のとき

いつ使わないか

• まだ PR が無く、作業中差分を初めて小さく切るだけのとき → 方針は split-pull-request-rule、実行は /split-to-prs
• 単純な 1 本 PR の作成・本文更新だけ → /github.create-pull-request
• Stacked PR の日常運用（rebase / sync / merge）だけ → gh-stack SKILL
• 元の巨大 PR を閉じる・本文を直すだけの依頼（本 SKILL は元 PR を変更しない）

役割分担

役割	担当
分割粒度・依存・ブランチ名のルール	split-pull-request-rule（必読）
実行時の安全規則（スナップショット、指名ステージ、承認）	/split-to-prs
Stacked ブランチ / PR の CLI	gh stack（github/gh-stack。運用詳細は gh-stack SKILL）
各 PR の本文テンプレ・作成手順	/github.create-pull-request と {assets}/template.md
本 SKILL	既存 fat PR の調査 → 方針レビュー →（承認後）再分割実行 → 報告

開始時に同パッケージの split-pull-request-rule を読み、方針判断の正本とする。

ハードルール

1. 元の巨大 PR は触らない: close / edit / comment / base 変更 / force 更新を行わない。クローズはユーザー自身が行う。
2. 承認制（既定）: ブランチ作成・コミット・push・PR 作成は、分割案の承認後にだけ行う。
3. 自律確定の例外: 次のいずれかが文脈上明らかなときだけ、承認待ちを省略して実行してよい。
   • /loop と組み合わせて本 SKILL が回っている
   • ユーザーが決定権を移譲した（「任せる」「承認不要で進めて」「自律で確定して」等）
4. 破壊的 git は禁止（明示承認なし）: reset --hard、clean -fdx、履歴書き換え、force push、ブランチ削除はしない。
5. ステージは指名のみ: git add . / git add -A は使わない。含めるパスを明示して stage する。
6. 移動前に復旧可能なスナップショットを取る（作業ツリーを変えずに）:

SHA=$(git stash create "pre-decompose-fat-pr")
if [ -n "$SHA" ]; then
  git update-ref "refs/backup/pre-decompose-fat-pr-$(date +%s)" "$SHA"
fi

1. CI のための差分は許容: 各分割 PR が単独で CI Success になるために必要な最小修正（import、fixture、ビルド設定の追随など）は、元 PR に無い変更でも入れてよい。意図しない機能追加はしない。入れた場合は報告で明示する。

前提

• gh（推奨 2.90.0 以上）が認証済み
• Stacked 用: gh extension install github/gh-stack
• 複数 remote がある場合は git config remote.pushDefault origin 等で push 先を確定する
• gh stack は非対話で呼ぶ（エージェントがハングしないため）:
  • init / add / checkout にはブランチ名（または PR 番号）を必ず渡す
  • submit は --auto を付ける
  • view は --json を付ける
  • 詳細はインストール済みの gh-stack SKILL に従う