SuperAPI AI 工具集

health-skill-audit

通用与其它

查看项目

更新于 10-15 23:49

技能介绍

用途:对技能(skill)之间的质量做可分类处理的审计,报告重叠聚类、单个技能正文内部的拆分压力,以及保守的合并候选。分析器只负责报告,所有建议均需人工编辑判断。该技能假定前面的 frontmatter 卫生检查已通过。

主要能力:运行 scripts/audit-skill-structure.py 后,在 tmp/skill-audit/ 写入 report.json(机器可读的真源)、summary.md、overlap-clusters.md、split-candidates.md、consolidation-candidates.md。报告覆盖三种问题:跨技能描述重叠、超大技能正文的拆分候选(如提取到 REFERENCE.md、scripts/、examples/),以及小体积同前缀同插件的合并候选。

使用方式:先确认前置检查通过,即 scripts/plugin-compliance-check.sh 与 python3 scripts/audit-skill-descriptions.py --strict;再执行 python3 scripts/audit-skill-structure.py $ARGUMENTS;支持参数 --plugin <name> 限定单个插件、--strict 在 warn 级发现时也返回非零。随后先看 summary.md,再逐条决定合并、重命名、重写描述或保持不变;每个处置各自提交一个 PR,合并决定按条建 GitHub issue。也可用 jq 过滤 report.json 查看拆分或聚类排名。

适用场景:发现调用方难以分辨的重叠技能、定位名称前后缀聚类、识别可合并的小型兄弟技能。

限制:仅作报告,不自动执行改动;重叠启发式依赖干净的 frontmatter 基线;frontmatter/体积/正文损坏、缺少触发短语、CLI 标志紧凑性、插件与栈相关性等由其他工具负责。收费、价格、平台与具体效果资料未提供。