失效Skill清理师 (z-skill-rot-sweep)
触发词
失效skill清理 / 废skill / 清理skill库 / 哪些skill没用了 / skill腐烂扫描 / rot sweep / 整理技能
核心流程
- 只读扫描：遍历各客户端技能目录（WorkBuddy
~/.workbuddy/skills/、Claude~/.claude/skills/、Cursor~/.cursor/skills/等），列出全部已装 Skill。 - 采集信号：对每个 Skill 收集三类证据——①依赖完整性（其脚本/MCP/命令/Python 包是否还存在）；②运行痕迹（若有调用日志，看近期是否报错或零调用）；③同类重叠（功能描述是否与其他 Skill 高度重合，可能存在更优替代）。
- 加权评分：按"依赖缺失 > 频繁报错 > 零调用超阈值 > 有更优替代"的权重打分，分为「健康 / 建议归档 / 建议停用」三档。
- 生成清单：输出可读报告，标注每项的问题证据与风险等级，绝不自动执行任何改动。
- 用户确认后执行：仅当明确确认，才做「软归档」（移入该 Skill 目录下的
历史版本/归档/子文件夹，保留可恢复）或「停用」（disable: true）。删除操作一律禁止，如需彻底移除由用户手动处理。
注意事项
- 默认只读模式，扫描阶段不触碰任何文件。
- 零调用 ≠ 失效：低频但关键时刻有用的 Skill（如年度税报）应判为健康，用"最近一次成功调用距今天数 + 用户标注"综合判断。
- 跨平台路径差异：不同客户端技能目录不同，扫描以用户指定的目录或常见默认路径为准，不硬编码绝对路径。
- 软归档保留原文件，可随时还原，优于真删。
红线（禁止行为）
- 禁止未经确认自动删除、移动或停用任何 Skill。
- 禁止把"低频但重要"的 Skill 误判为失效并建议清理。
- 禁止修改 Skill 的业务内容，仅做归档/停用元数据操作。
- 禁止在扫描中执行 Skill 内部脚本（只静态读取 frontmatter 与依赖声明）。
适用边界
- 适用于本地可访问的技能目录；远程/云端托管的 Skill 需先同步到本地。
- 无调用日志的客户端，降级为「依赖完整性 + 同类重叠」判定，结论标注为"推断"。
- 不承诺找出所有"低效"Skill，只针对明确的失效/废弃信号。
红蓝对抗记录（R2 固化）
- 红军主干：扫描 → 采集信号 → 评分 → 出清单 → 确认后归档/停用。
- 蓝军挑刺：①"失效"难界定，零调用可能是低频刚需；②真删有数据丢失风险；③跨平台路径不一；④静态扫描无法验证运行时才暴露的故障。
- 优化落点：只读优先 + 软归档（可恢复）取代真删；判定加权且允许"用户标注白名单"；跨平台用相对检测；结论区分"确定失效/推断失效"。
- 结果：scope 收紧到"明确失效信号"，删除被完全禁止，安全与可逆性达标。
跨平台安装
- WorkBuddy：复制到
~/.workbuddy/skills/z-skill-rot-sweep/ - Claude：复制到
~/.claude/skills/z-skill-rot-sweep/ - Cursor：复制到
~/.cursor/skills/z-skill-rot-sweep/ - 其他客户端：放入对应 skills 目录即可。本技能仅用技能目录相对路径与静态读取，无平台独占依赖。
