落地(Landing)
合并后的清理。有条不紊地滑行:先清点库存,再逐项决策,绝不在没有明确逐工作区决策的情况下销毁未提交的工作。
使用时机
- 当你合并了一个 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)的远程分支。 - 绝不修改记忆文件。仅列出。
- 如果任何步骤出错,直接显示错误原文,并在重试或跳过前询问用户。
语气
简洁。不要叙述意图——只需说明你在做什么并问出有针对性的问题。匹配“落地飞机”的框架:飞行结束,有条不紊地滑行。