PRD Writer · 使用说明
=====================

这是一个 AI Skill，帮你把零散的需求讨论、数据分析、归因结论整理成结构化的 PRD 初稿。
从"数据不太好/想优化点什么"这种模糊想法开始就能用，不需要你先想清楚方案。

---

## 安装方式

### 方式一：WorkBuddy 桌面客户端
1. 打开 WorkBuddy，进入 设置 → Skills
2. 点添加，选择 prd-writer-1.5 文件夹或对应的 .skill 文件导入
3. 导入成功后，在 Skills 列表里能看到 "prd-writer"，就装好了

### 方式二：Claude 桌面客户端 / claude.ai 网页版
1. 打开 Claude，进入 设置(Settings) → Skills
2. 点右上角 Add
3. 选择对应的 .skill 文件导入

### 方式三：Claude Code（命令行/IDE 插件）
1. 解压 .skill 文件（本质是 zip）
2. 把解压出来的 prd-writer-1.5 文件夹整个复制到：
   ~/.claude/skills/
3. 建议把文件夹改名成 prd-writer（不改名也能用，改了更清爽）
4. 重新打开一个对话即可，无需额外配置

---

## 怎么用

装好之后，正常跟 AI 聊你的需求就行，不用记什么特殊指令。比如：
- "帮我写个PRD，关于XX功能"
- "这个按钮点击率降了，想优化一下"
- "把这些讨论整理成需求文档"
- "这个数据好像有点问题"

AI 会自动判断这次该用诊断型 / 方案型 / 轻量修复型 / 提案型哪种结构（提案型对应"领导交办的活/自己冒出的点子，还没定方案"这种情况），主动问你缺的信息，
方案定下来之后会先给你一份提纲确认，你觉得没问题了它才会写正文，不会一上来就编一整篇。
涉及页面/组件变化时会主动问你要不要看示意图、看哪种，涉及多步业务判断时会主动画流程图，
确认信息架构没问题再往下走。

**快速上手**：装好后直接说"帮我写个PRD"或"XX数据不太好想优化一下"就行。AI 会分批问你缺的信息，你按提示回答即可，不需要记任何特殊指令。

---

## 推荐模型

这个 skill 的完整流程涉及多轮判断、分批提问、图表生成，对模型的指令遵循能力有一定要求：
- **推荐**：Claude Sonnet 5 及以上 / GPT-5 及以上，或同等能力水平的当前旗舰模型
- **能用但可能跳步**：能力较弱的模型可能会跳过部分判断步骤或分批提问逻辑，产出质量有所下降但不影响基本使用
- **不推荐**：小参数模型（7B 以下），指令遵循能力不足以支撑完整流程

---

## 知识库配置（可选）

打开 SKILL.md 文件，找到"知识库配置"部分，把 `知识库地址：[未配置]` 换成你存放历史需求文档的地方（本地文件夹路径、Obsidian vault 路径、飞书/Notion/腾讯文档链接等），保存后重新导入。

配置好之后，AI 每次收到新需求会自动先去这个地址搜近 6 个月的相关历史资料，搜到的内容会在后续步骤里直接用上，不用你每次都发。

- 不配置也完全能用——每次 AI 会现场问你要不要提供背景资料、想怎么给（直接发/给路径/给链接），不会自动去搜
- 配置的是在线文档链接时，需要你的环境装了对应平台的连接器（如飞书/Notion/腾讯文档 MCP）才能自动读取；没有的话 AI 会如实告诉你打不开，让你手动复制内容过去
- 这一行是写在文件里的静态配置，AI 不会在对话里自己回写它——想换地址，需要你自己再编辑一次文件

---

## 示意图功能（线框图 / mockup / 流程图）

当需求涉及页面/组件变化时，AI 会在提纲阶段问清楚三个选项：
- 低保真线框图（先对齐结构，省时间，返工成本低）
- 接近真实效果的图（更接近最终样子，技术设计能直接照着理解）
- 不看图，直接写文档

选了"接近真实效果"，AI 会一次性把参考来源问清楚（老功能要现状截图、新页面要同类参考图、
都没有就问你口述或按经验画），不会一层层慢慢问。确认过的图会用**彩色描边 + 变更类型角标**
标出这次改了哪些元素，配合需求描述里的元素名称对应，不再用①②③这种容易在改稿时错位的编号。
弹窗、气泡这类悬浮组件会连同它所在的完整背景页面一起画出来，方便判断遮挡关系。

涉及多步业务判断时会画判断流程图，和上面的示意图是不同的东西，分别检查"页面长什么样"和
"逻辑走没走对"。
- 如果你的客户端支持可视化工具（如 WorkBuddy），会直接渲染成可看的示意图
- 如果不支持，会退化为文字+ASCII框线图
- 图上只放UI真实会显示的文字，不会夹带"信息架构确认稿"这类注解——这类说明放在AI发图时的对话文字里

---

## 重要提醒

- 这个 skill 需要你已经有 AI 客户端（WorkBuddy / Claude / Claude Code）的正常使用权限才能跑起来
- 拿到的是一份配置文件，不是独立的软件或小程序，不能脱离 AI 客户端单独使用
- 生成 Word 文档时，标注为"待确认草案"的数字/阈值（比如 AB 测试红线这类借鉴同类项目、未经验证的经验值）会用红色字体标出，提醒你确认后改回黑色，不要直接当结论采信

## 1.5 相比上一版的主要变化

- 新增 `references/faq.md`：把散落在各文件里的风险提示和真实踩过的坑，按主题（不编造边界判断/画图踩过的坑/交付前扫描/提问节奏/目标数据认知偏差）集中整理成速查表
- 新增 `references/full-sample-diagnostic.md`：诊断型完整成稿样例（七段骨架全覆盖），配合原有的分段案例一起看——分段案例教单段怎么写，这份教整篇怎么衔接、篇幅比例怎么分配
- 方案评估清单的"风险"维度补全：诊断型/方案型需求现在也会主动检查"是否依赖其他团队还没ready的能力、会不会跟其他需求抢资源"，之前这条只有提案型的可行性判断会查
- 修复一个真实踩过的坑：需求描述表格里的示意图，必须真正插进对应模块那一行的单元格，不能写"见下方示意图"把图片整块甩到表格外面——这类占位文字看起来图文对上了，实际已经脱节

## 1.4 相比上一版的主要变化

- 新增第四种结构形态"提案型"：起点不是数据问题也不是已定方案，而是"别人交办的活/自己冒出的新点子"，连要不要做都没判断过
- 提案型在方案讨论前新增一个前置子步骤"可行性判断"（先看目的清不清楚，再看能否达成预期目的、和当前优先级的匹配度、成本、有没有更简单/更有效的替代方案、紧急度、风险依赖）——结果仅供参考，不会因为判断"优先级不高"就拦着不让你继续，你决定要做就照样往下走完整流程
- 第3步新增"提案来源批"：问清楚谁提的/原始诉求/期望目的/已知约束，作为可行性判断的信息基础

## v3 相比上一版的主要变化（基于原型图/示意图实际使用中的反馈）

- 线框图触发问法从"要不要画"改成三选一（低保真/接近真实效果/不看图），并列出两种图各自的优势帮你判断
- 参考来源从阶梯式追问（先问截图、没有再问参考图……）改成按场景一次性问清楚，减少来回反复
- 图文对应方式从数字编号①②③改成"彩色描边 + 变更类型角标 + 元素名称对应"——编号在评审改稿时容易连图带表格错位，新方式改需求条数、顺序都不影响图
- 新增规则：弹窗、气泡等悬浮组件必须和它所在的完整背景页面同框画出，不能只画组件本身；一闪即逝的 toast 提示例外，不需要画图
- 需求描述新增"按元素/维度拆小标题"规则：一个模块涉及多个元素或维度时，先加粗分组再编号，不再打平成一条编号到底
- 新增"渲染后自查"里的截图合成对准检查，避免在真实截图上标注时框歪、框到相邻元素
