用途
triage 用于管理 learned skills 的生命周期。它基于 skills-ecosystem-eval 的消融实验结果,决定哪些技能应当退役、复原或查询状态,并可搭配 skills-ecosystem-eval 的四象限分析使用。
主要能力
- 检查分流脚本工具是否存在及可执行。
- 查看当前状态:显示已退役数量、清单及审计日志。
- 退役单个 skill:接收 skill 名称、原因、tier 与 delta 参数。tier 取值为 T1(degraded)、T2(Q3 delta=0)、T3(其他);delta 为消融实验的 delta 值。
- 退役前影响分析:通过 grep 检索 ~/.claude/skills/learned/、~/.claude/rules/、~/.claude/CLAUDE.md 与专案 CLAUDE.md,确认是否有其他 skill 引用待退役 skill,并整理引用来源、引用位置与影响清单。
- 复原 skill:将已退役 skill 恢复回 ~/.claude/skills/learned/ 并验证。
- 批次处理:读取消融数据(如 full-analysis.json),筛选 delta < 0 的 skills,按 delta 绝对值排序,列出待退役清单并逐个执行影响分析。
- 退役后完整性验证:确认 skill 已不在 ~/.claude/skills/learned/ 中,且名称已出现在 ~/.claude/skills/retired/RETIRED_LOG.md 中。
使用方式
Step 0:检查工具。确认 ~/.claude/scripts/skills-triage.sh 存在且可执行,若不存在则从 agent-skills repo 复制并赋予执行权限。
Step 1:查看状态。运行 ~/.claude/scripts/skills-triage.sh status,显示已退役数量、清单及审计日志。如果 /skill-health command 可用,建议先执行以取得 portfolio 全局视图(重复覆盖率、gap 分析),再决定退役优先顺序。
Step 2:退役 Skill。使用者提供 skill 名称和原因时运行 ~/.claude/scripts/skills-triage.sh retire <name> "<reason>" <tier> <delta>。退役前需读取 skill 内容并摘要给使用者,确认同意;同时先做影响分析,若有引用存在,向使用者展示影响清单后再决定是否继续退役。
Step 3:复原 Skill。运行 ~/.claude/scripts/skills-triage.sh restore <name>,复原后验证 skill 文件回到 ~/.claude/skills/learned/。
Step 4:批次处理。当使用者提供消融数据时,读取数据、筛选 delta < 0 的 skills 并按 delta 绝对值排序,列出待退役清单,并对每个执行 Step 2 的影响分析。有依赖关系的 skill 需先与使用者确认才可退役,不可批次自动退役;无依赖关系的可批次逐一确认后退役。每次退役后在表上标记状态。
Step 5:退役后完整性验证。批次退役完成后,对每个标记完成的 skill 验证两项:已不在 ~/.claude/skills/learned/ 中;skill 名称已出现在 ~/.claude/skills/retired/RETIRED_LOG.md 中。任一项不成立即视为退役未完成,需人工介入,不可标记该 task 为完成。
适用场景
- 需要根据消融实验数据决定哪些 learned skills 应退役时。
- 需要查询已退役 skill 清单与审计日志时。
- 需要复原之前退役的 skill 时。
- 需要对一批消融数据进行批次分流处理时。
- 需要验证退役操作完整性时。
限制
- 依赖 ~/.claude/scripts/skills-triage.sh 脚本存在且可执行,否则需先复制。
- 退役前必须先做影响分析,有引用存在时需使用者决定是否继续。
- 有依赖关系的 skill 不可批次自动退役,必须与使用者确认。
- 批次退役后必须通过完整性验证,否则视为未完成,需人工介入。
- 建议先执行 /skill-health command(若可用)取得全局视图,再决定退役优先顺序。
关键路径
- ~/.claude/skills/learned/:活跃 skills
- ~/.claude/skills/retired/:退役归档
- ~/.claude/skills/retired/RETIRED_LOG.md:审计日志
- ~/.claude/scripts/skills-triage.sh:批次脚本