create-prd

PRD 创建

按照以下阶段，将产品创意转化为完整的 PRD 文档。所有 PRD 内容均使用中文编写（目标受众为中文团队）。

输出模式

根据 $ARGUMENTS 确定输出模式：

参数	模式	输出
--md（默认）	本地 Markdown	保存为 .md 文件到项目目录
--lark	飞书云文档	使用 lark-cli 和 Lark 富文本功能创建

--lark 模式接受可选的位置参数（互斥），支持令牌或飞书 URL：

• --folder-token — 目标文件夹（令牌或 URL）
• --wiki-node — 目标知识库节点（令牌或 URL）
• --wiki-space — 目标知识库空间根目录（ID 或 URL，或 my_library）

直接将 URL 传递给 lark-cli，无需手动提取令牌。未指定位置时，默认使用用户的个人空间根目录。

阶段 0：导入上下文

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

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

阶段 1：确定 PRD 类型

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

• 完整型（推荐）：包含所有标准章节，适用于复杂功能
• 简版：仅包含核心章节，适用于小型功能或快速迭代
• 单页版：单页摘要，适用于概念验证和管理层汇报

阶段 2：收集信息

按照 references/prd-interview-questions.md 中的访谈问题逐个提问。等待用户回答后再继续。

• 基本信息（7 项）：所有类型都必须提供
• 完整版附加信息（5 项）：仅完整型需要
• AI Agent 边界：PRD 将由 AI 编码 Agent 使用时需要

如果阶段 0 找到了预填内容，请向用户展示并确认，然后跳过已覆盖的问题。

阶段 3：生成 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 易于使用：

   • 将每项需求写成独立、可验证的条目（优先使用列表而非长段落）
   • 将非目标表述为正向约束
   • 将 P0 功能拆分为 5–15 分钟的 Agent 工作阶段，并设置可测试的检查点
   • 完整版包含三层边界框架：可自主执行 / 需确认 / 禁止

4. 质量要求：

   • 问题陈述应有具体数据或研究作为依据
   • 目标遵循 SMART 原则
   • 成功指标应可量化
   • 避免使用模糊措辞（“大约”“也许”“尝试”）
   • 使用主动语态和具体动词

5. 格式：

   • --md 模式：使用标准 Markdown，并清晰设置标题层级
   • --lark 模式：使用 Lark 风格的 Markdown（参见飞书增强功能章节）

阶段 4：验证并保存

根据 references/prd-validation-checklist.md 进行验证，检查完整性、SMART 目标、内容质量和 BDD 验收标准。

--md 模式

验证后保存文件：

• 文件名：PRD-[ProductName]-[YYYYMMDD].md
• 优先保存到 docs/ 或 prd/ 目录，否则保存到当前工作目录
• 报告文件路径和摘要

--lark 模式

验证后创建飞书文档：

1. CRITICAL — 确认已安装独立的 lark 插件（lark@frad-dotclaude）；按照其 lark-shared 技能进行身份验证
2. 按照 lark 插件的 lark-doc 技能了解文档创建指南
3. 参阅 lark-doc-create.md，了解完整的 docs +create 参数和 Lark 风格 Markdown 语法
4. 将 PRD 内容转换为 Lark 风格 Markdown（参见「飞书增强功能」部分）
5. 创建文档：

   lark-cli docs +create --title "PRD-[ProductName]-[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 模式下，使用 Lark 风格 Markdown 语法，充分利用飞书的富文本功能。

PRD 各章节必需的飞书功能

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> + 引用块	附带依据的关键决策

白板规则

以下内容需插入白板：用户旅程、系统架构、数据流、里程碑、团队组织。纯文本内容、数据密集型内容（使用表格），或用户要求仅提供文本时，无需插入白板。

格式原则

• 最多使用 4 级标题
• 在章节之间使用 --- 分隔线
• 不要添加与标题重复的顶级标题（飞书会自动生成标题）
• 谨慎使用提示框；仅对核心术语加粗
• 使用 <text color="red"> 标记关键指标或状态
• 飞书会自动生成目录，无需手动添加

质量原则

• 数据驱动：用具体数据和用户研究支撑问题陈述
• SMART 目标：具体、可衡量、可实现、相关且有时限
• 简洁明了：避免冗长；描述应清晰到开发团队可以直接实施
• 以协作为导向：PRD 是协作工具；语气应促进讨论，而非发号施令
• 面向双重受众设计：同时服务于人工团队和 AI 编码 Agent

配套文件

• 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 技能（--lark 模式）