用途:审计 Joel 的 Pi/joelclaw 技能体系,帮助压缩技能提示词预算、发现重复技能、审计启用/禁用的技能根目录,并决定移除哪些技能或插件。该技能改编自 Peter Steinberger 的 agent-scripts skill-cleaner。
主要能力:分析已加载的技能根目录、重复项(同名或描述/正文近似)、未使用候选(近期日志中无 $skill 提及、无 SKILL.md 读取或显式使用痕迹)、技能预算(基于上下文窗口的 2% 提示词预算启发式)、以及可精简的长描述。报告按技能预算、描述候选、重复项、未使用候选、根目录摘要的顺序阅读。
使用方式:在技能目录或 joelclaw 仓库根目录运行分析器,例如: node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 3 可用变体包括 --no-logs、--months 6 --max-log-mb 800 --deep-logs、--context-tokens 272000 --budget-percent 2 --no-logs、--root ~/Code/badass-courses/skills --no-logs、--json --no-logs。
适用场景:清理技能提示词预算、查找重复技能、审计技能根目录、决定移除技能或插件。
限制与注意事项:输出策略为先建议,仅在用户要求时编辑;若执行清理,按描述、删除、配置禁用分组小提交。删除或编辑前需验证保留副本存在且已加载;Joel 自有运维技能优先保留 joelclaw 仓库规范副本,第三方技能优先保留外部包副本;描述中保留触发名词;不得在未指明目标或确认可丢弃的情况下删除被忽略/未跟踪的技能目录。分析器仅扫描默认技能根目录,额外目录需用 --root 指定;使用证据为启发式判断。