SuperAPI AI 工具集

verify-team-skill-quality

智能体与模型

查看项目

更新于 10-16 09:30

技能介绍

用途:审查和优化 Agent Skill 的质量,针对新增或修改中的 SKILL.md、技能辅助 .md、技能路由描述、触发样本或任务样本,产出可路由、可加载、可验证、可维护的 Skill 合同;必要时同步 skills-index.json、skills-router.json、skills-lock.json。前置加载 CANON.md,修改本仓库技能时须读取目标技能全文。审查流程分七步:定位 Skill 类型(路由型、设计型、执行型、治理型);审查 description 是否写明真实用户意图、触发词、near-miss 排除边界并避免过度承诺;删除低密度内容,只保留触发边界、本地规则、gotchas、禁止事项、STOP、输出模板与验证清单;检查 STOP 与失败处理(缺输入、范围不匹配、高风险副作用、无法验证四类);检查输出契约与可验证的 Done When;检查 progressive disclosure 分层(高频规则留在 SKILL.md,长模板与评分表放辅助 .md,确定性重复逻辑进 scripts,辅助 .md 须进入 skills-lock.json 的 auxiliaryHashes);审查 trigger eval 与 task eval 样本,至少覆盖 near-miss。验证失败时按场景处理(如先重写 description、补 STOP、补输出契约、下沉长内容、脚本化、增加 should-not-trigger 样本)。红旗包括 description 只解释是什么、无法排除近邻技能、缺何时不使用或 STOP、无输出模板与 Done When、未同步 index/router/lock、辅助 .md 未被主文件引用、机械逻辑未脚本化、无法验证却声称完成。变更后需运行 scripts/generate-index.sh、scripts/generate-router.sh、scripts/update-lock.sh <skill> 和 ./validate。不适用:仅解释业务概念、仅使用现有 Skill 完成任务、一般代码质量审查、项目文档质量。官方文本与收费、平台等细节暂未提供。