Skill 质量审核门禁

解决什么实际问题

在编写 Agent 技能时，最常见的维护痛点是“技能触发不稳定”与“输出不可复现”。当 SKILL.md 的指令模糊、输入边界缺失或缺乏校验机制时，开发者只能通过反复调试提示词来排查故障。本技能作为 Skill 的质量门禁，专门用于全面审核、选题评估或排查不稳定根因，在上线前拦截结构缺陷。

它强制要求创作者明确触发名、输入要求、指令本体、输出格式、示例和校验规则这六项核心要素，避免把技能写成一次性的 Prompt 片段。对于已经存在但不可靠的技能，它能通过静态审查和动态样本对比定位问题，而不是靠猜。

核心能力与工作流

审核过程基于“六要素 · 六步骤”模型。首先执行定位读取，核对 YAML frontmatter 与目录结构是否一致；随后进行选题评估，判断任务是否值得固化为技能。

进入核心审核阶段，系统会逐项检查：

• 六要素审核：引用技能原文逐一核对，缺少任何一项即判定为 P0 级错误并拦截。
• 质量特性评估：从专、界、验、复、享、迭六个维度评估进阶质量。
• 结构化输出：生成包含结论、核对表、问题清单和修复建议的 Markdown 报告。

每条问题都会附带具体的修法（如“改前 → 改后”对照），并按 P0（缺要素）、P1（示例不全）、P2（表述优化）分级。

适用边界与注意点

该技能是纯粹的审核者。默认情况下，它不会修改被审核的技能本体，仅在用户明确要求“直接修复”时才会介入，并在修复后执行一次复检。

对于“不稳定排查”场景，必须提供真实的运行样本（输入 + 实际输出 + 期望输出）。若无样本，审核将降级为静态检查，报告中会明确标注“未做动态排查”，此时无法定位输出波动的真实原因。审核标准完全依赖 references/quality-standards.md，修改该文件即可调整审核口径。