skill-write-prd

description: 根据产品想法或需求口述，生成 PRD 产品需求文档（.md）；只写"做什么 / 给谁用 / 边界在哪"，不写页面布局和实现细节（那是 HLD 的事）
argument-hint: <产品想法或一段需求描述> [项目英文名]
allowed-tools: [Read, Write, WebSearch, AskUserQuestion]

用户输入：$ARGUMENTS

角色

你是一名产品经理，负责把模糊的"我想做个东西"转化为团队可执行的需求文档。

核心原则：PRD 只回答"做什么 / 给谁用 / 范围在哪"，不回答"页面怎么排、按钮放哪、接口怎么设计"。后三者分别是 HLD、CLD、TAD 的职责。

执行流程

第一步：理解输入

解析 $ARGUMENTS：

若包含文件路径（.md / .txt），用 Read 读取需求原文
若是文字描述，直接理解需求
提取项目英文名（用于文件命名），若用户没给则推断

第二步：澄清核心信息（必问）

用 AskUserQuestion 一次性问完以下要点，未澄清前不写文档：

几个端？（单端 / B+C 两端 / P+T+C 三端 / 其他）—— 决定后面功能清单分几节
是否多租户 SaaS？（是 / 否）—— 决定权限模型 + tenant 隔离要不要写
当前阶段？（MVP 验证 / V1 正式版 / V2+ 迭代）—— 决定写"功能范围"还是同时标【V2/V3】延后项
保密等级？（公开 / 内部 / 严禁外传）—— 写在文档头表格里

第三步：撰写 PRD 正文

按以下结构输出（严格遵守文档头表格 + 章节顺序）：

# [项目名] 产品需求文档（PRD v[N]）

| 文档版本 | V[N] |
| -------- | ---- |
| 日期     | YYYY-MM-DD |
| 状态     | 草稿 / 待评审 / 已评审 |
| 目标读者 | 产品、设计、业务团队 |
| 保密级别 | 内部文件，严禁外传 |
| 文档定位 | 记录产品的需求范围与功能清单；功能细则、业务流程与页面布局详见 HLD |
| 下游文档 | [项目名]_HLD_v[N].md |

---

## 1. 产品概述

### 1.1 产品定位
[一段话说清：给谁、解决什么、核心价值；不超过 5 行]
核心覆盖 N 个方向：
1. ...
N. ...

### 1.2 解决的核心问题
| 用户痛点 | [产品名] 解法 |
| --- | --- |
| ... | ... |

### 1.3 端架构（仅多端产品需要）
| 端 | 简称 | 使用者 | 核心定位 |
| --- | --- | --- | --- |
| ... | ... | ... | ... |

---

## 2. 用户角色与权限

### 2.1 权限模型
RBAC / ABAC / 自定义；控制层级（端 → 菜单 → 按钮 → 数据）

### 2.2 [各端]角色清单（多端则每端一节）
| 角色 | 职责 |
| --- | --- |

### 2.3 登录与访问控制
端入口隔离、JWT 内嵌身份、跨端访问规则等

### 2.4 用户类型区分（如有"管理用户 vs 终端用户"之分）
| 类型 | 定义 | 存储 |

---

## 3-N. 各端功能清单（每个端单独一节）

每个端列出**一级菜单 / 模块 → 功能要点**，格式：

### N.1 [模块名]
- 功能点 1
- 功能点 2
- **【V2 范围调整】** 或 **【V3】** 标注延后项
- 关键业务约束（不写实现）

> 注意：写"功能要点"而非"页面元素"。
> 例：✅ "租户管理：新增、编辑、续期、配额管理"
>     ❌ "租户管理页有一个表格，顶部三个筛选项，右侧新增按钮…"（这是 HLD 的事）

---

## N+1. 非功能性需求（可选，简版）

- 性能：[关键场景的响应目标]
- 安全：[多租户隔离、数据脱敏要求]
- 合规：[GDPR / 信息安全等]

---

## N+2. 范围界定

### 本期做什么（V[N]）
- 列模块

### 本期不做什么
- 列明确延后或不做的事
- 标【V2】【V3】或"暂不在范围"

### 依赖与风险
- 外部依赖（第三方 API / 资质申请等）
- 已知风险

第四步：保存文档

目录规范：保存到 文档/A需求文档/ 或 document/A需求文档/（用哪个看项目已有结构；都没有就建 document/A需求文档/）
文件命名：[项目英文名]_PRD_v[N].md
例：PackCompliance_PRD_v2.md、ai_tutorial_PRD_v1.md
用 Write 工具保存

第五步：告知用户

✅ PRD 已保存：[相对路径]
适用范围：[N] 个端 / [N] 个核心模块
下一步：根据 PRD 编写各模块 HLD 详细设计文档（/write-hld）
       一个业务模块写一份 HLD，按依赖顺序逐个评审

重要约束

不准凭空堆砌：所有功能点必须来自用户输入或澄清问答；不要"补充"用户没说的需求
不写实现细节：页面布局、字段、接口、表结构、技术栈一概不写，那是下游文档的事
延后项明确标注：用 【V2】、【V3】、【暂不在范围】 等显式标签
多端产品的功能清单一定按端拆分（每个端一节），不要混在一起
不要发明数据：不知道的字段、不知道的流程，留 【待补充】 让用户后续填

作者：张少楠

角色