acceptance-criteria
检查Acceptance Criteria格式和完整性，验证是否符合Given-When-Then结构、覆盖正常流程/边界条件/异常场景。适合在为User Story编写AC后、准备测试用例前使用，当需要验收AC质量时。帮助不熟悉BDD的PM/BA确保AC明确、可测试、覆盖完整，避免遗漏关键场景。
Best use case
acceptance-criteria is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
检查Acceptance Criteria格式和完整性，验证是否符合Given-When-Then结构、覆盖正常流程/边界条件/异常场景。适合在为User Story编写AC后、准备测试用例前使用，当需要验收AC质量时。帮助不熟悉BDD的PM/BA确保AC明确、可测试、覆盖完整，避免遗漏关键场景。
Teams using acceptance-criteria should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/acceptance-criteria/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How acceptance-criteria Compares
| Feature / Agent | acceptance-criteria | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
检查Acceptance Criteria格式和完整性，验证是否符合Given-When-Then结构、覆盖正常流程/边界条件/异常场景。适合在为User Story编写AC后、准备测试用例前使用，当需要验收AC质量时。帮助不熟悉BDD的PM/BA确保AC明确、可测试、覆盖完整，避免遗漏关键场景。
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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字段填写） - 愿意接受检查建议并手动补充遗漏场景 - 理解报告中的评分是辅助判断，最终决策由用户做出 --- ## 示例 ```gherkin 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 覆盖度检查规则
Related Skills
acceptance-testing
Plan and (when feasible) implement or execute user acceptance tests (UAT) / end-to-end acceptance scenarios. Converts requirements or user stories into acceptance criteria, test cases, test data, and a sign-off checklist; suggests automation (Playwright/Cypress for web, golden/snapshot tests for CLIs/APIs). Use when validating user-visible behavior for a release, or mapping requirements to acceptance coverage.
acceptance-tester
Execute systematic acceptance testing to verify implementations against acceptance criteria. Use this skill when tasks mention "驗收測試", "acceptance testing", "驗收", "validate implementation", or when Gherkin scenarios need to be executed.
acceptance-test-writing
Guide for writing high-quality acceptance criteria and acceptance tests using industry-standard BDD (Behavior-Driven Development) and ATDD (Acceptance Test-Driven Development) practices. Use this skill when creating acceptance criteria for user stories, writing Gherkin scenarios, or implementing acceptance test specifications following Given-When-Then format.
acceptance-criteria-verification
Use after implementing features - verifies each acceptance criterion with structured testing and posts verification reports to the GitHub issue
acceptance-criteria-creator
Create acceptance criteria creator operations. Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category. Use when working with acceptance criteria creator functionality. Trigger with phrases like "acceptance criteria creator", "acceptance creator", "acceptance".
acceptance-criteria-authoring
Write clear, testable acceptance criteria in Given-When-Then format following INVEST principles and BDD best practices.
ux
This AI agent skill provides comprehensive guidance for creating professional and insightful User Experience (UX) designs, covering user research, information architecture, interaction design, visual guidance, and usability evaluation. It aims to produce actionable, user-centered solutions that avoid generic AI aesthetics.
chrome-debug
This skill empowers AI agents to debug web applications and inspect browser behavior using the Chrome DevTools Protocol (CDP), offering both collaborative (headful) and automated (headless) modes.
lets-go-rss
A lightweight, full-platform RSS subscription manager that aggregates content from YouTube, Vimeo, Behance, Twitter/X, and Chinese platforms like Bilibili, Weibo, and Douyin, featuring deduplication and AI smart classification.
astro
This skill provides essential Astro framework patterns, focusing on server-side rendering (SSR), static site generation (SSG), middleware, and TypeScript best practices. It helps AI agents implement secure authentication, manage API routes, and debug rendering behaviors within Astro projects.
modal-deployment
Run Python code in the cloud with serverless containers, GPUs, and autoscaling using Modal. This skill enables agents to generate code for deploying ML models, running batch jobs, serving APIs, and scaling compute-intensive workloads.
thor-skills
An entry point and router for AI agents to manage various THOR-related cybersecurity tasks, including running scans, analyzing logs, troubleshooting, and maintenance.