Skip to content
acceptance-criteria logo

Acceptance Criteria Skill

acceptance-criteria

检查Acceptance Criteria格式和完整性,验证是否符合Given-When-Then结构、覆盖正常流程/边界条件/异常场景。适合在为User Story编写AC后、准备测试用例前使用,当需要验收AC质量时。帮助不熟悉BDD的PM/BA确保AC明确、可测试、覆盖完整,避免遗漏关键场景。

SKILL.md

Full skill instructions

Acceptance Criteria Skill

Scope: REQUIREMENTS

版本: 0.1.0(占位)| 创建日期: 2025-11-27


概述

Acceptance Criteria (AC) 定义 User Story 的完成标准:

┌─────────────────────────────────────────────────────┐
│              ✓ 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 骨架

相关 Skills

  • 前置: user-story-format(US 已定义)
  • 并行: principle-invest(INVEST 验证)
  • 后续: bdd-scenario(转化为 BDD)
  • 后续: vertical-slice(设计阶段)

TODO: 待细化 AC 覆盖度检查规则

More skills from diegosouzapw

accessibility logo
diegosouzapw/awesome-omni-skill

accessibility

Accessibility guidelines for VS Code features — covers accessibility help dialogs, accessible views, verbosity settings, accessibility signals, ARIA alerts/status announcements, keyboard navigation, and ARIA labels/roles. Applies to both new interactive UI surfaces and updates to existing feature...

62 1
View
mermaid-diagrams logo
diegosouzapw/awesome-omni-skill

mermaid-diagrams

Mermaid diagram creation for flowcharts, sequences, ERDs, and more. Generate diagrams from text in markdown files. Use for documentation, architecture diagrams, and visual representations. Triggers on mermaid, flowchart, sequence diagram, ERD, entity relationship, gantt chart, pie chart, class di...

62 1
View
tauri2-react-rust logo
diegosouzapw/awesome-omni-skill

tauri2-react-rust

Guides development of cross-platform desktop apps with Tauri 2, TypeScript, React, and Rust. Use when building Tauri apps, implementing IPC, designing Rust backend or TypeScript/React frontend, when researching or cloning a website (open site, snapshot elements), when verifying local dev or built...

62 1
View
fp-ts-errors logo
diegosouzapw/awesome-omni-skill

fp-ts-errors

Handle errors as values using fp-ts Either and TaskEither for cleaner, more predictable TypeScript code. Use when implementing error handling patterns with fp-ts.

62 0
View
ring:pre-dev-research logo
diegosouzapw/awesome-omni-skill

ring:pre-dev-research

Gate 0 research phase for pre-dev workflow. Dispatches 3 parallel research agents to gather codebase patterns, external best practices, and framework documentation BEFORE creating PRD/TRD. Outputs research.md with file:line references.

62 0
View
create-assistant logo
diegosouzapw/awesome-omni-skill

create-assistant

Create and configure Vapi voice AI assistants with models, voices, transcribers, tools, hooks, and advanced settings. Use when building voice agents, phone bots, customer support assistants, or any conversational AI that handles phone or web calls.

62 0
View
codex-headless logo
diegosouzapw/awesome-omni-skill

codex-headless

Delegiere Aufgaben an OpenAI Codex CLI im Headless-Mode. Nutzt ChatGPT Subscription (KEIN API Key). Nur Workspace-Zugriff, KEIN System-Zugriff. Auto-Accept mit --full-auto. Web-Recherche mit --search.

62 0
View
social-media-scheduler logo
diegosouzapw/awesome-omni-skill

social-media-scheduler

Generate a full week of social media content for any topic. Outputs platform-optimized posts for Twitter/X, LinkedIn, and Instagram with hashtags and posting times.

62 0
View
Data Privacy Compliance logo
diegosouzapw/awesome-omni-skill

Data Privacy Compliance

Data privacy and regulatory compliance specialist for GDPR, CCPA, HIPAA, and international data protection laws. Use when implementing privacy controls, conducting data protection impact assessments, ensuring regulatory compliance, or managing data subject rights. Expert in consent management, da...

62 0
View
triple-review logo
diegosouzapw/awesome-omni-skill

triple-review

Reviews a task using the TRIPLE protocol, as the review agent.

62 0
View
Tech Stack & Architecture Decision logo
diegosouzapw/awesome-omni-skill

Tech Stack & Architecture Decision

Define and document the technology stack and architecture decisions for a project. Use when the user needs to choose a tech stack, make architecture decisions, define infrastructure choices, or document technology selections. Triggers on requests like "define the tech stack", "choose technologies...

62 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View