| name | cleanup-worktree |
| description | PR マージ完了後の worktree・ローカルブランチ・Issue を一括整理する後片付けスキル。 「クリーンアップして」「worktree を削除して」「ブランチを削除して」「Issue をクローズして」 「マージ後の後片付けをして」「作業環境を片付けて」と言った場合にトリガーする。 worktree 削除・ローカルブランチ削除・Issue クローズを自動化する。 submit-pull-request でマージ完了後に呼び出される後処理スキルでもある。 |
クリーンアップ
PR マージ後に worktree、ローカルブランチ、Issue を整理する。
前提
.github/settings.json からプロジェクト設定を読み取って使用する。
入力
- 対象ブランチ名（複数可）
- Issue UUID（複数可）—
start-feature で記録した id（UUID）を使用する
手順
0. 設定読み込み
.github/settings.json を読み取り、以下の値を使用する:
issueTracker.provider — Issue トラッカー種別issueTracker.mcpServer — MCP サーバー名
1. Worktree の削除
git worktree remove .worktrees/<ブランチ名>
2. ローカルブランチの削除
git branch -D <フルブランチ名>
3. リモート参照の整理
git fetch --prune
4. main ブランチの更新
git checkout main
git pull origin main
5. Issue のステータス更新
issueTracker.provider が "none" の場合はこのステップをスキップする。
Linear（provider: "linear"）
mcp_<issueTracker.mcpServer>_save_issue:
id: "<UUID>" # start-feature で記録した id（UUID）を使用。identifier ではない
state: "Done"
GitHub Issues（provider: "github"）
PR の body に Closes #<number> を含めていれば、マージ時に自動クローズされる。
自動クローズされなかった場合は手動で対応する:
mcp_io_github_git_issue_write:
owner: "<github.owner>"
repo: "<github.repo>"
issue_number: <number>
state: "closed"
一括クリーンアップ
複数ブランチを同時にクリーンアップする場合:
git worktree remove .worktrees/<ブランチA>
git worktree remove .worktrees/<ブランチB>
git branch -D <フルブランチA> <フルブランチB>
git fetch --prune
git checkout main
git pull origin main
マージ済みブランチの一括削除（ブランチが溢れた場合）
git branch -r --merged main | grep 'origin/' | grep -v 'main' | \
sed 's|origin/||' | xargs git push origin --delete
git branch --merged main | grep -v 'main' | xargs git branch -D
git fetch --prune
エラー時の対処
| エラー | 対処 |
|---|
git worktree remove 失敗（未コミットの変更あり） | --force を付与するか、先に変更を退避 |
git branch -D 失敗（worktree が残っている） | 先に worktree を削除する |
| Issue 更新失敗（UUID 不明） | mcp_<mcpServer>_list_issues で検索して UUID を特定 |
