降落
合併後清理。有條不紊的滑行回機棚:先盤點庫存,逐項決定,絕不在未經明確的逐個工作樹決策前銷毀未提交的工作。
使用時機
- 當 PR 已合併,且你想刪除本機和遠端的功能分支時
- 當
.worktrees/累積了多個過時的簽出時 - 在開發階段結束時,清理工作環境
- 當使用者說「降落」、「清理」、「整理工作樹」、「合併後收尾」或類似詞語時
工作流程
按此順序引導使用者進行清理。先執行盤點,然後逐項處理各個項目。要簡潔——說明你在做什麼,並只問需要答案的問題。
1. 盤點
一次批次執行這些指令,並在做任何破壞性動作前,將結果作為單一盤點區塊呈現給使用者。使用絕對路徑,不要假設目前工作目錄:
git worktree list
echo '---每個工作樹狀態---'
for wt in $(git worktree list --porcelain | awk '/^worktree/ {print $2}' | grep -v "^$(git rev-parse --show-toplevel)$"); do
echo "=== $wt ==="
(cd "$wt" 2>/dev/null && git status --porcelain) || echo "(無法進入)"
done
echo '---已合併的本機分支 (排除 main)---'
git branch --merged main 2>/dev/null | grep -vE '^\*|main$|master$'
echo '---已合併的遠端 feat/* 分支---'
gh pr list --state merged --limit 50 --json headRefName,number --search "head:feat/" 2>/dev/null \
| jq -r '.[] | select(.headRefName | startswith("feat/")) | "\(.headRefName) (#\(.number))"' \
| head -20
echo '---要修剪的遠端引用 (試執行)---'
git remote prune origin --dry-run 2>&1 | grep -E 'would prune|^ ' | head -20
echo '---dist/ 大小---'
[ -d dist ] && du -sh dist 2>/dev/null || echo "(無 dist/)"
echo '---今日撰寫的記憶條目---'
MEMDIR=$(find ~/.claude/projects -maxdepth 2 -name "memory" -type d -path "*$(basename "$(pwd)")*" 2>/dev/null | head -1)
if [ -n "$MEMDIR" ]; then
find "$MEMDIR" -name '*.md' -mtime -1 -type f 2>/dev/null | grep -v MEMORY.md | head -10 \
|| echo "(無近期條目)"
else
echo "(未找到專案特定的記憶目錄)"
fi
盤點執行完畢後,呈現一份簡潔摘要:
盤點 (可清理的項目):
- 要考慮的工作樹:N 個 (M 個髒污)
- 已合併的本機分支:N 個
- 已合併的遠端 feat/* 分支:N 個
- 過時的遠端引用:N 個
- dist/:<大小> 或無
- 今日的記憶條目:N 個 (僅供參考)
要繼續嗎?(y/N)
如果使用者說否/中止 → 停止。否則繼續執行步驟 2。
2. 工作樹 (逐個工作樹決策)
針對盤點中每個非 main 的工作樹:
-
乾淨 (該工作樹的狀態為空):宣布「正在移除位於
<路徑>的乾淨工作樹」並執行git worktree remove <路徑>。無需提示。 -
髒污 (該工作樹的狀態有輸出):停止。對使用者顯示:
位於
<路徑>的工作樹有未提交的變更:<貼上 porcelain 輸出>選項:
- (s) 存入一個具名暫存 (例如
pre-cleanup-<分支>),然後移除工作樹 - (c) 在目前分支上提交,然後移除工作樹
- (d) 刪除遺失變更 (
git worktree remove --force) - (k) 保留此工作樹,跳過清理
- (q) 完全中止清理
為
<路徑>選擇?尊重使用者對每個工作樹的選擇:
- s:
(cd <路徑> && git stash push -m "pre-cleanup-$(git branch --show-current)")然後git worktree remove <路徑> - c:要求提交訊息;
(cd <路徑> && git add -A && git commit -m "<訊息>")然後git worktree remove <路徑> - d:
git worktree remove --force <路徑>(需要再次確認—具破壞性) - k:跳過;在最終報告中註記
- q:停止整個流程,跳到步驟 6
- (s) 存入一個具名暫存 (例如
3. 本機 + 遠端分支 (批次確認)
工作樹處理完畢後:
- 列出已合併的本機分支 (排除
main/master)。詢問:「刪除這 N 個本機分支?(y/N)」——單次確認,然後git branch -d <各分支>。如果git branch -d拒絕任何分支 (未合併提交),暫停並在使用者使用-D前詢問。 - 列出已合併的遠端 feat/* 分支。詢問:「刪除這 N 個遠端分支?(y/N)」——單次確認,然後在一個批次中執行
git push origin --delete <分支1> <分支2> ...。 - 遠端刪除後:
git remote prune origin(無須提示——隱含在使用者的確認中)。
如果任一清單為空,則跳過其提示。
4. dist/ 目錄
如果盤點時發現 dist/ 存在,詢問:「移除 dist/ (大小:X)?(y/N)」。如果是,執行 rm -rf dist。
5. 記憶條目 (僅供參考)
如果盤點發現今日撰寫的記憶條目:請列出其路徑。告訴使用者:
這些記憶條目是今天撰寫的。請在
<目錄>檢閱它們,並修剪任何過於狹隘或只適用於特定工作階段的條目。我不會自動觸碰記憶。
請勿刪除或修改任何記憶檔案。繼續進行。
6. 最終報告
執行 git status 和 git worktree list。對使用者顯示:
清理完成。
- 已移除的工作樹:N 個 (保留的:M 個)
- 已刪除的本機分支:N 個
- 已刪除的遠端分支:N 個
- 已修剪的過時引用:N 個
- dist/:已移除 / 已保留 / 不存在
<git status 的輸出>
如果有任何項目被保留 (例如使用者選擇保留的髒污工作樹等),請明確列出,以便使用者知道還剩下什麼。
與其他技能組合
bones-powers:finishing-a-bones-leaf— 在扇入 + git push + PR 合併後,交由land-the-plane清理功能分支和工作樹。superpowers:finishing-a-development-branch— 對於非 bones 的工作流程,同樣的交接模式。
安全規則
- 絕不 在未經使用者為該特定工作樹選擇選項 (s/c/d) 的情況下,刪除含有未提交變更的工作樹。
- 絕不 在未經使用者明確確認該分支的情況下,強制刪除 (
-D) 尚未合併的本機分支。 - 絕不 刪除不符合
feat/*(或不是main/master) 的遠端分支。 - 絕不 修改記憶檔案。僅列出。
- 如果任何步驟發生錯誤,請如實顯示錯誤訊息,並在使用者重新嘗試或跳過前詢問。
語氣
簡潔。不要敘述意圖——只需說明你在做什麼,並提出針對性的問題。配合「降落」的框架:飛行結束,有條不紊地滑行回機棚。