P
PRD需求文档生成
作者：鹿Sir办公效率v1
通过交互式需求分析生成完整的 PRD 文档。基于领域知识库进行结构化提问和数据流推导，确保需求理解和数据流的完整性。仅当用户要「生成 PRD/需求文档」时使用；分析现有代码库请用 analyze。
下载量
312
点赞
77
价格
¥1.49
精选
技能文档
---
name: gen-prd
description: 通过交互式需求分析生成完整的 PRD 文档。基于领域知识库进行结构化提问和数据流推导，确保需求理解和数据流的完整性。仅当用户要「生成 PRD/需求文档」时使用；分析现有代码库请用 analyze。
---
# /gen-prd - PRD 生成技能
**技能 ID**: `gen-prd`
**技能名称**: PRD 生成技能
**版本**: 2.0.1
**描述**: 基于领域知识库进行交互式需求分析，生成包含完整数据流的 PRD 文档
---
## 触发条件
- `/gen-prd`
- `/prd`
- `生成 PRD`
- `生成需求文档`
## 技能边界（防止误触发）
- **本技能仅当**用户要「生成 PRD / 需求文档 / 需求分析」时触发。
- **不得在以下场景触发本技能**：用户要「分析现有代码库」「分析项目结构」→ 应使用 **analyze**。
---
## 前置条件
- 用户已提供需求描述
- 领域知识库已准备就绪（`skills/libs/domain-knowledge/`）
---
## 核心增强：领域知识库驱动
本技能基于领域知识库（`skills/libs/domain-knowledge/`）进行增强，实现：
1. **领域识别与知识库加载** — 自动识别需求涉及领域，加载对应知识库
2. **结构化提问** — 基于知识库中的业务场景、核心实体、业务规则生成问题
3. **数据流推导** — 引用知识库中的典型数据流骨架，快速推导完整数据流
4. **反向验证** — 数据流逐条确认，AI 补充缺失环节
---
## 技能行为
### 阶段一：领域识别与知识库加载
```
分析用户需求描述，识别涉及领域并加载知识库：
【领域识别规则】
| 领域 | 核心关键词 | 关联关键词 | 知识库文件 |
|------|-----------|-----------|-----------|
| 积分 | 积分、积分系统、积分兑换、积分抵扣 | 签到、积分商城、会员积分 | domain-knowledge/points.md |
| 用户中心 | 用户、登录、注册、认证、权限 | 账号、密码、授权、SSO | domain-knowledge/user-center.md |
| 电商 | 商品、库存、购物车、电商、商城 | SKU、SPU、类目、品牌 | domain-knowledge/ecommerce.md |
| 订单 | 订单、下单、购物、交易 | 订单状态、履约、售后 | domain-knowledge/order.md |
| 支付 | 支付、退款、微信支付、支付宝 | 收银台、支付回调、对账 | domain-knowledge/payment.md |
【多领域识别】
当识别到多个领域时，按以下规则处理：
1. 确定主领域（用户描述的核心功能）
2. 确定关联领域（依赖或被依赖）
3. 按依赖顺序加载知识库：用户中心 → 电商 → 订单 → 支付 → 积分
【识别结果确认】
"根据您的需求描述，我识别到以下领域：
• 主领域：{领域名称}
• 关联领域：{领域列表}
是否正确？
A) 确认正确
B) 需要调整（请说明）
C) 暂不加载知识库"
```
### 阶段二：结构化提问（基于知识库）
```
基于加载的领域知识库，生成结构化问题：
【提问类型 1：业务场景提问】（必问）
来源：知识库「典型业务场景」表格
模板："您的{领域名称}需要支持哪些功能场景？（可多选）"
示例（积分领域）：
"您的积分系统需要支持哪些功能场景？（可多选）"
A) 签到得积分
B) 消费返积分
C) 邀请得积分
D) 任务得积分
E) 积分兑换商品
F) 积分抵扣订单
G) 积分过期处理
H) 其他（请说明）
【提问类型 2：核心实体提问】（按需追问）
来源：知识库「核心实体」表格
模板："关于{实体名称}，需要支持以下哪些能力？"
示例（积分账户）：
"关于积分账户，需要支持以下哪些能力？"
A) 单一账户（所有积分统一管理）
B) 多类型账户（不同来源积分分账户管理）
C) 积分冻结/解冻
D) 积分转赠
E) 以上都不需要
【提问类型 3：业务规则提问】（按需确认）
来源：知识库「业务规则模板」章节
模板："关于{规则名称}，请确认您的业务规则："
示例（积分过期规则）：
"关于积分过期，请确认您的业务规则："
A) 永不过期
B) 固定有效期（获得后 N 天过期）
C) 滚动有效期（每次使用后续期）
D) 年底清零
E) 按批次过期（先进先出）
【提问类型 4：集成点提问】（跨领域场景）
来源：知识库「常见集成点」章节
模板："您的{领域名称}需要与哪些系统对接？"
示例（积分系统集成）：
"您的积分系统需要与哪些系统对接？（可多选）"
A) 用户系统（获取用户信息）
B) 订单系统（消费返积分、积分抵扣）
C) 支付系统（支付成功触发积分）
D) 消息系统（积分变动通知）
E) 暂无对接需求
【提问数量控制】
- 必问问题：3-5 个（业务场景、目标用户、核心功能）
- 按需追问：2-3 个（根据用户选择追问）
- 单次提问：最多 5 个选项
- 总提问轮次：控制在 3-5 轮
```
### 阶段三：需求总结与技术栈推荐
```
【需求总结】
根据您的需求，我理解这是一个【系统类型】：
**核心功能**：
- 功能 1
- 功能 2
- 功能 3
**目标用户**：【用户类型】
**预期规模**：日活 X 万
**涉及领域**：{基于识别结果}
**集成需求**：{基于用户选择}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【技术栈推荐】
基于您的需求，我推荐以下技术栈方案：
**前端**：Vue 3 + Ant Design Vue
- 组件库丰富，开发效率高
- 适合企业级应用和中后台系统
- 与后端集成简单
**后端**：Spring Boot 3 + MyBatis-Plus
- 成熟稳定，生态完善
- 开发效率高，易于维护
- 支持快速迭代
【根据场景推荐】
- 如需 AI 能力：LangChain4j + LangGraph4j
- 如用户规模>10 万：Spring Cloud 微服务
- 如需实时通信：WebSocket + Redis
**数据库**：MySQL 8.0 + Redis
- MySQL：主从复制，读写分离
- Redis：缓存热点数据
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
**请确认技术栈方案**：
A) 采用推荐方案
B) 调整技术栈（请说明）
C) 使用其他技术栈（请说明）
确认后我将进行数据流推导。
```
### 阶段四：数据流推导（基于知识库）
```
【数据流推导规则】
1. 匹配知识库中的数据流骨架
- 从知识库「典型数据流骨架」章节匹配相关数据流
- 根据用户选择的业务场景，选择对应数据流
2. 根据用户选择调整数据流
- 保留数据流的骨架结构
- 根据用户选择调整处理步骤
3. 推导跨领域数据流
- 识别领域间的依赖关系
- 定义数据契约
【数据流推导示例】
用户选择：签到得积分 + 连续签到奖励
原始数据流（来自积分知识库）：
┌─────────────────────────────────────────────┐
│ 数据流：签到获取积分 │
│ 起点：用户签到请求 │
│ 处理：校验→计算积分→入账→记录流水 │
│ 终点：更新账户余额 │
│ 触发条件：每日首次签到 │
└─────────────────────────────────────────────┘
调整后数据流：
┌─────────────────────────────────────────────┐
│ 数据流：签到获取积分（含连续签到奖励） │
│ 起点：用户签到请求 │
│ 处理： │
│ 1. 校验今日是否已签到 │
│ 2. 计算基础积分（10 积分） │
│ 3. 计算连续签到奖励 │
│ - 连续 7 天：+5 积分 │
│ - 连续 30 天：+20 积分 │
│ 4. 积分入账 │
│ 5. 记录流水（含过期时间） │
│ 6. 更新连续签到天数 │
│ 终点：更新账户余额 │
│ 触发条件：每日首次签到 │
└─────────────────────────────────────────────┘
【跨领域数据流示例】
订单 + 积分领域交叉：
| 数据流 | 起点领域 | 终点领域 | 数据内容 | 触发条件 |
|--------|---------|---------|---------|---------|
| 消费返积分 | 订单 | 积分 | 订单ID、用户ID、订单金额 | 订单支付成功 |
| 积分抵扣 | 积分 | 订单 | 用户ID、使用积分、抵扣金额 | 用户下单使用积分 |
| 积分撤销 | 订单 | 积分 | 订单ID、用户ID | 订单退款 |
```
### 阶段五：数据流反向验证
```
【数据流清单展示】
"根据您的需求，我梳理了以下核心数据流：
| 序号 | 数据流名称 | 起点 | 终点 | 触发条件 | 是否闭环 |
|------|-----------|------|------|---------|---------|
| 1 | 签到获取积分 | 用户签到 | 更新账户余额 | 每日首次签到 | ✓ |
| 2 | 消费返积分 | 订单支付成功 | 更新账户余额 | 订单支付回调 | ✓ |
| 3 | 积分兑换商品 | 用户兑换请求 | 更新账户余额 | 用户主动兑换 | ✓ |
| 4 | 积分过期处理 | 定时任务 | 更新账户余额 | 每日凌晨 | ✓ |
| ... | ... | ... | ... | ... | ... |
【逐条确认】
逐条展示数据流详情，请用户确认：
"【数据流 1：签到获取积分】
起点：用户签到请求
输入：userId, signInDate
处理流程：
1. 校验今日是否已签到
2. 计算基础积分（10 积分）
3. 计算连续签到奖励
4. 积分入账
5. 记录流水（含过期时间）
输出：availablePoints + N
终点：更新账户余额
异常处理：已签到则提示"今日已签到"
请确认：
A) 确认正确
B) 需要调整（请说明）
C) 不需要这个数据流"
【缺失环节检测】
检测规则：
1. 用户选择的功能是否有对应数据流
2. 跨领域交互是否有数据流
3. 异常场景是否有数据流
"检测到您选择了'积分过期处理'，但尚未梳理对应数据流。是否需要补充？
A) 补充该数据流
B) 暂时不需要"
【完成确认】
所有数据流确认后：
"数据流梳理完成！共梳理 X 条数据流，已形成闭环。
是否继续生成 PRD 文档？
A) 继续生成 PRD
B) 还需要调整数据流"
```
### 阶段六：生成 PRD 文档
**写入强制规范（空仓库 / 新项目 P0，执行前必读）**
1. **路径约定**：默认输出 `docs/prd/YYYY-MM-DD-{project-name}.md`（或用户指定的 `--output` 路径）。父目录为 `docs/prd/`。
2. **先建目录再写文件**：在写入任何文件之前，**必须**确保父目录存在。若 `docs/` 或 `docs/prd/` 不存在，**必须先创建**（例如在支持文件操作的环境中使用「创建目录」能力，等价于 `mkdir -p docs/prd`），**禁止**因目录不存在而仅在对话中展示 PRD 正文却不落盘。
3. **必须真实写入**：完成澄清与内容生成后，**必须**将完整 PRD 写入上述 Markdown 文件；**禁止**仅用「正在生成…」话术代替实际文件创建。
4. **失败处理**：若当前环境无法创建目录或写入文件，应明确告知用户「无法写入磁盘」并给出可手动创建的命令（如 `mkdir -p docs/prd`）与目标路径，而不是假装已生成。
```
正在生成 docs/prd/YYYY-MM-DD-{project-name}.md...
✅ PRD 已生成，包含：
- 项目背景与目标
- 功能列表（X 个核心功能，X 个辅助功能）
- **核心数据流与闭环**（X 条数据流，已验证闭环）
- 用户故事（X 个）
- 验收标准
- 非功能性需求（基于领域知识库约束条件）
- 推荐技术栈（已确认）
接下来可以进行系统设计，使用 `/gen-design` 开始。
**自动继续**：若本会话由 start 进入且平台支持技能链调用，应输出「即将为您执行 /gen-design；若需暂停请说「暂停」。」并**代为调用 gen-design**（传入本 PRD 路径）；否则输出「是否需要现在开始？」由用户确认后再执行。
```
---
## 领域知识库使用规范
### 知识库文件位置
```
skills/libs/domain-knowledge/
├── points.md # 积分领域
├── user-center.md # 用户中心领域
├── ecommerce.md # 电商领域
├── order.md # 订单领域
└── payment.md # 支付领域
```
### 知识库使用方式
| 使用阶段 | 使用内容 | 用途 |
|---------|---------|------|
| 领域识别 | 关键词映射 | 识别需求涉及领域 |
| 结构化提问 | 典型业务场景、核心实体、业务规则 | 生成结构化问题 |
| 数据流推导 | 典型数据流骨架 | 引用并调整数据流 |
| PRD 生成 | 约束条件、常见问题 | 补充非功能性需求 |
---
## 技术栈推荐规则
### 默认推荐（擅长技术栈）
```
**前端**：
- 框架：Vue 3.x（组合式 API）
- UI 库：Ant Design Vue 4.x
- 状态管理：Pinia
- 路由：Vue Router 4.x
- HTTP 客户端：Axios
**后端**：
- 框架：Spring Boot 3.x
- ORM：MyBatis-Plus 3.5.x
- 安全：Spring Security + JWT
- 文档：Knife4j（Swagger 3）
- 工具：Lombok, Hutool
**数据库**：
- 关系型：MySQL 8.0
- 缓存：Redis 6.x
- 搜索引擎：Elasticsearch（可选）
**部署**：
- 容器：Docker
- 编排：Kubernetes（大规模）
- CI/CD：Jenkins/GitLab CI
```
### 技术栈选择决策树
```
需求分析 → 技术栈推荐
1. 用户规模？
- <1 万 → 单体架构（Spring Boot）
- 1-10 万 → 单体 + 读写分离
- >10 万 → 微服务（Spring Cloud）
2. 是否需要 AI 能力？
- 是 → LangChain4j + LangGraph4j
- 否 → 标准技术栈
3. 前端类型？
- 企业级/中后台 → Vue 3 + Ant Design
- C 端/H5 → Vue 3 + Vant
- 复杂交互 → React + Ant Design
4. 特殊需求？
- 实时通信 → WebSocket
- 大数据 → Elasticsearch
- 高并发 → Redis 集群
```
---
## PRD 文档模板
详见 [templates/prd-template.md](./templates/prd-template.md)
核心章节「核心数据流与闭环」必须包含：
```markdown
## 5. 核心数据流与闭环（必填）
### 5.1 数据流清单
| 数据流编号 | 数据流名称 | 起点 | 终点 | 经手模块/服务 | 是否闭环 |
|------------|------------|------|------|---------------|----------|
| DF-001 | {名称} | {起点} | {终点} | {模块} | 是/否 |
### 5.2 数据流详情
#### DF-001：{数据流名称}
- **起点**：{触发条件}
- **输入**：{输入数据}
- **处理流程**：
1. ...
2. ...
- **输出**：{输出数据}
- **终点**：{结束状态}
- **异常处理**：{异常场景}
### 5.3 数据闭环验证
| 闭环 | 起始数据 | 终止数据 | 验证结果 |
|------|---------|---------|---------|
| {名称} | {起始} | {终止} | ✓ 已闭环 |
```
---
## 输出文件
```
docs/prd/YYYY-MM-DD-{project-name}.md
```
**目录与写入**：见上文「阶段六」—— 写入前必须保证 `docs/prd` 存在，且必须将文件写入磁盘。通用约定汇总见 [SKILLS-FILE-OUTPUT.md](../SKILLS-FILE-OUTPUT.md)。
---
## 示例对话
### 示例：积分系统（多领域交叉）
```
用户：/gen-prd 我要做一个电商积分系统
AI: 分析您的需求描述，我识别到以下领域：
• 主领域：积分系统
• 关联领域：用户中心、订单、支付
是否正确？
A) 确认正确
B) 需要调整
用户：A
AI: 好的，已加载积分、用户中心、订单、支付领域知识库。
让我了解一些关键信息：
1. 目标用户是谁？
A) 企业内部员工
B) C 端消费者
C) B 端商家
2. 您的积分系统需要支持哪些功能场景？（可多选）
A) 签到得积分
B) 消费返积分
C) 邀请得积分
D) 任务得积分
E) 积分兑换商品
F) 积分抵扣订单
G) 积分过期处理
H) 其他（请说明）
3. 关于积分过期，请确认您的业务规则：
A) 永不过期
B) 固定有效期（获得后 N 天过期）
C) 滚动有效期（每次使用后续期）
D) 年底清零
4. 您的积分系统需要与哪些系统对接？（可多选）
A) 用户系统（获取用户信息）
B) 订单系统（消费返积分、积分抵扣）
C) 支付系统（支付成功触发积分）
D) 消息系统（积分变动通知）
E) 暂无对接需求
5. 预期用户规模？
A) 日活<1 万
B) 日活 1-10 万
C) 日活>10 万
用户：1-B, 2-ABEFG, 3-B（有效期1年）, 4-ABCD, 5-B
AI: 根据您的需求，我理解这是一个面向 C 端消费者的电商积分系统：
**核心功能**：
- 签到得积分
- 消费返积分
- 积分兑换商品
- 积分抵扣订单
- 积分过期处理（有效期1年）
**集成需求**：
- 用户系统：获取用户信息
- 订单系统：消费返积分、积分抵扣
- 支付系统：支付成功触发积分
- 消息系统：积分变动通知
**预期规模**：日活 1-10 万
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
**推荐技术栈**：...（略）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
**请确认技术栈方案**：
A) 采用推荐方案
B) 调整技术栈
用户：A
AI: 现在进行数据流推导...
根据您的需求，我梳理了以下核心数据流：
| 序号 | 数据流名称 | 起点 | 终点 | 触发条件 | 闭环 |
|------|-----------|------|------|---------|------|
| 1 | 签到获取积分 | 用户签到 | 更新账户余额 | 每日首次签到 | ✓ |
| 2 | 消费返积分 | 订单支付成功 | 更新账户余额 | 订单支付回调 | ✓ |
| 3 | 积分兑换商品 | 用户兑换请求 | 更新账户余额 | 用户主动兑换 | ✓ |
| 4 | 积分抵扣订单 | 用户下单 | 更新账户余额 | 用户选择积分支付 | ✓ |
| 5 | 积分过期处理 | 定时任务 | 更新账户余额 | 每日凌晨 | ✓ |
| 6 | 订单退款积分撤销 | 订单退款 | 更新账户余额 | 订单退款回调 | ✓ |
【数据流 1：签到获取积分】
起点：用户签到请求
输入：userId, signInDate
处理流程：
1. 校验今日是否已签到
2. 计算基础积分（10 积分）
3. 积分入账
4. 记录流水（过期时间：1年后）
输出：availablePoints + N
终点：更新账户余额
请确认：
A) 确认正确
B) 需要调整（请说明）
C) 跳过确认，直接生成 PRD
用户：C
AI: 正在生成 docs/prd/2026-03-02-ecommerce-points-system.md...
✅ PRD 已生成，包含：
- 项目背景与目标
- 功能列表（5 个核心功能，3 个辅助功能）
- **核心数据流与闭环**（6 条数据流，已验证闭环）
- 用户故事（12 个）
- 验收标准
- 非功能性需求（含积分领域约束条件）
- 推荐技术栈（已确认）
接下来可以进行系统设计，使用 `/gen-design` 开始。
是否需要现在开始？
```
---
## 相关技能
- **start**: 入口技能，本技能的前置技能
- **gen-design**: 系统设计，本技能的后续技能
- **gen-coding-specs**: 在 **gen-code** 之前生成 `docs/coding-specs/`（建议在 **gen-design** 与 **validate** 之后执行，见 [SKILL-VALUE-CHAIN.md](../SKILL-VALUE-CHAIN.md)）
- **domain-knowledge**: 领域知识库，本技能的知识来源
---
## 版本历史
| 版本 | 日期 | 变更说明 |
|------|------|----------|
| 2.0.1 | 2026-03-24 | 空仓库写入强制规范：先创建 `docs/prd` 再落盘，禁止仅对话输出 |
| 2.0.0 | 2026-03-07 | 新增领域知识库驱动、存量项目需求分析增强 |
| 1.1.0 | 2026-03-03 | 新增需求优先级评估 |
| 1.0.0 | 2026-03-01 | 初始版本 |
---
*本技能是 AI Speckits 技能体系的需求分析阶段，基于领域知识库增强。*使用说明
# /gen-prd - PRD 生成技能
**版本**: 1.0.0
**阶段**: Phase 1
---
## 概述
`/gen-prd` 技能用于通过交互式需求分析，生成完整的产品需求文档（PRD）。
---
## 使用方式
### 基本用法
```bash
# 直接使用
/gen-prd 我要做一个用户积分系统
# 从 start 技能引导后使用
/start 我要做一个积分系统
# ... 需求澄清后 ...
/gen-prd
# 指定输出路径
/gen-prd --output=docs/prd/custom-prd.md
```
### 参数说明
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `requirement` | string | 否 | - | 需求描述 |
| `output` | string | 否 | `docs/prd/YYYY-MM-DD-{project-name}.md` | 输出文件路径 |
---
## 输入
- 需求描述（直接输入或从 start 技能传入）
- 需求澄清信息（通过交互问答收集）
---
## 输出
- `docs/prd/YYYY-MM-DD-{project-name}.md` - PRD 文档
---
## PRD 文档结构
| 章节 | 说明 | 必填 |
|------|------|------|
| 项目背景 | 项目概述、目标、范围 | 是 |
| 目标用户 | 用户画像、用户规模 | 是 |
| 功能需求 | 功能列表、功能详情 | 是 |
| 用户故事 | 用户故事及验收标准 | 是 |
| 核心数据流与闭环 | 数据流路径、闭环保证 | **是（必填）** |
| 非功能性需求 | 性能、安全、其他需求 | 是 |
| 技术栈确认 | 前后端技术栈 | 是 |
| 验收标准 | 功能验收、质量验收 | 是 |
---
## 核心数据流与闭环
PRD 中**必须**包含「核心数据流与闭环」节，描述：
1. **核心数据流**：数据从哪里来、到哪里去
2. **闭环保证**：如何保证数据一致性和完整性
**示例**：
| 数据流编号 | 数据流名称 | 触发条件 | 数据来源 | 数据去向 | 闭环说明 |
|------------|------------|----------|----------|----------|----------|
| DF-001 | 积分获取 | 用户消费 | 订单系统 | 积分账户 | 订单完成后触发积分计算，事务保证一致性 |
| DF-002 | 积分兑换 | 用户兑换 | 积分账户 | 商品系统 | 积分扣减与商品发放原子操作 |
---
## 需求澄清问题
本技能会通过交互问答收集以下信息：
1. **目标用户**：企业内部员工 / C 端消费者 / B 端商家
2. **核心功能**：根据需求描述列出选项
3. **用户规模**：<1 万 / 1-10 万 / >10 万
4. **集成需求**：用户系统 / 订单系统 / 支付系统
5. **技术栈偏好**：推荐方案 / 指定技术栈
---
## 与其他技能的关系
### 上游
- `/start` → 需求澄清后引导至 `/gen-prd`
### 下游
- `/gen-prd` → `/gen-design`（系统设计）
- `/gen-prd` → `/validate --mode=dataflow`（验证数据流）
---
## 常见问题
### Q1: PRD 生成后可以修改吗？
可以。PRD 是活文档，建议在需求变更时及时更新。
### Q2: 如何确保 PRD 的完整性？
本技能会在生成 PRD 时自动检查必填章节，特别是「核心数据流与闭环」节。
### Q3: PRD 与设计文档的关系？
PRD 侧重业务需求，设计文档侧重技术实现。设计文档应与 PRD 中的数据流对齐。
---
## 相关文件
- [prompt.md](./prompt.md) - 详细提示词
- [templates/prd-template.md](./templates/prd-template.md) - PRD 模板
- [SKILL-ROUTING.md](../SKILL-ROUTING.md) - 技能路由表
---
## 版本历史
| 版本 | 日期 | 变更说明 |
|------|------|----------|
| 1.0.0 | 2026-03-01 | 初始版本 |
---
*本技能是 AI Speckits 技能体系的需求分析阶段。*支持平台：Qoder · QoderWork · Claude · Codex 等 AI 编程助手