菜单
清理 git worktree。默认检查分支是否已合并到 main，确认安全后才删除。 支持参数：--force（跳过合并检查，强制清理）、--skip-sync（跳过同步其他 worktree）。 当用户说\"删除worktree\"、\"remove worktree\"、\"清理worktree\"、\"清理分支\"、\"删除分支\"、 \"remove-worktree\"、\"清理工作区\"时使用此 skill。即使用户只是说\"这个分支不要了\"或 \"帮我清理一下\"，也应考虑触发此 skill。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
完成 worktree 的完整合并流程：本地验证 → PR CI → merge → post-merge CI → 发布准备 → Release Notes → 创建 Release → 清理。 使用 git merge --no-ff 保留完整分支历史。 支持项目级钩子（.bare/custom-hooks/）实现个性化发布流程。 触发词："合并worktree"、"merge-worktree"、"合并PR"、"发布"、"release"、"上线"。
Reference for writing workflow JS scripts. Auto-loaded when using workflow-generate or writing/editing workflow scripts for Pi. Covers runtime environment, injected globals, constraints, and script patterns. Not for general coding or subagent usage.
Use when the user says "轻量执行", "lite execute", "按 Wave 执行", "goal 模式执行 plan", "执行 plan", or has a completed plan.md (from lite-plan) or execution-plan.md (from mid-detail-plan) and needs to execute the Waves. ADR-029 后阶段 A+B 由 workflow run execute-full-workflow 机器接管（worktree-setup → dev waves → test+review → cleanup），主 agent 不再直接派 subagent。 对应 CW action: dev (workflow 内 implementer 渐进式提交) + test (workflow 内 test-runner 渐进式提交). Not for planning (lite-plan / mid-detail-plan). Not for retrospect (coding-retrospect).
Use when the user says "issue拆分", "问题分解", "issue decomposition", "方案对比", "tradeoff analysis", "优先级排序", or has finished system-architecture.md and needs to break it into prioritized issues with solution comparisons. Produces issues.md as a fog-of-war decision map. Step 3 of 6. Not for business requirements (Step 1) or architecture modeling (Step 2). Not for non-functional risk analysis (Step 4) or code-level design (Step 5).
Use when the user says "mid 详细计划", "中等功能实施设计", "issues+nfr+架构+计划一起做", "批量设计实施", or has finished mid-plan and needs issues.md + non-functional-design.md + code-architecture.md + execution-plan.md (+ code-skeleton) + detail.json (CW detail action 入参). 纯设计 skill，不写实现代码。对应 CW action: detail. Not for L3 heavy (use full-*). Not for requirements/architecture (that is mid-plan).
[internal] Shared reference files for the lite workflow (lite-plan / coding-execute / coding-retrospect). Not invoked directly — sibling lite-* skills resolve paths via ../lite-shared/references/{file}.md. Kept hidden from model invocation.
| name | remove-worktree |
| description | 清理 git worktree。默认检查分支是否已合并到 main，确认安全后才删除。 支持参数：--force（跳过合并检查，强制清理）、--skip-sync（跳过同步其他 worktree）。 当用户说\"删除worktree\"、\"remove worktree\"、\"清理worktree\"、\"清理分支\"、\"删除分支\"、 \"remove-worktree\"、\"清理工作区\"时使用此 skill。即使用户只是说\"这个分支不要了\"或 \"帮我清理一下\"，也应考虑触发此 skill。 |
安全清理 git worktree，支持合并状态检查和同步其他 worktree。
remove-worktree.sh <branch-name> [--force] [--skip-sync]
| 参数 | 位置/标志 | 必填 | 说明 |
|---|---|---|---|
branch-name | $1 | 是 | 要清理的分支名，如 feat/old-feature。/ 自动转为 - 作为目录名 |
--force | flag | 否 | 跳过合并检查和未提交变更检查，强制删除 |
--skip-sync | flag | 否 | 跳过同步其他 worktree 到 origin/main |
# 安全模式：检查已合并 → 同步其他 worktree → 删除
bash ~/.agents/skills/remove-worktree/remove-worktree.sh feat/old-feature
# 强制删除（未合并的分支）
bash ~/.agents/skills/remove-worktree/remove-worktree.sh feat/experiment --force
# 强制删除且跳过同步
bash ~/.agents/skills/remove-worktree/remove-worktree.sh feat/quick-test --force --skip-sync
# 只删除不同步（比如知道其他 worktree 有冲突不想处理）
bash ~/.agents/skills/remove-worktree/remove-worktree.sh feat/done-feature --skip-sync
git fetch origin --prune 获取最新远程状态
git branch --merged origin/main 检查分支是否已合并
依赖前提：GitHub PR 必须使用 Create a merge commit 合并。如果仓库使用 Squash merge 或 Rebase merge，git branch --merged 会误判为"未合并"（因为原始 commit hash 不会进入 main）。此时需用 --force 强制删除，或通过 gh pr list --state merged --json headRefName 确认 PR 状态。
未合并 → 拒绝删除，显示未合并 commits，提示使用 --force
检查未提交变更（有变更 → 拒绝删除）
同步其他 worktree：git fetch origin main && git merge --no-ff origin/main
冲突时不 abort，保留冲突状态供 AI 处理
删除目标 worktree 和本地分支
安全模式（已合并）：
Workspace: /path/to/project-workspace
=== 检查合并状态 ===
✓ 分支 'feat/old-feature' 已合并到 origin/main
=== 同步其他 worktree 到 origin/main ===
同步 feat-other (feat/other)...
OK: feat-other 已同步到最新 main
=== 清理 worktree feat/old-feature ===
已删除 worktree 'feat-old-feature'
============================================
Remove worktree 完成!
已删除: feat/old-feature
已同步: 1 个 worktree
冲突: 0
============================================
未合并时拒绝：
=== 检查合并状态 ===
✗ 分支 'feat/wip' 尚未合并到 origin/main
未合并的 commits:
a1b2c3d feat: work in progress
e4f5g6h wip: more changes
Error: 分支未合并，拒绝删除。使用 --force 强制清理。
强制模式：
=== 强制模式（跳过合并检查）===
Warning: worktree 有未提交变更（--force 模式下继续删除）:
M src/main.ts
=== 清理 worktree feat/experiment ===
删除 worktree 'feat-experiment'...
删除本地分支 'feat/experiment'...
已删除 worktree 'feat-experiment'
============================================
Remove worktree 完成!
已删除: feat/experiment
已同步: 0 个 worktree
冲突: 0
============================================
| 输出 | 原因 | 解决 |
|---|---|---|
分支未合并，拒绝删除 | 分支未合并到 main | 确认不需要后加 --force |
worktree 有未提交变更 | 有未保存改动 | 提交或暂存后重试，或 --force |
worktree 目录不存在 | 分支名错误或已删除 | 检查 git worktree list |
未找到 workspace | 不在 workspace 目录下 | cd 到 workspace 子目录 |
cd <workspace-root> # 例如 cd /Users/xxx/project-workspace
bash ~/.agents/skills/remove-worktree/remove-worktree.sh <branch-name> [--force] [--skip-sync]
"Remove worktree 完成!"git diff --name-only --diff-filter=Ugit add . && git commitgit merge --abort