prd

PRD 生成器

创建详细、清晰、可行且适合实施的产品需求文档。

---

工作内容

1. 从用户那里接收功能描述
2. 提出 3-5 个必要的澄清问题（带字母选项）
3. 根据答案生成结构化的 PRD
4. 保存到 tasks/prd-[feature-name].md

重要： 不要开始实施。只需创建 PRD。

---

步骤 1：澄清问题

仅在初始提示模糊时提出关键问题。重点关注：

• 问题/目标： 这解决了什么问题？
• 核心功能： 关键操作是什么？
• 范围/边界： 不应该做什么？
• 成功标准： 如何知道完成了？

问题格式如下：

1. 此功能的主要目标是什么？
   A. 改善用户引导体验
   B. 提高用户留存率
   C. 减少支持负担
   D. 其他：[请具体说明]

2. 目标用户是谁？
   A. 仅新用户
   B. 仅现有用户
   C. 所有用户
   D. 仅管理员用户

3. 范围是什么？
   A. 最小可行版本
   B. 功能齐全的实现
   C. 仅后端/API
   D. 仅 UI

这允许用户用 "1A, 2C, 3B" 快速回应。记住缩进选项。

---

步骤 2：PRD 结构

使用这些部分生成 PRD：

1. 介绍/概述

功能及其解决的问题的简要描述。

2. 目标

具体、可衡量的目标（列表项目）。

3. 用户故事

每个故事都需要：

• 标题： 简短的描述性名称
• 描述： "作为一个 [用户]，我想要 [功能] 这样 [好处]"
• 验收标准： 对"完成"意味着什么的可验证清单

每个故事应该小到可以在一次专注的会话中实现。

格式：

### US-001: [标题]
**描述：** 作为一个 [用户]，我想要 [功能] 这样 [好处]。

**验收标准：**
- [ ] 具体可验证的标准
- [ ] 另一个标准
- [ ] 类型检查/代码规范通过
- [ ] **[仅 UI 故事]** 使用 dev-browser 技能在浏览器中验证

重要：

• 验收标准必须是可验证的，而不是模糊的。"正常工作"不好。"按钮在删除前显示确认对话框"好。
• 对于任何有 UI 更改的故事： 始终包含"使用 dev-browser 技能在浏览器中验证"作为验收标准。这确保了前端工作的视觉验证。

4. 功能需求

特定功能的编号列表：

• "FR-1: 系统必须允许用户..."
• "FR-2: 当用户点击 X 时，系统必须..."

明确且不含糊。

5. 非目标（范围之外）

此功能将不包括什么。对管理范围至关重要。

6. 设计考虑（可选）

• UI/UX 需求
• 如有可用的原型链接
• 相关现有组件重用

7. 技术考虑（可选）

• 已知约束或依赖关系
• 与现有系统的集成点
• 性能要求

8. 成功指标

将如何衡量成功？

• "将完成 X 的时间减少 50%"
• "将转化率提高 10%"

9. 开放问题

剩余问题或需要澄清的领域。

---

面向初级开发人员写作

PRD 读者可能是初级开发人员或 AI 代理。因此：

• 明确且不含糊
• 避免术语或解释它
• 提供足够的细节来理解目的和核心逻辑
• 编号需求以便于引用
• 在有帮助时使用具体示例

---

输出

• 格式： Markdown (.md)
• 位置： tasks/
• 文件名： prd-[feature-name].md (连字符格式)

---

示例 PRD

# PRD：任务优先级系统

## 介绍

为任务添加优先级，使用户能够专注于最重要的事情。任务可以标记为高、中或低优先级，具有视觉指示器和筛选功能，帮助用户有效地管理工作负载。

## 目标

- 允许为任意任务分配优先级（高/中/低）
- 在优先级级别之间提供清晰的视觉区分
- 启用按优先级筛选和排序
- 新任务默认为中等优先级

## 用户故事

### US-001：向数据库添加优先级字段
**描述：** 作为一个开发人员，我需要存储任务优先级，使其在会话之间保持。

**验收标准：**
- [ ] 向任务表添加优先级列：'high' | 'medium' | 'low'（默认 'medium'）
- [ ] 生成并成功运行迁移
- [ ] 类型检查通过

### US-002：在任务卡片上显示优先级指示器
**描述：** 作为一个用户，我希望能够一眼看到任务优先级，这样我就知道首先需要关注什么。

**验收标准：**
- [ ] 每个任务卡片显示彩色优先级徽章（红色=高，黄色=中，灰色=低）
- [ ] 无需悬停或点击即可看到优先级
- [ ] 类型检查通过
- [ ] 使用 dev-browser 技能在浏览器中验证

### US-003：向任务编辑添加优先级选择器
**描述：** 作为一个用户，我想要在编辑任务时更改任务的优先级。

**验收标准：**
- [ ] 任务编辑模态框中的优先级下拉列表
- [ ] 显示当前优先级为选中项
- [ ] 选择更改时立即保存
- [ ] 类型检查通过
- [ ] 使用 dev-browser 技能在浏览器中验证

### US-004：按优先级筛选任务
**描述：** 作为一个用户，当我专注时，我想要筛选任务列表，只看到高优先级项目。

**验收标准：**
- [ ] 带有选项的筛选下拉列表：全部 | 高 | 中 | 低
- [ ] 筛选器保留在 URL 参数中
- [ ] 当没有任务匹配筛选器时显示空状态消息
- [ ] 类型检查通过
- [ ] 使用 dev-browser 技能在浏览器中验证

## 功能需求

- FR-1: 向任务表添加 `priority` 字段（'high' | 'medium' | 'low'，默认 'medium'）
- FR-2: 在每个任务卡片上显示彩色优先级徽章
- FR-3: 在任务编辑模态框中包含优先级选择器
- FR-4: 向任务列表标题添加优先级筛选下拉列表
- FR-5: 在每个状态列内按优先级排序（高到中到低）

## 非目标

- 不基于优先级的通知或提醒
- 不基于截止日期的自动优先级分配
- 不为子任务继承优先级

## 技术考虑

- 重用带有颜色变体的现有徽章组件
- 通过 URL 搜索参数管理筛选状态
- 优先级存储在数据库中，而非计算

## 成功指标

- 用户可以在不到 2 次点击内更改优先级
- 高优先级任务立即在列表顶部可见
- 任务列表性能无退化

## 开放问题

- 优先级是否应该影响列内的任务排序？
- 我们是否应该添加优先级更改的键盘快捷键？

---

检查列表

保存 PRD 之前：

• 询问了带字母选项的澄清问题
• 合并了用户的答案
• 用户故事小而具体
• 功能需求编号明确且不含糊
• 非目标部分定义了明确边界
• 已保存到 tasks/prd-[feature-name].md