Skill 质量门禁

适用范围

使用本 Skill 审查一个 Skill 包或一个 Skill 仓库的行为质量，重点关注：

• 触发条件是否足够具体，是否明确不适用场景。
• 工作流程是否有顺序、边界和可执行的判断。
• 输出契约是否能让用户和测试复核结果。
• 安全边界、事实/假设区分和副作用控制是否完整。
• 示例、脚本和回归测试是否真正覆盖 Skill 的关键行为。

默认只读。用户明确要求修改时，先输出问题清单和最小改动面，再实施修改。

不适用场景

• 只检查 skills.json、目录、链接或元数据完整性：使用 skill-repository-maintainer。
• 只需要执行一个已知 Skill，而不是评估 Skill 本身。
• 没有目标 Skill、示例或可观察输出，无法进行行为评估时；应报告证据不足，不得凭感觉打分。

审查流程

1. 确认目标路径、版本、语言、依赖和本次审查范围。
2. 读取 SKILL.md、agents/openai.yaml、示例、引用资料和脚本；不把运行时文件当作 Skill 内容。
3. 评估触发、边界、流程、输出、验证和安全六个维度，分别记录事实、推断和缺失证据。
4. 优先运行包内已有的 smoke test、示例检查或质量脚本；失败时保留原始错误。
5. 按影响和修复成本排序，给出最小修复建议；不为了对称性重写整个包。

输出契约

输出以下内容：

1. PASS、PARTIAL 或 BLOCKED。
2. 目标 Skill 和版本。
3. 通过项、失败项和证据路径。
4. 触发边界、流程、输出、验证、安全六维结论。
5. 按 P0/P1/P2 排序的改进项。
6. 未验证的行为、残余风险和明确不应修改的范围。

不要把“结构校验通过”写成“行为质量通过”，也不要把旧输出或旧哈希当作本次修改的证据。

验证

对仓库内的 Skill 包运行：

python3 skill-quality-gate/scripts/quality_report.py --root . --strict

脚本只使用 Python 标准库，检查 frontmatter、长度、边界/输出/验证章节、UI 元数据和非空示例。复杂 Skill 仍需运行自己的回归测试；结构脚本不能替代真实任务前测。

详细评分维度见 质量评分表。