- name
- requirement
- scope
- universal
- description
- [UDS] Write user stories and requirements that satisfy the INVEST criteria.
Use when: turning a feature idea into a user story, defining testable acceptance criteria, checking a backlog item for quality.
Not for: full specification documents with design and delta operations — use /sdd; deciding whether the idea is right at all — use /brainstorm.
Keywords: requirement, user story, INVEST, acceptance criteria, backlog refinement, 需求, 使用者故事, 驗收條件.
- allowed-tools
- Read, Write, Grep
- argument-hint
- [feature description | 功能描述]
# Requirement Assistant | 需求助手
Write well-structured user stories and requirements following INVEST criteria.
撰寫結構良好的使用者故事和需求文件,遵循 INVEST 準則。
## Workflow | 工作流程
1. **Understand context** - Gather feature information | 蒐集功能資訊
2. **Identify stakeholders** - Who benefits from this feature? | 誰受益?
3. **Write user story** - Follow the standard format | 遵循標準格式
4. **Define acceptance criteria** - Specific, testable conditions | 定義可測試條件
5. **Validate with INVEST** - Check quality criteria | 用 INVEST 驗證品質
## User Story Format | 使用者故事格式
```markdown
As a [role],
I want [feature],
So that [benefit].
### Acceptance Criteria
- [ ] Given [context], when [action], then [result]
- [ ] Given [context], when [action], then [result]
```
## INVEST Criteria | INVEST 準則
| Criterion | Description | 說明 |
|-----------|-------------|------|
| **I**ndependent | Can be developed separately | 可獨立開發 |
| **N**egotiable | Details can be discussed | 可協商細節 |
| **V**aluable | Delivers value to user | 提供使用者價值 |
| **E**stimable | Can estimate effort | 可估算工作量 |
| **S**mall | Fits in one sprint | 適合單一迭代 |
| **T**estable | Has clear test criteria | 有明確測試標準 |
## Quality Checklist | 品質檢查清單
- [ ] User story follows "As a / I want / So that" format
- [ ] At least 2 acceptance criteria defined
- [ ] All 6 INVEST criteria satisfied
- [ ] Edge cases and error scenarios considered
- [ ] Out of scope items documented
## Usage | 使用方式
```
/requirement - Interactive requirement wizard | 互動式需求精靈
/requirement user login - Write requirement for feature | 為功能撰寫需求
/requirement "users can export data" - Based on description | 根據描述撰寫
```
## Next Steps Guidance | 下一步引導
After `/requirement` completes, the AI assistant should suggest:
> **需求文件已完成。建議下一步 / Requirement document complete. Suggested next steps:**
> - 執行 `/sdd` 建立規格文件 ⭐ **Recommended / 推薦** — Create a specification document
> - 執行 `/atdd` 定義驗收測試 — Define acceptance tests
> - 執行 `/brainstorm` 進一步探索需求空間 — Explore the requirement space further
## Reference | 參考
- [Requirement Completeness Checklist](./requirement-checklist.md) — Read it when checking a requirement is complete before it is accepted.
- [Requirement Writing Guide](./requirement-writing.md) — Read it when writing a requirement from scratch.
- Detailed guide: [guide.md](./guide.md)
- Core standard: [requirement-engineering.md](../../core/requirement-engineering.md)
## AI Agent Behavior | AI 代理行為
> 完整的 AI 行為定義請參閱對應的命令文件:[`/requirement`](../commands/requirement.md#ai-agent-behavior--ai-代理行為)
>
> For complete AI agent behavior definition, see the corresponding command file: [`/requirement`](../commands/requirement.md#ai-agent-behavior--ai-代理行為)
GitHubで見る