SuperAPI AI 工具集

skill-quality-review

编程与开发

查看项目

更新于 10-16 01:31

技能介绍

用途:评估 SKILL.md 是否符合 Anthropic 的 agent-skill 最佳实践,属内容质量评审,关注 token 效率、可发现性与校准,而非结构校验(结构由 scripts/build/validate_skills.py 的 R1–R7 在 CI 中完成)。

适用场景:审查 mulesoft/mulesoft-dx 中新增或修改 skills/<name>/SKILL.md 的 PR;审计被怀疑臃肿、含糊或难以触发的既有技能;发布新技能前检查。不适用于纯结构检查(用 make validate-skills)、API 规范审查(用 api-spec-validator)或通用文字编辑。

使用方式:先加载参考资料 references/anthropic-best-practices.md、docs/job-template.md、docs/jobs-readme.md、skills/skills-metadata.yaml;确定目标技能路径(可由调用方给出,或用 git diff --name-only <base>... -- 'skills/**/SKILL.md' 解析);读 skills-metadata.yaml 判定类型(jtbd 默认或 prose);通读 SKILL.md 及引用的 references/、scripts/ 文件;按八个维度逐项给出 PASS/WARN/FAIL 并附理由与原文引用。除调用方明确要求外不写文件,报告以 markdown 块返回。

评审维度:简洁性、描述质量、命名、自由度校准、渐进式披露、可发现性触发词、交叉引用、语气一致性。JTBD 类型另查步骤标题祈使语气、inputs/outputs 依赖、重编号后引用一致、阶段门是否真实;prose 类型另查是否实为 JTBD、bundle 根是否有决策路由、Mermaid 围栏与节点引用;bundle 级另查根 SKILL.md 是否真正增值、CHANGELOG 是否与改动一致。

限制:不得虚构参考资料之外的规则;不纠结文字风格;短小清晰的技能应直接 Approve;每条发现须引用真实原文与最佳实践章节名。报告结构为 Blocking findings、Should fix、Optional polish 与 Verdict,多技能逐一输出。参考文档版本为 2026-06-10 抓取,可用 defuddle parse <url> --md 重新获取。