SuperAPI AI 工具集

skill-auditor

智能体与模型

查看项目

更新于 10-16 08:03

技能介绍

Skill Auditor 用于审计现有的技能生态,覆盖全局技能与项目级技能,评估其智能体友好性、一致性与最佳实践,适合在新增多个技能后、定期(如每季度)、分发技能之前,或感觉技能效果不佳时使用。

工作流分四个阶段。阶段一为清单盘点:从 ~/.claude/skills//SKILL.md 以及 ./skills//SKILL.md 或 ./.claude/skills/*/SKILL.md 收集所有技能,并提取 frontmatter 中的名称与描述、SKILL.md 行数、是否存在参考文件/脚本/资源,以及非标准 frontmatter 字段。

阶段二为单项评估,从三方面检查:frontmatter 质量(描述是否同时说明做什么和何时用、触发词组覆盖、描述长度约 50-300 词为宜、是否有多余字段);内容质量(是否低于 500 行、是否用参考文件做渐进披露、指令是否具体可执行、是否规定输出契约、是否有示例);结构质量(参考文件是否放在 references/ 目录、可复用操作是否脚本化、参考文件是否从 SKILL.md 链接、命名是否符合约定)。

阶段三为生态评估,包括覆盖分析(领域聚类、重叠检测、工作流完整性)、一致性分析(风格、触发模式、输出格式)与组织分析(全局与项目划分、命名约定、文档质量)。

阶段四生成报告,格式包含执行摘要与健康分(X/100)、快速统计表、按优先级排列的改进建议、每个技能的评级(A/B/C/D)与优点/问题/快速改进项、领域覆盖表、重叠分析,以及组织、一致性和缺失技能方面的生态建议。评分标准中对单个技能按触发清晰度、内容长度、是否使用参考、是否有输出契约和组织情况划分 A 至 D;生态健康分由平均单项评级(40%)、无重叠的覆盖广度(20%)、一致性(20%)、渐进披露使用(10%)和脚本/自动化存在度(10%)计算。

快速概览审计可运行:find ~/.claude/skills -name "SKILL.md" -exec wc -l {} ; | sort -n 与 find ./skills -name "SKILL.md" -exec wc -l {} ; 2>/dev/null | sort -n。完整审计则需逐一读取每个 SKILL.md 的 frontmatter、检查参考与脚本目录并汇总成上述报告。

常见修复建议包括:补充“Use when...”触发词、将超 500 行的内容移入 references/、为技能添加输出契约、合并或区分重叠技能、从 SKILL.md 链接参考文件、删除名称与描述之外的多余字段。此外还会主动检查是否缺少元技能(skill-creator)、检查点技能(checkpoint)、交接技能(bootstrap)以及评审类技能。资料未提供安装命令与具体收费信息。