| name | cleanup-github-worktree |
| description | 清理长时间未使用的 git worktree（GitHub 版）。仅在用户明确要求清理 worktree 时使用，不自动触发。 关键词：清理 worktree、删除 worktree、移除旧分支、worktree 回收。 |
| disable-model-invocation | true |
清理过期 Worktree（GitHub 版）
手动触发：当用户明确要求清理、删除或回收长时间未使用的 worktree 时执行。
前置约束
必须在 master 上执行：执行前 git branch --show-current；若不是 master，中止并提示用户切换。
工作流
Step 1: 选择清理时间范围
使用 AskQuestion 让用户选择阈值：
- 提示：
选择清理阈值：超过多久未使用的 worktree 将被清理？
- 选项：
1 周（对应 7 天）2 周（对应 14 天）1 个月（对应 30 天）
将用户选择映射为天数：
Step 2: 预览过期 Worktree
运行清理脚本，输出候选分支名列表（每行一个分支名），不执行删除。
根据操作系统选择脚本（通过用户信息中的 OS Version 判断）：
Windows（PowerShell）：
powershell -File .cursor/skills/cleanup-github-worktree/scripts/cleanup-worktree.ps1 -Days <天数>
macOS / Linux（Bash）：
bash .cursor/skills/cleanup-github-worktree/scripts/cleanup-worktree.sh -d <天数>
将脚本输出的分支名列表展示给用户。如果没有找到过期 worktree，告知用户并结束。
Step 3: 用户确认
使用 AskQuestion 让用户确认是否继续：
- 提示：
以上 <N> 个 worktree 将被清理（关闭 GitHub Issue、移除 worktree、删除本地分支），是否继续？
- 选项：
用户选择取消时，结束工作流。
Step 4: 批量执行 close-github-worktree-done
对 Step 2 识别出的每一个候选分支，以该分支名作为目标分支，执行 close-github-worktree-done skill 的 Step 1 ～ Step 5 完整流程（跳过其 Step 0 的交互选择）。
- 批量场景下，Step 3 关闭 Issue 默认可直接对
open 状态执行关闭（state=closed, state_reason=completed），无需逐个再次 AskQuestion；已 closed 的跳过。
- 有未提交变更的分支：按
close-github-worktree-done Step 2 规则跳过，在最终报告中标记为"跳过（有未提交变更）"。
- 单个分支处理失败不中断整批，继续处理下一个。
Step 5: 汇总报告
向用户展示清理结果摘要，包含每个分支的处理状态：
| 分支名 | GitHub Issue | worktree | 本地分支 | 备注 |
|---|
| bug-12994 | ✅ closed | ✅ 已移除 | ✅ 已删除 | |
| feat-11524 | ⏭ 跳过 | ✅ 已移除 | ✅ 已删除 | 分支名无 issue 号 |
| pref-12948 | — | — | — | 跳过（有未提交变更） |
脚本说明
| 脚本 | 系统 | 路径 |
|---|
| cleanup-worktree.ps1 | Windows | .cursor/skills/cleanup-github-worktree/scripts/cleanup-worktree.ps1 |
| cleanup-worktree.sh | macOS/Linux | .cursor/skills/cleanup-github-worktree/scripts/cleanup-worktree.sh |
脚本职责：
- 通过
git worktree list --porcelain 获取所有 worktree
- 跳过主 worktree（第一个）和 bare 条目
- 通过
git log -1 --format=%ct <branch> 获取分支最后一次 commit 时间；detached HEAD 时回退到目录修改时间
- 筛选超出阈值的条目，仅输出候选分支名列表（每行一个），供本 skill Step 2 解析使用
