关于 deliver-acceptance-criteria
deliver-acceptance-criteria 是将已定义的用户故事或功能切片转化为可测试验收场景的技能,适用于需要工程与 QA 明确判断完成条件的团队。它要求以 Given/When/Then 编写可观察结果,并涵盖主要流程、异常和非功能要求。
主要功能
- 01确认故事或功能范围
- 02区分成功流程与异常情形
- 03使用 Given/When/Then 描述场景
- 04覆盖恢复、失败和非功能要求
- 05检查标准是否可独立测试
适用场景
- 01为冲刺规划编写 QA 验收条件
- 02为功能交接明确通过与失败判据
- 03补充故事中的边界情况和错误行为
- 04将功能需求整理为可验证场景
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ product-on-purpose/ pm-skills --skill deliver-acceptance-criteria安装后在 Claude Code 中输入/deliver-acceptance-criteria确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
HISTORY.mdevals/trigger-fixtures.jsonevals/output-scenarios/bulk-invite.mdreferences/EXAMPLE.mdTEMPLATE.md详细介绍
验收标准
验收标准定义了一个故事或功能要被视为完成时必须具备的可观察行为。此技能会将功能背景转化为简洁、可测试的 Given/When/Then 场景,供工程师和 QA 验证,而无需猜测意图。
适用场景
- 定义用户故事、PRD 章节或功能切片之后
- 团队需要明确的通过/失败条件来指导实现时
- 为冲刺规划或交接编写可供 QA 使用的标准时
- 故事包含需要明确说明的边缘情况、错误路径或非功能性预期时
不适用场景
- 你需要用户故事本身 → 使用
deliver-user-stories;此技能用于深化已有的故事 - 你需要系统地覆盖整个功能中的失败情况 → 使用
deliver-edge-cases;此技能的范围仅限于单个故事 - 还没有可供验收标准对应的故事或切片 → 先使用
deliver-prd或deliver-user-stories - 你在为实验定义成功指标,而不是定义故事的完成条件 → 使用
measure-experiment-design - 验收标准是模型输出的比率,例如“90% 的回答忠实于其来源” → 使用
deliver-prd中的 AI 行为与评估章节;该章节说明需要通过设计好的样本来验证比率,并说明在样本准备好之前应记录什么
说明
收到创建验收标准的请求时,请遵循以下步骤:
-
确认故事或功能范围 明确具体的工作切片。如果范围不清楚,请在起草标准前询问用户故事、PRD 章节或功能描述。
-
区分正常流程与例外情况 从主要成功流程开始,然后补充可能发生或遗漏代价较高的边缘情况和错误状态。
-
将每条标准写成可观察的场景 仅使用 Given/When/Then 语言。确保每条标准都可以独立测试,并避免涉及实现细节。
-
覆盖恢复和失败行为 描述验证失败、依赖项不可用或保存操作无法完成时,用户能看到什么或可以采取什么操作。
-
纳入非功能性预期 当性能、无障碍性、安全性、可靠性或可审计性与故事相关时,添加相应标准。
-
避免重复和重叠 每条标准都应测试一种结果。如果两条标准描述了相同的行为,请合并或拆分,直到意图清晰为止。
-
检查可测试性 确保审核者无需解释即可判定每条标准通过或失败。如果某项描述带有主观性,请将其改写为可衡量的结果。
输出约定
使用 references/TEMPLATE.md 作为输出格式。完整的回复应:
- 重述功能或故事背景
- 将标准分为正常流程、边缘情况、错误状态和非功能性标准
- 为每条标准使用明确的 Given/When/Then 陈述
- 当背景信息不完整时,注明假设或待解决问题
质量检查清单
最终定稿前,请确认:
- 标准对应到具体的故事或功能切片
- 首先覆盖正常流程
- 明确列出边缘情况,而非含蓄暗示
- 错误状态包含用户可见的恢复行为
- 在相关时纳入非功能性标准
- 每条标准都可测试,且只有一个明确结果
- 验收标准中未泄露实现细节
示例
请参阅 references/EXAMPLE.md,了解一个基于真实电商结账流程的完整示例。