Immutable. This exact content is served forever at /api/v1/blob/79d170d53a4740f7.
--- name: skill-quality-gate description: 评估 Codex Skill 的触发边界、内部流程、输出契约、验证方式和回归质量。用于审查或优化现有 Skill、发布前做行为质量检查、比较修改前后的 Skill 质量，默认只读，不替代仓库结构校验或跨设备同步。 --- # 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 包运行： ```bash python3 skill-quality-gate/scripts/quality_report.py --root . --strict ``` 脚本只使用 Python 标准库，检查 frontmatter、长度、边界/输出/验证章节、UI 元数据和非空示例。复杂 Skill 仍需运行自己的回归测试；结构脚本不能替代真实任务前测。 详细评分维度见 [质量评分表](references/quality-rubric.md)。