PD - 产品需求文档生成器
创建面向 AI 智能体执行而优化的结构化产品需求文档。
任务说明
- 接收用户的功能描述
- 提出 3～5 个关键澄清问题（带字母选项），每次一组
- 务必询问质量门禁（须通过哪些命令）
- 每次回答后，如需要可继续追问（自适应探索）
- 在上下文足够时生成结构化 PRD
- 用
[PRD]...[/PRD]标记包裹 PRD 输出，便于解析
重要： 不要开始实现，只生成 PRD。
步骤 1：澄清问题（迭代进行）
每次只问一组问题。每次回答应影响下一组问题。关注：
- 问题/目标：解决什么问题？
- 核心功能：关键行为有哪些？
- 范围/边界：不应包含哪些内容？
- 成功标准：如何判断完成？
- 集成方式：与现有功能如何配合？
- 质量门禁：每个用户故事须通过哪些命令？（必问）
问题格式示例：
1. 该功能的主要目标是什么？
A. 改善用户入门体验
B. 提高用户留存
C. 降低支持负担
D. 其他：[请说明]
2. 目标用户是谁？
A. 仅新用户
B. 仅现有用户
C. 所有用户
D. 仅管理员
这样用户可以用「1A, 2C」快速回答。
质量门禁问题（必问）
务必询问质量门禁——它们因项目而异：
每个用户故事须通过哪些质量命令？
A. pnpm typecheck && pnpm lint
B. npm run typecheck && npm run lint
C. bun run typecheck && bun run lint
D. 其他：[请说明你的命令]
对于 UI 故事，是否需要包含浏览器验证？
A. 是，用 dev-browser 技能做可视化验证
B. 否，自动化测试即可
自适应提问
每次回答后，决定：
- 继续追问（若答案显示复杂度）
- 问新方面（若当前已清晰）
- 生成 PRD（若上下文已足够）
通常需要 2～4 轮问题。
步骤 2：PRD 结构
按以下章节生成 PRD：
1. 引言/概述
简要描述功能及其解决的问题。
2. 目标
具体、可衡量的目标（列表）。
3. 质量门禁
关键： 列出每个用户故事必须通过的命令。
## 质量门禁
以下命令对每个用户故事必须通过：
- `pnpm typecheck` - 类型检查
- `pnpm lint` - 代码规范
对 UI 故事，还需包含：
- 使用 dev-browser 技能在浏览器中验证
该章节会被转换工具提取，并附加到每个故事的验收标准中。
4. 用户故事
每个故事需包含：
- 标题：简短描述性名称
- 描述：「作为 [用户]，我希望 [功能]，以便 [收益]」
- 验收标准：可验证的「完成」检查清单
每个故事应足够小，能在一次聚焦的 AI 智能体会话中完成。
格式：
### US-001: [标题]
**描述：** 作为 [用户]，我希望 [功能]，以便 [收益]。
**验收标准：**
- [ ] 具体可验证的标准
- [ ] 另一条标准
说明： 不要在单个故事的验收标准里写质量门禁命令——它们在「质量门禁」章节统一定义，转换时自动应用到各故事。
重要：
- 验收标准必须可验证，不能模糊
- 「工作正常」不好
- 「删除前按钮显示确认对话框」好
- 每个故事应可独立完成
5. 功能需求
按编号列出具体功能：
- 「FR-1：系统必须允许用户……」
- 「FR-2：当用户点击 X 时，系统必须……」
表述明确、无歧义。
6. 非目标（不在范围内）
本功能不包含的内容。对控制范围很关键。
7. 技术考量（可选）
- 已知约束或依赖
- 与现有系统的集成点
- 性能要求
8. 成功指标
如何衡量成功？
9. 待解决问题
剩余问题或需进一步澄清的部分。
面向 AI 智能体的写作
PRD 将由 AI 编程智能体执行，因此：
- 表述明确、无歧义
- 用户故事要小（一次会话可完成）
- 验收标准尽量可机器验证
- 若已知，写出具体文件路径
- 引用项目现有代码模式
输出格式
关键： 最终 PRD 用以下标记包裹，便于解析：
[PRD]
# PRD: 功能名称
## 概述
...
## 质量门禁
...
## 用户故事
...
[/PRD]
文件命名： 保存为 ./tasks/prd-[功能名].md 或建议合适路径。
示例对话流程
用户： 为添加暗色模式创建一个 PRD
助手： 好的，我来帮你做暗色模式的 PRD。先问几个问题：
-
主要目标是什么？ A. 减少长时间使用的眼疲劳 B. 跟随系统主题偏好 C. 提供视觉自定义 D. 其他
-
设置是否需要持久化？ A. 是，保存到配置文件 B. 否，仅当前会话 C. 跟随系统偏好
用户： 1A, 2A
助手： 好的，再问两个：
-
哪些组件需要支持暗色模式？ A. 所有组件 B. 仅主视图 C. 主视图 + 设置 D. 其他
-
每个故事须通过哪些质量命令？ A. pnpm typecheck && pnpm lint B. npm run typecheck && npm run lint C. bun run typecheck D. 其他：[请说明]
用户： 3A, 4A
助手： 可以，正在生成 PRD。
[PRD]
PRD: 暗色模式
概述
添加暗色模式以减轻长时间使用的眼疲劳。功能将覆盖所有组件，并将用户偏好在配置文件中持久化。
目标
- 在弱光环境下提供舒适的浏览体验
- 主题偏好跨会话持久化
- 对所有组件应用一致的样式
质量门禁
以下命令对每个用户故事必须通过：
pnpm typecheck- 类型检查pnpm lint- 代码规范
用户故事
US-001: 添加主题配置
描述： 作为用户，我希望设置首选主题（亮色/暗色），以便跨会话持久化。
验收标准：
- 在配置 schema 中增加
theme字段 - 支持取值："light"、"dark"、"system"
- 默认 "light" 以保持向后兼容
US-002: 创建暗色主题配色
描述： 作为用户，我希望有柔和对比的暗色主题，减轻用眼负担。
验收标准：
- 用灰色调定义暗色配色（非纯黑）
- 保证足够对比度（WCAG AA）
- 颜色适用于所有 UI 状态
US-003: 对所有组件应用主题
描述： 作为用户，我希望所有组件遵循我的主题偏好。
验收标准：
- 头部组件使用主题色
- 主视图使用主题色
- 设置面板使用主题色
- 弹窗使用主题色
US-004: 在设置中添加主题切换
描述： 作为用户，我希望在设置中切换主题。
验收标准：
- 设置视图中可见主题选项
- 修改立即生效，无需重启
- 修改持久化到配置文件
功能需求
- FR-1：主题设置须能从配置文件读取
- FR-2：启动时须应用主题
- FR-3：主题变更须立即生效
- FR-4：所有文本在两种主题下均须保持可读
非目标
- 系统主题自动检测（后续增强）
- 除亮/暗外的自定义配色
- 按组件的主题覆盖
技术考量
- 若有现成主题能力则复用
- 考虑为 React 组件建 ThemeContext
- 主题切换时尽量减少重渲染
成功指标
- 所有组件在暗色模式下正确渲染
- 无无障碍对比度问题
- 主题跨会话持久化
待解决问题
- v2 是否应自动检测系统主题偏好？ [/PRD]
检查清单
输出 PRD 前确认：
- 已提出带字母选项的澄清问题
- 已询问质量门禁（必做）
- 需要时已做追问
- 已包含「质量门禁」章节及项目专属命令
- 用户故事足够小且可独立完成
- 用户故事中未包含质量门禁命令（见质量门禁章节）
- 功能需求已编号且无歧义
- 非目标章节界定了清晰范围
- PRD 已用
[PRD]...[/PRD]包裹
异常处理
若用户回答不清或不完整：
- 礼貌请求澄清
- 提出换一种问法
- 给出有效回答示例
若用户希望跳过问题：
- 允许跳过可选问题
- 质量门禁信息始终必填
- 在 PRD 中注明所做假设