Skill: xx235300/prd-assistant (version 3.0.0)

# PRD-Writer Skill ```json { "name": "prd-writer", "description": "生成结构化产品需求文档（PRD）的技能，基于三阶段工作流 + MoSCoW 优先级结构，支持 Mermaid 图表和五方评审。适用于从零开始撰写PRD、优化已有PRD、或基于需求文档生成完整PRD。", "triggers": [ "写PRD", "做PRD", "生成PRD", "PRD写作", "需求文档", "产品需求文档", "编写需求文档", "prd-writer", "产品文档", "输出PRD", "PRD模板", "起草PRD", "规划PRD", "撰写PRD", "整理PRD", "功能需求", "把需求写成文档", "完善PRD", "优化PRD", "补全PRD", "生成产品文档", "完整PRD", "全面PRD", "图表PRD", "可视化PRD", "快速PRD", "简单PRD", "MVP PRD" ], "templates": { "zh": "PRD模板_中文.md", "en": "PRD模板_英文.md" }, "modules": { "five_party_review": "五方评审/", "chart_templates": "图表模板/", "html_template": "HTML模板/mermaid_template.html" } } ``` --- ## 工作模式概览 本技能通过**三阶段工作流**生成结构化 PRD： | 阶段 | 名称 | 目标 | |------|------|------| | 阶段一 | Context Gathering | 模式选择 + 收集并确认需求信息 | | 阶段二 | Refinement & Structure | 按 PRD 章节结构组织内容，应用 MoSCoW 优先级，生成图表 | | 阶段三 | Reader Testing | 验证可读性，收集反馈，迭代更新 | --- ## 阶段零：模式选择（第一步） > **进入条件**：用户触发 PRD-Writer 技能（通过触发词或直接请求） > **退出条件**：用户确认选择模式，或根据关键词自动推断 ### 主动询问模式 当用户触发技能时，首先提供模式选择说明： ```markdown ## PRD 模式选择 请选择您需要的模式： | 模式 | 说明 | 包含内容 | |------|------|---------| | **完整模式** | 最全面的 PRD | 7维度问询 + 五方评审 + 全部图表 | | **标准模式**（推荐） | 专业标准 PRD | 7维度问询 + 五方评审 + 核心图表 | | **快速模式** | MVP 最小可用 PRD | 3维度问询 + 简化图表 | **五方评审**：包含技术可行性、运营影响、商业价值、法律合规四个维度。 **图表**：会生成 Mermaid 用户旅程图和业务流程图，提供 HTML 附件（双击即看）。 请告诉我您选择哪种模式。 ``` ### 模式推断规则 | 用户输入关键词 | 自动推断模式 | |---------------|-------------| | "完整"、"全面" | 完整模式 | | "写PRD"、"生成PRD"、无关键词 | 标准模式（推荐） | | "快速"、"简单"、"MVP" | 快速模式 | ### 五方评审开关 - **默认**：完整模式和标准模式都包含五方评审 - **关闭**：用户在任何时候说"不需要五方评审"、"跳过评审"即可关闭 - **重新开启**：用户说"加上五方评审"即可重新开启 --- ## 阶段一：Context Gathering（需求收集） > **进入条件**：用户已选择模式（或自动推断） > **退出条件**：用户确认「需求收集清单」，关键信息（P0 功能、目标用户、成功指标）均已收集 ### 识别输入模式 根据用户输入形式判断当前模式： | 模式 | 判断依据 | 初始动作 | |------|---------|---------| | **模式A** | 用户用自然语言描述需求想法，无现成文档 | 直接进入阶段一，逐一提问收集 | | **模式B** | 用户粘贴了一段文字（PRD草稿/需求描述/功能列表） | 先分析内容缺口，再针对性提问 | | **模式C** | 用户提供了飞书文档链接 | 用 `feishu_fetch_doc` 读取，再针对性提问 | ### 收集维度 #### 完整模式 / 标准模式：7维度 | # | 维度 | 对应章节 | 典型问题 | |---|------|---------|---------| | 1 | 项目背景与目标 | 项目概述 | 这个产品解决什么问题？目标是什么？ | | 2 | 目标用户 | 用户分析 | 谁会用这个功能？C端/B端？主要和次要用户？ | | 3 | 核心功能范围 | 需求详述 | 最核心的3个功能是什么？哪些是必须有的？ | | 4 | 优先级判断 | 需求详述 | 哪些是必须有（MUST）？哪些可以放下一版？ | | 5 | 成功指标 | 成功指标 | 希望通过这个功能达成什么可量化的结果？ | | 6 | 验收标准 | 验收标准 | 怎样算「做好了」？关键场景是什么？ | | 7 | 技术约束 | 技术约束 | 有没有技术限制？依赖哪些系统或第三方服务？ | #### 快速模式：3维度 | # | 维度 | 对应章节 | 典型问题 | |---|------|---------|---------| | 1 | 项目背景与目标 | 项目概述 | 这个产品解决什么问题？ | | 2 | 目标用户 | 用户分析 | 谁会用？ | | 3 | 核心功能范围 | 需求详述 | 最核心的功能是什么？ | ### 需求确认清单 阶段一结束时，向用户输出一份确认清单： ```markdown ## ✅ 需求收集清单 请确认以下信息，我将基于此生成 PRD： - **模式**：[完整模式 / 标准模式 / 快速模式] - **项目名称**：[名称] - **项目背景**：[背景描述] - **目标用户**：主要用户… / 次要用户… - **核心功能（P0/Must）**：[功能A]、[功能B]、[功能C] - **次要功能（P1/Should）**：[功能D]、[功能E] - **成功指标**：[指标1] ≤ [目标值]，[指标2] ≥ [目标值] - **五方评审**：[开启 / 已关闭] - **技术约束**：[无特殊限制 / 列明约束] - **文档语言**：[中文 / 英文 / 双语] - **输出方式**：[飞书云文档 + HTML附件 / 其他] 请确认或补充，以上信息将作为 PRD 生成依据。 ``` --- ## 阶段二：Refinement & Structure（完善与结构化） > **进入条件**：阶段一「需求收集清单」已获用户确认 > **退出条件**：PRD 章节已完成生成，P0/P1 章节内容完整 ### PRD 章节生成顺序与优先级 #### 完整模式 / 标准模式：8章节 | 生成顺序 | 章节 | 优先级 | 说明 | |---------|------|--------|------| | 1 | 项目概述 | P0（Must） | 背景、目标、范围边界、价值主张 | | 2 | 用户分析 | P0（Must） | 用户画像、用户旅程图（Mermaid） | | 3 | 需求详述 | P0（Must） | 功能清单（MoSCoW）、功能详述、业务流程图（Mermaid） | | 4 | 成功指标 | P1（Should） | 北极星指标、领先指标、滞后指标 | | 5 | 验收标准 | P1（Should） | Given/When/Then 格式用例 | | 6 | 技术约束 | P2（Could） | 技术栈、集成依赖、安全合规 | | 7 | **五方评审** | P1（Should） | 技术/运营/商业/法务评审（完整/标准模式） | | 8 | 附录 | P2（Could） | 术语表、版本记录、联系人 | #### 快速模式：5章节 | 生成顺序 | 章节 | 优先级 | 说明 | |---------|------|--------|------| | 1 | 项目概述 | P0（Must） | 背景、目标、范围 | | 2 | 用户分析 | P0（Must） | 用户画像、简化用户旅程 | | 3 | 需求详述 | P0（Must） | 核心功能清单（MoSCoW） | | 4 | 成功指标 | P1（Should） | 核心指标 | | 5 | 验收标准 | P1（Should） | 简化 Given/When/Then 用例 | ### Mermaid 图表生成 #### 用户旅程图（第二章） ```mermaid journey title [用户旅程标题] section [阶段1名称] [动作1描述]: [1-5]: [用户/系统] [动作2描述]: [1-5]: [用户/系统] section [阶段2名称] [动作3描述]: [1-5]: [用户/系统] ``` **生成时机**：完整模式、标准模式必生成；快速模式简化处理 #### 业务流程图（第三章） ```mermaid flowchart TD A([开始]) --> B{判断条件} B -->|是| C[处理1] B -->|否| D[处理2] C --> E([结束]) D --> E ``` **生成时机**：完整模式必生成；标准模式生成核心流程；快速模式不生成 ### HTML 附件生成 生成独立的 HTML 文件，内嵌 Mermaid CDN，用户双击即看： ```html <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"></script> <style> body { margin: 20px; font-family: sans-serif; } h1 { color: #333; } h2 { color: #555; margin-top: 30px; } pre.mermaid { display: flex; justify-content: center; margin: 20px 0; } </style> </head> <body> <h1>《[项目名称]》图表附件</h1> <p>打开本文件即可看到渲染后的图表，无需网络。</p> <h2>用户旅程图</h2> <pre class="mermaid"> journey title [用户旅程标题] ... </pre> <h2>业务流程图</h2> <pre class="mermaid"> flowchart TD ... </pre> <script> mermaid.initialize({ startOnLoad: true }); </script> </body> </html> ``` **输出方式**：作为飞书文档附件提供下载，或提供文件路径 --- ## 阶段三：Reader Testing（可读性验证） > **进入条件**：阶段二 PRD 章节已完成 > **退出条件**：用户确认所有章节内容，或完成至少一轮迭代修订 ### 文档结构概览 ```markdown ## PRD 生成完成 **项目名称**：《[项目名称] 产品需求文档 v0.9》 **模式**：[完整模式 / 标准模式 / 快速模式] **文档语言**：[中文 / 英文] **生成时间**：[时间戳] ### 文档结构 - 第一章 项目概述 ✅ 100% - 第二章 用户分析 ✅ 100%（含用户旅程图） - 第三章 需求详述 ✅ 100%（含业务流程图） - 第四章 成功指标 ✅ 100% - 第五章 验收标准 ✅ 100% - 第六章 技术约束 ✅ 100% - [第七章 五方评审] ✅ 100%（完整/标准模式） - [第八章 附录] ✅ 100% ### 附件 - 📊 HTML 图表附件：[文件名.html] ### ⚠️ 待确认事项 1. [具体待确认项 1] 2. [具体待确认项 2] 请确认是否有需要调整的方向，我可以针对性更新指定章节。 ``` --- ## 语言模式 | 模式 | 判断条件 | 模板引用 | 输出语言 | |------|---------|---------|---------| | **中文模式** | 用户使用中文描述需求（默认） | `PRD模板_中文.md` | 中文 | | **英文模式** | 用户使用英文描述需求，或明确要求英文 PRD | `PRD模板_英文.md` | 英文 | | **双语模式** | 用户明确要求「中英文」或「双语」 | 两份模板 | 同时输出中英文 | --- ## 输入模式处理 ### 模式A：用户一句话需求 → 从零生成完整 PRD **典型对话**： ``` 用户：我想做一个用户反馈系统 AI：[识别为模式A，询问模式选择] 我需要了解一些信息来帮你生成完整的 PRD： 1. **目标用户**：这个系统给谁用？（C端用户提交反馈？客服处理反馈？两者都要？） 2. **核心目标**：希望通过这个系统达成什么？（提高处理效率？收集更多反馈？） 3. **范围边界**：有没有时间或技术限制？（几周上线？用现有技术栈？） 请告诉我，我会基于这些信息生成完整的 PRD。 ``` ### 模式B：用户粘贴待优化 PRD → 分析缺口并完善 ``` 用户：[粘贴了一段300字的需求描述] AI：[分析内容后，识别缺口] 我看到了您的需求描述，核心功能已清晰。 以下章节需要补充： ... ``` ### 模式C：用户提供飞书文档链接 ``` 用户：[粘贴了飞书文档链接] AI：[使用 feishu_fetch_doc 读取文档内容] 我已读取您的文档，以下是需求分析： ... ``` --- ## 附录：五方评审模块说明 ### 评审维度 | 评审方 | 关注点 | 评审问题示例 | |--------|--------|-------------| | 技术 | 可行性、复杂度、风险 | 这个功能技术实现难度如何？需要多久？有什么技术风险？ | | 运营 | 成本、人力、上线计划 | 上线后运营成本多少？需要多少人维护？ | | 设计 | UX、一致性、影响 | 对现有交互有什么影响？需要改哪些页面？ | | 商业 | ROI、竞品、价值 | 投入产出比如何？比竞品强在哪里？ | | 法务 | 合规、隐私、安全 | 涉及用户数据吗？合规吗？需要用户同意吗？ | ### 五方评审触发 - **完整模式**：默认包含全部五方评审 - **标准模式**：默认包含全部五方评审（可关闭） - **快速模式**：不包含 ### 关闭五方评审 用户说以下任意一句即可关闭： - "不需要五方评审" - "跳过评审" - "简单点"

path: 图表模板/用户旅程图.md
content: # 用户旅程图 Mermaid 模板

> 本模板用于生成 Mermaid 用户旅程图。

---

## 基础语法

```mermaid
journey
  title [旅程标题]
  section [阶段1名称]
    [动作1描述]: [评分1-5]: [执行者]
    [动作2描述]: [评分1-5]: [执行者]
  section [阶段2名称]
    [动作3描述]: [评分1-5]: [执行者]
    [动作4描述]: [评分1-5]: [执行者]
```

---

## 参数说明

| 参数 | 说明 | 示例 |
|------|------|------|
| title | 旅程标题，显示在图表上方 | 用户反馈提交流程 |
| section | 一个阶段/步骤组 | 发现问题、提交反馈、等待处理 |
| 动作描述 | 用户在该阶段的具体行为 | 填写反馈表单、点击提交按钮 |
| 评分 1-5 | 用户满意度，1最低5最高 | 5 表示非常满意 |
| 执行者 | 用户或系统 | 用户、客服、系统 |

---

## 示例：用户反馈流程

```mermaid
journey
  title 用户反馈提交流程
  section 发现问题
    用户发现功能异常: 2: 用户
    用户寻找反馈入口: 3: 用户
  section 提交反馈
    用户打开反馈表单: 4: 用户
    用户填写问题描述: 4: 用户
    用户上传截图: 3: 用户
    用户点击提交: 5: 用户
  section 等待处理
    系统发送确认通知: 5: 系统
    客服查看反馈: 3: 客服
    客服处理反馈: 4: 客服
  section 接收结果
    用户收到处理通知: 5: 系统
    用户评价处理结果: 4: 用户
```

---

## 设计规范

### 评分规则

| 评分 | 含义 | 适用场景 |
|------|------|---------|
| 1 | 非常不满意 | 遇到严重障碍，无法完成任务 |
| 2 | 不满意 | 体验很差，有明显痛点 |
| 3 | 一般 | 可以完成任务，但有不便 |
| 4 | 满意 | 体验较好，完成顺利 |
| 5 | 非常满意 | 体验极佳，超出预期 |

### Section 划分建议

- 每个用户旅程建议 3-6 个 section
- 每个 section 包含 2-4 个动作
- Section 按时间顺序排列

---

## 快速生成模板

当收集到用户旅程信息后，可直接替换以下模板：

```mermaid
journey
  title [项目名称] - 用户旅程
  section [阶段1]
    [动作1]: [评分]: [执行者]
    [动作2]: [评分]: [执行者]
  section [阶段2]
    [动作3]: [评分]: [执行者]
    [动作4]: [评分]: [执行者]
  section [阶段3]
    [动作5]: [评分]: [执行者]
```


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)