发布门禁只有说明控制哪项决策、需要什么证据,以及证据缺失或无效时怎么办,才真正有用。质量门禁设计 Skill 把这些规则整理成可复核的契约。

什么时候使用

当团队要定义或评估交付与发布门禁的准入条件、证据要求、负责人、例外路径和回滚条件时,可以使用这个 Skill。它复核提供的策略与证据设计;不会执行流水线、批准例外或判断发布是否安全。

建立门禁契约

先明确每个门禁只控制一项决策:合并、部署、扩大流量还是停止。逐项列出需要满足的义务,以及对应证据的版本和时效要求。指定执行责任人,并区分以下状态:

状态对决策的含义
PASS新鲜、有效的证据满足已声明的义务。
FAIL证据表明义务没有满足。
BLOCKED因某个原因无法执行;记录原因和下一次尝试。
UNKNOWN证据缺失、过期、冲突或无法得出结论。

缺少证据时不能记为 PASS。按项目规定的汇总和失败处理规则执行,避免平均值掩盖必需项中的失败或未知。若策略没有定义处理方式,应把决策交给负责人,不要自行补阈值。

例外与失败路径

每个例外都要记录适用范围、理由、授权人、批准、过期时间、补偿控制和撤销条件。无效或过期的例外不能改写失败结果。每项阻塞或失败义务还应说明由谁调查、是否允许重跑,以及什么条件会停止或回滚发布。

门禁设计、与现有证据比较、流水线实现是不同的工作。设计好的规则或一次试运行都不能证明真实门禁已经执行。

评审时可以把规则整理成状态转换表,特别检查数据变旧、重跑和例外到期时的处理。具体状态由项目契约定义,门禁不能自行假定默认值。

条件变化需要写清的门禁反应复核重点
原本有效的证据过期是否变为 UNKNOWN、BLOCKED 或其他已声明状态,以及当前决策如何处理是否仍显示旧 PASS,是否标明证据时间和影响范围
检查失败后允许重跑谁可发起、最多或何时停止重跑、使用哪个构建和数据版本新运行是否关联原失败,不能覆盖原始记录
例外到期原义务何时恢复,是否需要新的人工批准过期例外不能自动续期或抹去失败
必需检查阻塞是否暂停决策、升级给谁、何时停止或回滚BLOCKED 是否被误算为通过,停止条件是否明确

若来源、构建或时间窗口不匹配,证据即使显示 PASS,也不能自动满足当前门禁。报告中要指出具体关联缺口,并把“是否接受替代证据”交给获授权的负责人。

示例:结算改动的分阶段发布

设想结算功能分阶段发布,需要检查单元、契约、浏览器和生产观察证据。部署前,门禁可以要求有效的单元和契约证据;扩大流量前,可以要求浏览器证据;全面发布前,则可以依赖双方约定的生产观察窗口。这些只是候选阶段,实际义务与阈值必须由项目负责人确定。

如果浏览器基础设施不可用,浏览器执行状态应为 BLOCKED,不能悄悄改成 PASS。负责人可以继续停止发布,或批准范围明确、即将过期并带有补偿控制的例外。记录由谁做了什么决定,以及哪些证据可以关闭例外。

让质量循环持续运转

日常测试要把每项义务和结果连起来:需求或风险 → 复核后的测试设计 → 在明确的构建版本和环境中执行 → 按证据确定门禁状态 → 负责人采取行动 → 修复并关联重跑。AI 生成的测试用例先作为草稿;执行前要对照需求和预期结果复核。生成本身不能满足门禁。重跑时保留原始失败记录;只有证据新鲜、有效并且对应当前义务,结果才能记为 PASS。

交付哪些内容

发现门禁规则缺失或含糊时,用 QGD-## 记录对象或义务、来源、触发条件、预期问题、证据状态、影响与优先级、负责人角色、关闭条件和验证方法。另需写明停止、升级和回滚条件。说明剩余风险,并把人工批准与技术证据分开。

实践建议

  • 先处理可能造成业务损失、质量回退或决策阻塞的义务。
  • 每次重跑都关联原始结果;例外必须写明负责人、范围、到期时间和补偿控制。

结论边界

门禁只能在声明的范围内控制决策。它不能替团队选择业务风险容忍度,也不能把过期证据变成当前证明。没有对应运行记录和授权决策时,不要声称所有检查通过、已经批准发布或流水线已经执行。

相关 Skill

安装与调用

从 Awesome QA Skills 仓库安装这个独立 Skill:

npx skills add https://github.com/naodeng/awesome-qa-skills/tree/main/skills/zh --skill quality-gate-design

调用 quality-gate-design 时,提供目标决策、门禁策略、所需义务、证据来源、负责人、例外和回滚规则。

可以直接使用下面的请求模板:

请使用 quality-gate-design Skill。
门禁控制的决策:[合并、部署、扩大流量或停止]。
策略和义务:[已批准的规则及所需证据]。
证据:[来源、版本、时效和当前状态]。
负责人和例外:[角色、审批路径、到期条件和补偿控制]。
按现有策略处理缺失、过期、阻塞和失败证据。规则未定义时指出缺口并交给负责人;不要自行补阈值或批准发布。

常见问题

缺少证据时可以算 PASS 吗?

不能。按项目契约保留相应状态,例如 UNKNOWN 或 BLOCKED。若契约没有定义,就记录缺口并交给负责人决定。

这个 Skill 能替团队选择发布阈值吗?

不能。它可以指出规则缺失或冲突,但阈值必须由负责人设定,例外是否可接受也由负责人决定。

源文件

使用前请阅读质量门禁设计提示词: https://github.com/naodeng/awesome-qa-skills/tree/main/skills/zh/testing-types/quality-gate-design/prompts/quality-gate-design.md。源目录: https://github.com/naodeng/awesome-qa-skills/tree/main/skills/zh/testing-types/quality-gate-design;包含入口、参考资料和评估契约。

更多参考

分享