关于 prd-quality-gate
用于 Agent 执行前审查需求和实施计划的只读门禁。它区分草稿检查与执行就绪评估,并返回结论、证据和具体阻碍。
主要功能
- 01检查需求草稿
- 02评估执行就绪状态
- 03核验验收标准
- 04检查仓库证据
- 05报告阻碍及修复负责人
适用场景
- 01规划前审查需求
- 02Agent 交接前检查计划
- 03发现未解决的实施决策
- 04确认检查与证据是否有效
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ shipshitdev/ skills --skill prd-quality-gate安装后在 Claude Code 中输入/prd-quality-gate确认已加载。
附带文件references/execution-readiness.md
详细介绍
PRD 质量门禁
约定
输入:
- 需求、实施计划、目标代码库和请求的模式。
- 请求执行时,提供实时问题正文/评论和代码库修订版本。
输出:
draft-lint:针对不完整需求的警告;绝不授予执行权限。execution-readiness:READY或BLOCKED、每项检查的证据以及确切缺项。
创建/修改:
- 不修改实现或跟踪器;将检查结果返回给调用引擎。
外部副作用:
- 只读检查代码库和跟踪器。
需要确认:
- 只读验证无需确认。遵守调用方的访问限制。
一份共用约定
在验证或提供准备模板之前,请先阅读 执行就绪状态。此参考文档规定需求模板、计划模板、拆解规则、决策边界和就绪检查清单。使用方从同级路径
../prd-quality-gate/references/execution-readiness.md读取此参考文档。不要维护其他副本。
对于明确要求的仅需求审查,使用 draft-lint。检查必需标题、非空范围和 EARS 验收标准;将缺失信息报告为警告。Draft lint 可帮助规划者继续研究,但不能将问题标记为可交由执行者处理,即使所有标题都已齐备。
对于 feature-intake、执行交接、AFK 分类,或任何要求声明工作已准备好交由 Agent 处理的请求,使用会阻止执行的 execution-readiness。在上述场景中,若未指定模式,则使用 execution-readiness。其他情况下默认使用 draft-lint,并在输出中注明此限制。
验证含义和证据
检查实际行为、完整决策、代码库证据、验证可行性和时效性。仅有标题和 EARS 语法不足以证明已就绪。阅读源文件和命令定义;区分已观察到的事实与拟议的变更。需要执行者作出决策但尚未明确的信息,均判定为不通过。
接受带编号或复选框的验收条目;检查 EARS 前,移除其标记和可选的 AC-N: 前缀。接受 WHEN、WHILE、WHERE、IF ... THEN 或 THE SYSTEM SHALL 形式,前提是包含可观察到的响应。为每条标准分配稳定 ID,以便映射到计划和验证。拒绝主观的通过条件,以及仅重复标题的标准。
返回验证模式、判定结果、问题/计划标识、检查过的修订版本、通过的检查项,以及附有整改负责人的阻塞项。缺失或不可用的检查项判定为 BLOCKED,绝不可推断为通过。被阻塞的草稿可在授权范围内保存,但在规划者完成修正之前,不得进入可运行流程。