# Create Prd

> This skill should be used when the user asks to "create PRD", "write product requirements document", or mentions "PRD", "产品需求文档", "创建PRD", "写PRD", "生成PRD".

- Skill: `tuyv/create-prd` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tuyv/create-prd`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tuyv/create-prd/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: tuyv (https://skillmd.com/u/tuyv)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tuyv/create-prd

---


# PRD 创建

按照以下阶段将产品想法转化为完整的中文 PRD 文档。所有 PRD 内容使用中文撰写。

## 输出模式

根据 `$ARGUMENTS` 确定输出模式：

| 参数 | 模式 | 输出 |
|------|------|------|
| `--md`（默认） | 本地 Markdown | 保存为 `.md` 文件到项目目录 |
| `--lark` | 飞书云文档 | 通过 `lark-cli` 创建飞书文档，充分使用飞书富文本特性 |

`--lark` 模式可附加位置参数（互斥），支持 token 或飞书 URL：
- `--folder-token` -- 创建到指定文件夹（token 如 `fldcnXXXX` 或 URL 如 `https://xxx.feishu.cn/drive/folder/fldcnXXXX`）
- `--wiki-node` -- 创建到知识库节点下（token 如 `wikcnXXXX` 或 URL 如 `https://xxx.feishu.cn/wiki/wikcnXXXX`）
- `--wiki-space` -- 创建到知识空间根目录（ID 如 `7000000000000000000`、URL 如 `https://xxx.feishu.cn/wiki/settings/7000000000000000000`，或 `my_library` 表示个人知识库）

用户传入 URL 时直接透传给 `lark-cli`，无需手动提取 token。未指定位置参数时，创建到用户个人空间根目录。

## 阶段 0：导入上下文

检查是否存在已有的设计或需求文档：

1. 在当前项目中搜索 `docs/`、`prd/` 目录或用户指定的文件
2. 如果找到相关文档，提取关键信息（问题陈述、目标用户、核心功能）作为预填充内容
3. 如果没有找到，跳过此阶段

## 阶段 1：确定 PRD 类型

询问用户需要哪种类型的 PRD：

- **完整版**（推荐）：包含所有标准章节，适合复杂项目和重要功能
- **精简版**：仅包含核心章节，适合小功能快速迭代
- **单页版**：单页概要，适合概念验证和高层汇报

记录选择结果，确定后续章节结构。

## 阶段 2：收集信息

按 `references/prd-interview-questions.md` 中的提问清单，逐个收集信息。每次只问一个问题，等待回答后再继续下一个。

- 基础信息（7 项）：所有类型都需要
- 完整版额外信息（5 项）：仅完整版需要
- AI Agent 边界信息：当 PRD 将由 AI 编码代理消费时收集

如果阶段 0 已提取到预填充内容，展示给用户确认或修改，跳过已有信息的提问。

## 阶段 3：生成 PRD 文档

基于收集的信息生成 PRD：

1. **选择模板**：
   - 完整版：参考 `references/prd-template-full.md`
   - 精简版：参考 `references/prd-template-brief.md`
   - 单页版：参考 `references/prd-template-onepager.md`

2. **填充内容**：使用收集的信息填充每个章节，遵循 `references/prd-best-practices.md` 中的编写原则

3. **AI Agent 可消费性**：
   - 每个需求写成离散的、可验证的条目（列表优于长段落）
   - 非目标用正向约束表述（"禁止实现 X" 而非仅列出排除范围）
   - P0 功能拆分为 5-15 分钟的代理工作阶段，每阶段带可测试检查点
   - 完整版中包含三层边界框架：自主执行 / 需确认 / 禁止操作

4. **质量要求**：
   - 问题陈述包含具体数据或研究支持
   - 目标符合 SMART 原则
   - 成功指标明确量化
   - 避免模糊词汇（"大约"、"可能"、"尽量"）
   - 使用主动语态和明确动词

5. **格式**：
   - `--md` 模式：标准 Markdown，清晰的标题层次，合理使用列表和表格
   - `--lark` 模式：Lark-flavored Markdown，参照下方"飞书文档增强"章节

## 阶段 4：验证并保存

按 `references/prd-validation-checklist.md` 执行验证，包括完整性检查、SMART 目标验证、内容质量检查、BDD 验收标准检查。

### `--md` 模式

验证通过后保存文件：
- 文件名格式：`PRD-[产品名称]-[YYYYMMDD].md`
- 优先保存到 `docs/` 或 `prd/` 目录，否则保存到当前工作目录
- 保存后报告路径和文件摘要

### `--lark` 模式

验证通过后创建飞书文档：

1. **CRITICAL** -- 确认独立 `lark` 插件（`lark@frad-dotclaude`）已安装；认证检查遵循其 `lark-shared` 技能
2. 遵循 lark 插件的 `lark-doc` 技能了解文档创建指南
3. 遵循 lark 插件 `lark-doc` 技能的 `lark-doc-create.md` reference 了解 `docs +create` 的完整参数和 Lark-flavored Markdown 语法
4. 将 PRD 内容转换为 Lark-flavored Markdown（参照"飞书文档增强"章节）
5. 使用 `lark-cli docs +create` 创建文档：
   ```bash
   lark-cli docs +create --title "PRD-[产品名称]-[YYYYMMDD]" \
     [--folder-token TOKEN_OR_URL | --wiki-node TOKEN_OR_URL | --wiki-space ID_OR_URL] \
     --markdown "<lark-flavored-markdown>"
   ```
6. 对于较长的 PRD，分段创建以提高成功率：
   - 先用 `docs +create` 创建文档（包含前半部分内容）
   - 再用 `docs +update --mode append` 追加剩余章节
7. 如果文档中包含空白画板（`board_tokens` 不为空）：
   - 遵循 lark 插件的 `lark-whiteboard` 技能
   - 为每个画板填充实际内容（流程图、架构图等）
   - 确认所有画板都有实际内容后才算完成
8. 保存后报告文档 URL

## 阶段 5：后续步骤

保存完成后，提示用户后续选项：

- 将 PRD 转化为实施计划和任务拆分
- 进一步细化待解决问题中的设计决策
- 分享给团队评审并收集反馈

## 飞书文档增强

**CRITICAL** -- `--lark` 模式下，生成的 Markdown 内容必须使用 Lark-flavored Markdown 语法，充分利用飞书文档的富文本能力，不要只写纯 Markdown。

### 必须使用的飞书特性

| PRD 章节 | 飞书特性 | 说明 |
|----------|----------|------|
| 项目元数据（版本/日期/负责人） | `<lark-table>` 增强表格 | 首行表头，列宽合理分配 |
| 关键风险/假设/依赖 | `<callout>` 高亮块 | 风险用红色/橙色，假设用蓝色，依赖用黄色 |
| 核心目标/成功指标 | `<callout emoji="..." background-color="light-green">` | 突出关键 OKR 和量化指标 |
| 功能优先级对比（P0/P1/P2） | `<grid cols="3">` 分栏 | 三列并排展示不同优先级 |
| 用户旅程/业务流程 | `<whiteboard type="blank">` 画板 | 用流程图绘制，创建后用 lark-whiteboard 填充 |
| 系统架构/技术方案 | `<whiteboard type="blank">` 画板 | 用架构图绘制，创建后用 lark-whiteboard 填充 |
| 里程碑/时间线 | `<whiteboard type="blank">` 画板 | 用里程碑图绘制 |
| 非目标/范围排除 | `<callout emoji="..." background-color="light-red">` | 红色高亮，明确标注禁止范围 |
| 术语表/缩写对照 | 两列 Markdown 表格 | 简洁的对照表 |
| 决策记录 | `<callout>` + 引用块 | 记录关键决策及理由 |

### 画板使用规则

PRD 涉及以下内容时，主动插入空白画板并后续填充：

- 用户旅程 / 业务流程 -- flowchart
- 系统架构 / 模块关系 -- architecture
- 数据流转 / 状态机 -- flowchart
- 里程碑 / 时间线 -- milestone
- 组织 / 团队分工 -- organization

不适用画板的情况：纯文字描述、数据密集型内容（用表格）、用户明确要求仅文本。

### 格式原则

- 标题层级不超过 4 层
- 章节之间用分割线 `---` 分隔，保持视觉节奏
- 文档开头不要写与 title 重复的一级标题（飞书自动生成）
- callout 不过度使用，加粗只强调核心词
- 使用 `<text color="red">` 等为关键指标或状态着色
- 飞书自动生成目录，无需手动添加

## 质量原则

- **数据驱动**：用具体数据和用户研究支持问题陈述
- **SMART 目标**：具体、可衡量、可实现、相关、有时限
- **简洁清晰**：避免冗长，功能描述足够清晰供开发团队直接实施
- **协作导向**：PRD 是协作工具，语气促进讨论而非命令
- **双受众设计**：PRD 同时服务人类团队和 AI 编码代理

## 支持文件

- `references/prd-interview-questions.md` -- 信息收集提问清单
- `references/prd-validation-checklist.md` -- 验证清单
- `references/prd-template-full.md` -- 完整版模板
- `references/prd-template-brief.md` -- 精简版模板
- `references/prd-template-onepager.md` -- 单页版模板
- `references/prd-best-practices.md` -- 最佳实践指南
- `references/prd-examples.md` -- 高质量 PRD 示例
- 独立 `lark` 插件（`lark@frad-dotclaude`）-- Lark CLI skills（`--lark` 模式）