skills/atdd-assistant/SKILL.md
[UDS] Guide through Acceptance Test-Driven Development workflow
npx skillsauth add asiaostrich/universal-dev-standards atddInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Guide through the Acceptance Test-Driven Development (ATDD) workflow for defining and validating user stories.
引導驗收測試驅動開發(ATDD)流程,用於定義和驗證使用者故事。
WORKSHOP ──► DISTILLATION ──► DEVELOPMENT ──► DEMO ──► DONE
^ │ │
└──────────────────────────────┴──────────────┘
(Refinement needed)
PO presents user story, team asks clarifying questions, define acceptance criteria together.
Convert AC to executable test format, remove ambiguity, get PO sign-off.
Run acceptance tests (should fail initially), use BDD/TDD for implementation, iterate until all pass.
Show passing acceptance tests, demonstrate working functionality, get formal acceptance.
PO accepted, code merged, story closed.
| Criterion | Description | 說明 | |-----------|-------------|------| | Independent | Can be developed separately | 可獨立開發 | | Negotiable | Details can be discussed | 可協商細節 | | Valuable | Delivers business value | 提供商業價值 | | Estimable | Can estimate effort | 可估算工作量 | | Small | Fits in one sprint | 一個 Sprint 可完成 | | Testable | Has clear acceptance criteria | 有明確驗收條件 |
As a [role],
I want [feature],
So that [benefit].
### Acceptance Criteria
- Given [context], when [action], then [result]
/atdd - Start interactive ATDD session | 啟動互動式 ATDD 會話
/atdd "user can reset password" - ATDD for specific feature | 針對特定功能
/atdd US-123 - ATDD for existing user story | 處理現有使用者故事
After /atdd completes, the AI assistant should suggest:
驗收測試已定義。建議下一步 / Acceptance tests defined. Suggested next steps:
- 執行
/sdd建立規格文件 ⭐ Recommended / 推薦 — Create a specification document- 執行
/bdd將 AC 轉為 Gherkin 場景 — Convert AC to Gherkin scenarios- 執行
/tdd直接實作驗收測試 — Implement acceptance tests directly
完整的 AI 行為定義請參閱對應的命令文件:
/atddFor complete AI agent behavior definition, see the corresponding command file:
/atdd
development
[UDS] 扫描代码库的调试残留与代码质量问题;可自动修正安全模式。 Use when: before committing, during PR review, or periodic codebase cleanup. Keywords: sweep, debug cleanup, console.log, debugger, TODO, ts-any, code quality, 扫描, 清理.
tools
[UDS] 从规格衍生 BDD 场景、TDD 骨架或 ATDD 表格
development
[UDS] 识别重复流程并以正确的开发深度构建 Skill
tools
[UDS] AI 辅助 git push 安全层:质量门禁 + 协作护栏。 Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches. Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁.