| name | skein-clean |
| description | 主动清理 (仅用户显式调用)。归档完成 task (保留期外) + 清残留孤儿 worktree / 悬挂 skein/* 分支 — 安全清扫 (只清已完成/已合并的), 存疑先报用户。入参 = 保留天数 |
| disable-model-invocation | true |
| user-invocable | true |
| argument-hint | [保留天数] |
| arguments | [保留天数] |
| model | haiku |
| effort | low |
skein-clean — 主动清理
仅用户显式调用 (disable-model-invocation)。两件事:
- 归档完成 task —
finish 后完成 task 不立即归档, 默认留看板 retain_days 天 (config.yaml, 默认 7); 超期由脚本在下次生命周期变更时自动归档。本 skill 让用户主动提前归档。
- 清残留孤儿 — finish 中断 / 手动改动留下的孤儿 worktree / 悬挂分支。
安全第一: 只清「已完成/已合并」的。未 finish 的 active task、未合并的分支一律不删 (可能有未落地改动)。🛑 存疑一律先报用户裁定, 禁自行删。
入参: 保留天数
调用形如 /skein-clean [保留天数]。
- 省略 → 用 config.yaml 的
retain_days (默认 7): 归档完成超 7 天的 task。
0 → 立即归档全部完成 task (不留看板)。N → 归档完成超 N 天的 task。只能比 config retain_days 更激进 (更小); 更大值无效 (脚本每次 _sync 自动按 config ceiling 归档)。
清扫项 (main 同步跑, 逐项查再动)
-
归档完成 task (保留期外) — 直接跑脚本, 它按保留期算并归档:
skein clean [--days <保留天数>]
完成 task 已走完整 finish (已 merge/销 worktree), 归档纯移目录, 安全。
-
孤儿 worktree — git worktree list 列全部; 对每个 .worktrees/skein-*:
- 对应 task 已完成/已归档 →
git worktree remove <path> --force。
- 对应 task 仍 active → 保留 (在用)。
- 无对应 task 记录 → 报用户裁定 (别猜)。
- 收尾
git worktree prune 清元数据。
-
悬挂 skein/* 分支 — git branch --list 'skein/*':
- 已合并 (
git branch --merged 含之) 且 task 已归档 → git branch -D。
- 未合并 → 保留 + 报用户 (有未落地 commit)。
看板无需手动刷 — clean 已触发 _sync 自动重渲染 task.md/task.html; 孤儿 worktree/分支清理不涉 task.json, 不影响看板。
注意: skein list 里完成 (已完成) 却仍在 .skein/task/ 的 task 不是异常 — 是保留期内正常状态, 别当漏归档强行 archive。要提前清走, 用上面的 clean 命令 (走保留期语义)。
输出
清扫报告: 归档了哪些完成 task (保留 N 天)、删了哪些 worktree/分支、哪些存疑保留 (交用户裁)。存疑项禁自行删。
失败模式 (if-then 三段式: 触发 → 一线修复 → 仍失败兜底)
| 触发 | 一线修复 | 仍失败兜底 |
|---|
worktree remove 失败 (占用/锁) | git worktree prune 后重试 remove | 仍失败 → 保留 + 报用户, 禁 --force 强删活跃 worktree |
branch -D 失败 (未合并) | 查是否真已合并 (git branch --merged) | 未合并 → 保留 + 报用户 (有未落地 commit) |
| worktree/分支无对应 task 记录 | 报用户裁定 (别猜) | 用户未定 → 保留, 禁自行删 |
❌ 反例 (命中=操作错误)
🔒 Iron Law: 只清「已完成/已合并」的 — 未 finish 的 active task、未合并分支一律不删, 存疑先报用户。
主体禁项: 未 finish 的 active task / 未合并分支一律不删 · 存疑不报用户就自行删 · N 大于 config retain_days 当有效 (脚本按 ceiling 自动归档, 无效) · 把保留期内完成 task 当漏归档强行 archive。完整清单详见 references/anti-examples.md。
