┌─────────────────────────────────────────────────────┐
│              ✓ Acceptance Criteria (GWT)           │
├─────────────────────────────────────────────────────┤
│  Given [precondition/context]                      │
│  When [action/trigger]                             │
│  Then [expected outcome]                           │
└─────────────────────────────────────────────────────┘

快速开始

最快的3步使用流程：

第1步：确认已有AC文档
- 文件位置：spec/requirements/acceptance_criteria.md（或其他.md文件）
- 格式要求：每个AC包含 Given-When-Then 三段式结构
- 数量建议：至少2-3个AC（可以检查更多）
第2步：一键调用检查
- 命令：>>ac_format_check 或 >>ac_coverage
- AI会自动扫描所有AC，检查格式和覆盖度
- 检查内容：GWT三要素完整性 + 正常/边界/异常场景覆盖
- ⚠️ 只读检查：不会修改你的AC文档
第3步：查看检查报告
- 结果显示：对话窗口中直接显示完整报告
- 报告内容：每个AC的格式检查 + 覆盖度评分 + 改进建议
- 后续操作：根据报告手动修改AC，补充遗漏的场景

⏱️ 预计耗时：2-3分钟 / 10个AC

🆘 遇到问题？ 查看下方"GWT 格式检查"章节获取详细指导

GWT 格式检查

Given（前置条件）

是否清晰描述初始状态
是否包含必要的上下文
是否可重现

When（触发动作）

是否描述具体操作
是否单一、明确
是否是用户或系统行为

Then（预期结果）

是否可观察、可验证
是否有明确的成功标准
是否覆盖正常和异常场景

覆盖检查

是否覆盖正常流程（Happy Path）
是否覆盖边界条件
是否覆盖错误场景
每个 US 的 AC 数量是否合理（3-7 个）

分级检查策略

L1-STREAMLINED

检查 GWT 三要素是否完整
快速格式验证（< 5 分钟/AC）
通过标准：3 项中 2 项通过（≥67%）

L2-BALANCED

每要素检查 2-3 个关键点（共 6-9 项）
含覆盖度检查（Happy Path + Error）
通过标准：6 项中 5 项通过（≥83%）

L3-RIGOROUS

全面检查所有子项（12+ 项）
含边界条件、异常场景全覆盖
生成覆盖矩阵
通过标准：12 项中 11 项通过（≥91.7%）

限制条件

✅ 适用场景

已有AC文档，符合基本的Given-When-Then格式
需要验收AC质量（格式检查、覆盖度评估）
准备测试用例前，确保AC明确、可测试
需要发现遗漏的场景（边界条件、异常情况）
团队成员互相审查AC时，作为标准化检查清单

❌ 不适用场景

完全没有AC文档 → 先使用 ac_generate 从US生成AC骨架
AC格式完全错误（缺少Given-When-Then结构） → 先修复基本格式
需要自动修复AC而非只检查 → 本SKILL只生成报告，不修复；需手动改进
AC已经非常详细，覆盖度很高 → 无需检查，避免浪费时间
期望100%无误报 → 检测基于规则，可能有少量误报

📋 前置条件

至少有2-3个Acceptance Criteria（包含Given-When-Then三段式）
AC文档是.md格式，位于spec/requirements/目录下
AC已关联到对应的User Story（source_us字段填写）
愿意接受检查建议并手动补充遗漏场景
理解报告中的评分是辅助判断，最终决策由用户做出

示例

Scenario: 成功登录
  Given 用户已注册且账号正常
  And 用户在登录页面
  When 用户输入正确的用户名和密码
  And 点击登录按钮
  Then 用户跳转到首页
  And 显示欢迎信息

Scenario: 密码错误
  Given 用户已注册且账号正常
  When 用户输入错误的密码
  Then 显示"用户名或密码错误"提示
  And 用户停留在登录页面

>> 命令

>>ac_format_check    # AC 格式检查
>>ac_coverage        # AC 覆盖度检查
>>ac_generate        # 从 US 生成 AC 骨架

快速开始

GWT 格式检查

Given（前置条件）

When（触发动作）

Then（预期结果）

覆盖检查

分级检查策略

L1-STREAMLINED

L2-BALANCED

L3-RIGOROUS

限制条件

✅ 适用场景

❌ 不适用场景

📋 前置条件

示例

>> 命令

相关 Skills

acceptance-criteria

Acceptance Criteria Skill

概述