SuperAPI AI 工具集

skill-portfolio-review

通用与其它

查看项目

更新于 10-15 22:38

技能介绍

用途:对全部技能作为一个集合进行组合级审计,判断技能是否放在合适的载体、是否存在冗余、上下文预算是否花得合理。与只审计单个技能内部质量的 /skill-quality-gate 不同,它审计的是整个技能群。

主要能力:通过脚本收集每个技能的行数、祈使句、gotchas、引用、脚本、描述词数、交叉引用与过时引用等指标,并给出技能总数、总行数与估算索引 token。随后对每个技能做载体类型判断(技能还是纯知识文档)、分类归属、冗余检查与过时检查,再进行依赖安全检查(CLAUDE.md 触发、跨技能引用、hook 引用、脚本消费者),最后做上下文预算分析并输出建议。

使用方式:先运行 ~/.claude/skills/skill-portfolio-review/scripts/portfolio-scan.sh 收集指标;加载 references/taxonomy.md 做分类;按步骤产出 KEEP、REFRAME、MERGE、DELETE 建议并生成报告,报告后可逐个执行建议。

适用场景:技能数量较多、需要清理或重组技能库时;判断某技能是否应转为文档;评估索引 token 开销。

限制与注意:任何 DELETE 建议前必须先做依赖检查,否则 hook、交叉引用或 CLAUDE.md 触发会静默失效;表格、示例与引用块中的祈使句应打折,避免误判;元技能可标为“meta — justify keeping”而非直接删除;描述重叠但执行不同的技能(如 save-session 与 introspect)需先完整阅读两份 SKILL.md 再决定是否合并。审计单个技能请用 /skill-quality-gate,检查项目代码质量用 /audit,检查系统设置健康用 /harness-audit。具体分类细节与脚本参数暂未提供。