Claude Code Skillで親ブランチの誤り修正作業を1時間/件→5分/件にしてみた

main
└ dev/enhancements-2026-04-clean   ← 正しい親
  ├ task-branch-A
  ├ task-branch-B
  └ task-branch-C

develop
└ feature/enhancements-2026-04   ← 誤った親
  ├ task-branch-A
  ├ task-branch-B
  └ task-branch-C

skill-name/
├── SKILL.md          # 必須。YAML frontmatter + 手順を記述
├── README.md         # 任意。使用ガイド
└── references/       # 任意。詳細リファレンス
    └── edge-cases.md

禁止事項（絶対）:
- git merge / git rebase / git reset --hard
- force push
- 元ブランチの変更
- コンフリクトの自動解消

① 事前チェック（uncommitted changes、branch 存在確認など）
② 正しい親 branch を git pull --ff-only で最新化
③ <old-branch>-clean を新規作成
④ 移植対象コミットを抽出・一覧表示
⑤ 「続行しますか？」の確認
⑥ git cherry-pick を1件ずつ順番に実施
⑦ push
⑧ PR 再作成用テンプレートを出力

.claude/skills/branch-rescue/
├── SKILL.md
├── README.md
└── references/
    └── edge-cases.md

description: This skill should be used when the user asks to
  "rescue a branch", "migrate a task branch to the correct parent",
  "fix wrong parent branch", "cherry-pick commits to clean branch",
  "branch 救済", "親ブランチ誤り修正", or needs to transplant
  task branch commits from a wrong parent to the correct parent branch.

新しい Claude Code Skill を作成してください。

目的：
GitHub の誤った親ブランチから派生してしまった task branch を、
正しい親ブランチへ安全に移植する作業を半自動化したい。

背景：

現在以下のような Git 構造になっている。

誤った構造：

develop
└ feature/enhancements-2026-04
├ task-branch-A
├ task-branch-B
└ task-branch-C

main
└ dev/enhancements-2026-04-clean

本来は task branch は
dev/enhancements-2026-04-clean
から派生すべきだった。

しかし既に大量の task branch と PR が存在する。

task branch の PR base を
feature/enhancements-2026-04
から
dev/enhancements-2026-04-clean
へ変更した結果、

feature/enhancements-2026-04 に存在し、
dev/enhancements-2026-04-clean に存在しない
不要な差分コミットが大量に PR に表示されている。

目的：

各 task branch の
「task 独自コミットのみ」
を安全に救済したい。

前提：

* task branch には対象タスクのコミットのみ存在する
* 他タスクコミット混在はない
* squash merge は使用していない
* 元 branch は既存 PR のため保持する
* clean branch を新規作成して救済する

---

## 1. 安全第一

以下は禁止：

* merge
* rebase
* force push
* reset
* reset --hard
* interactive rebase
* 元 branch の更新
* destructive operation
* git format-patch
* git am
* file copy による移植
* 手動差分適用
* reset を利用した履歴改変

必ず：

* 元 branch を変更しない
* 新 branch を作成して対応する
* commit message を保持
* commit 順序を保持
* squash 禁止
* conflict 時は停止
* commit 履歴を壊さない
* merge commit を作らない

重要：

本 Skill の branch 救済ロジックは
必ず git cherry-pick を使用して実装すること。

commit 移植方式は
git cherry-pick を唯一の正式実装方法とする。

禁止：

* git merge
* git rebase
* git format-patch
* git am
* file copy による移植
* patch 適用
* 手動差分適用
* reset による履歴改変

理由：

今回の要件は
「task branch 独自コミットのみ」
を保持しつつ、

* commit message 保持
* commit 順序保持
* 元 branch 非破壊
* PR 履歴維持

を満たす必要があるため。

---

## 2. 入力

入力値：

* old task branch 名

例：

task-branch-A

* correct parent branch 名

例：

dev/enhancements-2026-04-clean

* dry-run option（任意）

例：

--dry-run

* batch mode（任意）

例：

task-branch-A
task-branch-B
task-branch-C

---

## 3. 実施フロー

### ① 作業前チェック

以下を確認：

* Git repository 配下であること
* uncommitted changes がないこと
* branch が存在すること
* remote branch が存在すること
* detached HEAD ではないこと

問題がある場合は停止。

使用コマンド：

```bash
git rev-parse --is-inside-work-tree
git status --porcelain
git branch -a
git symbolic-ref --quiet HEAD
git ls-remote --heads origin <old-branch>
git ls-remote --heads origin <correct-parent>
```

エラー時：

理由を説明して停止。

---

### ② 正しい親ブランチ最新化

merge commit を絶対に作らないこと。

使用：

```bash
git fetch origin
git checkout <correct-parent>
git pull --ff-only origin <correct-parent>
```

必須：

* `--ff-only` を使用
* merge commit 作成禁止

---

### ③ clean branch 作成

命名：

```text
<old-branch>-clean
```

例：

```text
task-branch-A-clean
```

作成前に存在チェック：

```bash
git branch --list <new-clean-branch>
git branch -r --list origin/<new-clean-branch>
```

存在時：

停止。

例：

```text
ERROR:
Branch already exists:
task-branch-A-clean
```

作成：

```bash
git checkout -b <new-clean-branch>
```

---

### ④ old branch 独自コミット抽出

前提：

task branch には
対象 task のコミットのみ存在する。

merge commit を除外。

古い順（時系列順）で取得。

使用：

```bash
git log \
--reverse \
--no-merges \
--pretty=format:"%H|%s" \
<correct-parent>..<old-branch>
```

0件なら停止。

例：

```text
ERROR:
No commits found to migrate.
```

---

### ⑤ cherry-pick 候補表示

実行前に必ず一覧表示。

例：

```text
以下のコミットを移植します：

1.
abc1234
fix: validation 修正

2.
def5678
feat: modal 追加

3.
ghi9012
fix: API response 修正
```

---

### ⑥ 実行前確認

必ず確認：

```text
続行しますか？ (yes/no)
```

yes の場合のみ続行。

no の場合：

停止。

---

### ⑦ cherry-pick 実施

必ず
git cherry-pick を使用。

古い順で
1件ずつ順番に実施。

使用：

```bash
git cherry-pick <commit>
```

必須：

* commit message 保持
* squash 禁止
* 順序変更禁止
* merge commit 禁止

成功例：

```text
✓ cherry-picked abc1234
✓ cherry-picked def5678
✓ cherry-picked ghi9012
```

---

### ⑧ conflict 時

自動継続禁止。

停止して以下を表示：

* conflict 発生 commit
* 原因説明
* 解決コマンド

表示例：

```text
CONFLICT DETECTED

commit:
abc1234

以下を実施してください：
```

```bash
git status
git add .
git cherry-pick --continue
```

または：

```bash
git cherry-pick --abort
```

禁止：

* 自動 continue
* 自動 abort
* 自動解決

---

### ⑨ push

成功時のみ実施。

使用：

```bash
git push origin <new-clean-branch>
```

成功例：

```text
✓ pushed:
origin/task-branch-A-clean
```

---

### ⑩ PR 作成用テンプレート生成

テンプレ：

```text
親ブランチ誤りにより PR を再作成しました。

旧PR:
<URL>

変更内容自体は同一で、
正しい親ブランチ

dev/enhancements-2026-04-clean

へ付け替えたものです。
```

---

## 4. Dry Run モード

Dry Run：

実行予定コマンドのみ表示。

repository state を変更しない。

禁止：

* branch 作成
* cherry-pick
* push
* checkout
* repository state 変更

例：

```text
Will execute:

git fetch origin
git checkout dev/enhancements-2026-04-clean
git pull --ff-only origin dev/enhancements-2026-04-clean
git checkout -b task-branch-A-clean
git cherry-pick abc123
git cherry-pick def456
git push origin task-branch-A-clean
```

---

## 5. Batch Mode

複数 branch 対応。

例：

task-branch-A
task-branch-B
task-branch-C

要件：

* branch ごとに独立実行
* 途中失敗しても次 branch 続行
* conflict branch はスキップ
* 成功 branch のみ push
* 最後に結果レポート表示

---

## 6. 最終結果レポート

最後に出力：

```text
SUCCESS
- task-branch-A-clean
- task-branch-B-clean

CONFLICT
- task-branch-C

PUSHED
- task-branch-A-clean
- task-branch-B-clean

MANUAL ACTION REQUIRED
- task-branch-C
```

---

## 7. Skill 作成フェーズ制約

重要：

以下は
「Skill 作成フェーズ」にのみ適用する。

Skill 実装中は、
実リポジトリを変更する Git 操作を実行しないこと。

禁止（Skill 作成フェーズのみ）：

```text
git checkout
git pull
git cherry-pick
git push
git branch 作成
git commit
git merge
git rebase
git reset
その他 repository state を変更する操作
```

許可（read-only）：

```text
git status
git branch
git branch -a
git log
git show
git diff
git rev-parse
git remote
git fetch --dry-run
```

重要：

git cherry-pick の禁止は
「Skill 作成フェーズのみ」。

Skill 実行時には、
抽出した commit を
git cherry-pick により
古い順で順番に移植すること。

Skill 作成フェーズ：

Git変更禁止

Skill 実行フェーズ：

Git操作許可

許可：

* checkout
* pull --ff-only
* cherry-pick
* push

---

## 8. 必須出力

Skill 作成後、
以下を必ず出力してください。

1. Skill のディレクトリ構成
2. 実装コード全文
3. 実行例
4. Dry Run 実行例
5. Batch 実行例

重要：

Skill の実装のみ行い、
実際の branch 救済処理は
ユーザーが Skill を実行した時のみ動作させること。

/branch-rescue <移植元ブランチ> <正しい親ブランチ>

/branch-rescue task-branch-A dev/enhancements-2026-04-clean

/branch-rescue task-branch-A dev/enhancements-2026-04-clean --dry-run

/branch-rescue --batch dev/enhancements-2026-04-clean
task-branch-A
task-branch-B
task-branch-C

===== Branch Rescue Report =====

SUCCESS
  ✓ task-branch-A-clean  (3 commits)
  ✓ task-branch-B-clean  (2 commits)

CONFLICT (手動対応が必要)
  ✗ task-branch-C

PUSHED
  ✓ origin/task-branch-A-clean
  ✓ origin/task-branch-B-clean
================================

<project>/.claude/skills/branch-rescue/SKILL.md

① 現在のブランチ（feature/branch-rescue-skill）
        ↓ Skill が git checkout を実行
② dev/enhancements-2026-04-clean へ切り替わる
        ↓
③ SKILL.md が存在しない branch になる
        ↓
④ Skill ファイルが消える（git 管理下のため）

feature/branch-rescue-skill  ─→  dev/enhancements-2026-04-clean
   branch 切り替えが発生しても...

~/.claude/skills/branch-rescue/SKILL.md
   ← git 管理外なので常に存在する ✓

git status  # クリーンな状態であること

/branch-rescue fix/enhancements-2026-04-DX2022-4942-S0502 dev/enhancements-2026-04-clean

fix/enhancements-2026-04-DX2022-4942-S0502 を dev/enhancements-2026-04-clean へ救済して

以下のコミットを移植します：

1. abc1234 | fix: S0502 validation 修正
2. def5678 | feat: S0502 modal 追加

合計: 2 commits
old branch:      fix/enhancements-2026-04-DX2022-4942-S0502
correct parent:  dev/enhancements-2026-04-clean
new branch:      fix/enhancements-2026-04-DX2022-4942-S0502-clean

続行しますか？ (yes/no):

親ブランチ誤りにより PR を再作成しました。

旧PR: https://github.com/.../pull/XXXX

変更内容自体は同一で、正しい親ブランチ
  dev/enhancements-2026-04-clean
へ付け替えたものです。