| name | spec |
| description | 生成功能需求规范文档。当用户想开发新功能、需要 spec、需求分析、功能规划时触发。这是所有开发工作的起点。 |
生成功能需求规范文档。
输入
用户用一句话描述想做什么(可以很粗糙)。
步骤
1. 需求访谈(必须做)
用 AskUserQuestion 逐个确认:
- 用户故事:谁在什么场景下做什么操作,期望什么结果?
- 触发方式:页面入口、API 调用、定时任务、webhook?
- 核心流程:happy path 一步步描述
- 异常场景:失败、超时、重复操作、并发?
- 数据:新增或修改哪些数据?输入输出?
- 边界:明确不做什么
- 优先级:MVP 包含哪些?哪些后续迭代?
每个问题等用户回答后再问下一个。"不确定"的标注为待定。
2. 代码调研(自动执行)
用 subagent 调研,不要让用户操心:
- 已有的相似功能实现模式
- 相关数据模型结构
- 路由注册方式
- 需要复用的现有代码
3. 生成 Spec
写入 docs/specs/{功能名}.md:
# {功能名}
## 状态
- 创建日期: {日期}
- 状态: 草稿
## 目标
(一句话说明要解决什么问题)
## 非目标
- ...
## 用户故事
作为 {角色},我想要 {操作},以便 {价值}
## 核心流程
1. ...
## 异常处理
| 场景 | 处理方式 |
|------|---------|
## 技术设计
### 数据模型
(表名、字段、类型)
### API 接口
| 方法 | 路径 | 说明 |
### 实现步骤(每步可独立 commit)
1. [ ] 数据模型
2. [ ] 控制器 + 路由
3. [ ] 前端页面
### 参考的现有模式
- {文件路径} — 参考了什么
## 测试计划
- [ ] ...
## 待定事项
- ...
## MVP 范围
4. 让用户审阅
生成后告诉用户:
- 请审阅 specs/{功能名}.md
- 确认 MVP 范围和待定事项
- 确认后用 /tdd 逐步开发