- name
- devdocs-requirements
- description
- DevDocs 需求扩写专家。将用户简短需求扩展为结构化的需求文档，建立功能点、用户故事、验收标准的关联体系。支持中英文需求分析，生成符合 DevDocs 规范的需求文档。
- allowed-tools
- Read, Write, Glob, Grep, AskUserQuestion
需求扩写
将用户简短需求扩展为结构化的需求文档，建立功能点、用户故事、验收标准的关联体系。
语言规则
- 支持中英文提问
- 统一中文回复
- 使用中文生成文档
触发条件
- 用户提供功能需求或想法
- 用户要求创建/编写 PRD
- 用户想要澄清或记录需求
工作流程
1. 理解需求
│
▼
2. 探索代码库（如适用）
│
▼
3. 识别功能点 (F-XXX)
│
▼
4. 编写用户故事 (US-XXX)
│
▼
5. 定义验收标准 (AC-XXX)
│
▼
6. 生成追溯矩阵
│
▼
7. 用户确认编号规范
| 类型 | 前缀 | 格式 | 示例 |
|---|---|---|---|
| 功能点 | F | F-XXX | F-001, F-002 |
| 用户故事 | US | US-XXX | US-001, US-002 |
| 验收标准 | AC | AC-XXX | AC-001, AC-002 |
编号规则：
- 全局顺序编号，不嵌套
- 通过追溯矩阵表达关联关系
- 编号一旦分配不可复用
输出文件
主文件：docs/devdocs/01-requirements.md
如文档超过 300 行，可拆分为：
01-requirements.md- 概览和功能点01-requirements-stories.md- 用户故事详情01-requirements-nfr.md- 非功能性需求
详细模板参见 templates/requirements-template.md
文档结构
# 需求文档：<功能名称>
## 1. 背景与目标
## 2. 功能点清单
## 3. 用户故事
## 4. 验收标准
## 5. 追溯矩阵
## 6. 非功能性需求
## 7. 范围边界
## 8. 风险与假设核心概念
功能点 (Feature)
功能点是用户可感知的独立功能单元。
识别方法：
- 可以独立交付和验证
- 对用户有明确价值
- 粒度适中（不过大也不过小）
示例：
| 编号 | 功能点 | 描述 | 优先级 |
|------|--------|------|--------|
| F-001 | 用户注册 | 新用户通过邮箱注册账号 | P0 |
| F-002 | 用户登录 | 已注册用户登录系统 | P0 |
| F-003 | 密码找回 | 用户通过邮箱重置密码 | P1 |用户故事 (User Story)
用户故事描述用户如何使用功能点完成目标。
格式：作为 <角色>，我希望 <功能>，以便 <价值>
示例：
| 编号 | 功能点 | 角色 | 期望 | 目的 |
|------|--------|------|------|------|
| US-001 | F-001 | 新用户 | 使用邮箱注册 | 获得系统访问权限 |
| US-002 | F-001 | 新用户 | 设置安全密码 | 保护账号安全 |
| US-003 | F-002 | 已注册用户 | 使用邮箱密码登录 | 进入系统 |验收标准 (Acceptance Criteria)
验收标准定义用户故事的完成条件，是测试用例设计的依据。
原则：
- 可量化、可验证
- 描述预期行为，不描述实现
- 每个用户故事至少 2-3 条验收标准
示例：
### US-001: 使用邮箱注册
| 编号 | 标准描述 | 验证方式 |
|------|----------|----------|
| AC-001 | 有效邮箱格式可以提交注册 | 输入 [email protected] ，提交成功 |
| AC-002 | 已存在邮箱显示错误提示 | 输入已注册邮箱，显示"邮箱已存在" |
| AC-003 | 注册成功后发送验证邮件 | 收到包含验证链接的邮件 |追溯矩阵
追溯矩阵展示功能点、用户故事、验收标准的关联关系。
示例：
| 功能点 | 用户故事 | 验收标准 |
|--------|----------|----------|
| F-001 | US-001 | AC-001, AC-002, AC-003 |
| F-001 | US-002 | AC-004, AC-005 |
| F-002 | US-003 | AC-006, AC-007, AC-008 |约束
功能点约束
- [ ] 每个功能点必须有唯一编号 (F-XXX)
- [ ] 功能点必须标注优先级 (P0/P1/P2)
- [ ] 功能点描述应简洁明确
用户故事约束
- [ ] 每个用户故事必须关联到功能点
- [ ] 必须遵循"作为...我希望...以便..."格式
- [ ] 每个功能点至少有 1 个用户故事
验收标准约束
- [ ] 每个验收标准必须有唯一编号 (AC-XXX)
- [ ] 每个用户故事至少有 2 条验收标准
- [ ] 验收标准必须可量化、可验证
- [ ] 必须描述验证方式
追溯约束
- [ ] 必须提供追溯矩阵
- [ ] 所有功能点必须有对应的用户故事
- [ ] 所有用户故事必须有对应的验收标准
确认约束
- [ ] 必须与用户确认功能点是否完整
- [ ] 不得添加用户未提及且未确认的功能
下一步
完成后建议运行 /devdocs-system-design 进行系统设计。