SuperAPI AI 工具集

audit-skill-completeness

测试与质量

查看项目

更新于 10-15 22:40

技能介绍

用途:审计单个技能的质量是否与其声明的目的相符,核心问题是“该技能是否具备可靠达成既定目的所需的一切”。适用于发布前审查、新建技能质量检查、改进规划与市场就绪评估。若用户意图不匹配,则改走 /plugin-creator:plugin-lifecycle。

主要能力:先读取技能目录结构,确认 SKILL.md 存在(缺失则报错退出),读取其 frontmatter 与正文,并记录 scripts/、references/、assets/ 目录内容;随后将技能归类为目的类型(行为/约束、工具/格式封装、工作流编排、参考/知识、领域专长),跨类型时取适用类别的并集。

评估方式:先按 ./references/skill-completeness-checklist.md 的 agentskills.io 最佳实践检查五项(方法对输出、精简指令、推理优于命令、描述触发准确性、打包信号),每项给出 PASS/PARTIAL/FAIL 与证据;再评估结构质量类别,通用类别为 Preparation、Progression、Verification、Examples、Anti-Patterns,条件类别为 Scripts、References、Assets,条件类别须先做适用性判断,不适用则记 N/A,不计入分母、不列为缺口、不建议补充。每类按 0–3 评分并附 file:line 证据。

输出:为 FAIL/PARTIAL 项建议 1–2 个评估提示,并给出 3–5 个行为场景、2–3 个应触发查询、2–3 个不应触发查询;总分分母为 15 加 3 乘适用条件类别数。报告写入 .tmp/scratch/reports/skill-sync-{slug}-completeness-YYYYMMDD.md,目录不存在则创建。

限制:不撰写高质量评估断言,仅提供场景起点;不输出 JSON;具体评分细则与检查清单依赖随附参考文件,资料未提供其完整内容。