Functional PRD Writer
Produce concise, implementation-oriented PRDs. Focus on what the feature does and how it works, so developers can start building immediately.
Core Philosophy
Functional PRDs answer what and how. Every section should help a developer understand exactly what to build. Skip business strategy; focus on behavior, rules, data, and edge cases.
工作流程
Step 1：需求澄清（必做）
在写 PRD 之前，先向用户确认以下关键信息（缺什么问什么）：
- 功能名称 — 一句话说清楚做什么
- 目标用户 — 谁用？管理员还是普通用户？
- 核心场景 — 用户在什么情况下会用这个功能？
- 技术约束 — 有没有限定技术栈、已有系统、接口？
- 范围边界 — 这期做什么？明确不做什么？
> 💡 如果用户给的信息足够完整，直接进入 Step 2，不要反复确认。
Step 2：规模判断
根据功能复杂度选择输出策略：
| 规模 | 特征 | 输出策略 |
|---|
| ------ | ------ | ---------- |
| 小型 | 单一页面/单个接口/无状态流转 | 精简版：概述 + 需求 + 接口 + 边界 |
| 中型 | 多页面/有状态/涉及权限 | 标准版：完整 8 节结构 |
| 大型 | 多模块/复杂流程/跨系统 | 详细版：完整结构 + 子模块拆分 + 数据流图 |
Step 3：输出 PRD
按标准结构撰写（见下方），根据 Step 2 的规模判断决定详略。
Step 4：自检
输出完成后，按以下清单自查：
- [ ] 每个功能点可独立转为测试用例
- [ ] 所有数值都有具体值（不是"适当"、"合理"）
- [ ] 状态流转画成了状态机
- [ ] 异常情况都有处理方案
- [ ] 权限控制明确（谁能看/谁能操作）
- [ ] 范围说明列出了"不做的内容"
Standard Structure
1. 功能概述 (Feature Overview)
- 一句话描述这个功能是什么
- 要解决什么具体问题
- 适用范围（哪些用户/场景）
2. 功能需求 (Functional Requirements)
- 功能点列表（编号，每个功能点可独立测试）
- 每个功能点的输入/输出/行为描述
- 优先级标注（P0 必做 / P1 应做 / P2 可选）
3. 用户流程 (User Flows)
- 核心操作流程（步骤编号）
- 分支流程（异常/边界情况）
- 用文字流程图描述，格式：
```
开始 → 步骤1 → 步骤2 → 分支判断 → ...
```
4. 交互与界面 (UI/UX Specs)
- 页面布局描述（哪些区域、什么内容）
- 表单字段说明（字段名、类型、校验规则、默认值）
- 操作反馈（成功/失败/加载中的提示方式）
- 特殊状态展示（空数据、加载中、错误、禁用等）
5. 数据与规则 (Data & Business Rules)
- 涉及的数据实体和字段
- 校验规则（格式、范围、必填等）
- 业务规则（条件判断、计算逻辑、状态流转）
- 权限控制（谁能看、谁能操作）
6. 接口设计 (API Design)
- 涉及的接口列表（路径、方法、用途）
- 请求参数和响应格式
- 错误码定义
7. 边界与异常 (Edge Cases & Error Handling)
- 输入异常如何处理
- 网络异常/超时如何处理
- 并发/竞态如何处理
- 数据不一致如何恢复
8. 非功能性需求 (Non-functional Requirements)
- 性能要求（响应时间、并发量）
- 安全要求（认证、加密、防护）
- 兼容性要求（浏览器、设备、系统版本）
Writing Guidelines
- 用中文撰写，除非用户指定英文
- 简洁直接：每个功能点一段话说清楚，不要铺陈背景
- 可测试：每个需求描述都应该能直接转化为测试用例
- 给具体值：不说"适当限制"，说"60秒内只能发送1次"
- 给具体格式：不说"输入用户名"，说"输入用户名（3-20位字母数字，必填）"
- 画状态机：有状态流转的必须画清楚（初始态→中间态→终态）
- 优先级标注：P0（必须有）/ P1（应该有）/ P2（锦上添花）
- 不写的明确说明：在"范围说明"中列出本期不做的内容
常见错误（避免）
| ❌ 错误写法 | ✅ 正确写法 |
|---|
| ------------ | ------------ |
| 用户输入合法的用户名 | 用户名：3-20位字母数字下划线，首字符非数字，必填 |
| 系统会适当限制频率 | 同一IP 60秒内最多发送3次，超限返回 429 |
| 支持多种导出格式 | 支持导出为 CSV（UTF-8 BOM）和 XLSX（.xlsx），默认 CSV |
| 异常时给出提示 | 网络超时：展示"请求超时，请重试"，提供"重试"按钮，自动重试1次 |
| 有权限控制 | Admin 角色可编辑/删除；普通用户仅查看；权限由 role 字段控制 |
Reference Files
- references/functional-prd-template.md — 完整功能型 PRD 模板（Markdown）
- references/common-patterns.md — 常见功能模式参考（CRUD、表单、列表、状态机、权限等）
Read references when: user asks for a full template, or when the PRD involves common functional patterns.