PRD 撰写

问题：脑暴和原型有了，文档却难对齐研发

很多团队在需求阶段已经做过脑暴、甚至有了线框原型，但落到 PRD 时仍容易出现结构松散、页面边界不清、验收标准写不出来等问题。研发读文档时还要反复追问「这个字段必填吗」「失败怎么办」「算不算做完」——本质是 业务意图 没有按可交付、可测试的方式写清楚。

技能如何工作

prd-writer 面向「写 PRD / 出需求文档 / 结合原型整理成文档」这类诉求，默认把产出组织成可粘贴到飞书、Confluence、Notion 的 Markdown；需要 Word 时可再衔接 docx 类技能。

核心写作约定是 按页面/模块分层：

• 功能需求 以页面维度逐级拆节，大页面可在二级下再按区域（如搜索区、列表区）细分
• 每节固定骨架：功能描述、原型截图（同级 assets/）、字段说明表（名/类型/必填/校验）、交互逻辑、异常与边界、验收标准（Given/When/Then 表格，便于直接变测试用例）
• 状态与流程用 mermaid（stateDiagram-v2、flowchart）；列表页分页默认每页 10 条，支持 10/20/50/100

执行上大致四步：收集脑暴结论、原型与业务背景 → 按模板逐页展开并贴图 → 输出 Markdown（或 Word）→ 自查背景/边界、验收与异常是否齐全。

边界与注意点

PRD 只写 业务意图、业务规则、验收标准，不写 API、数据模型、库表、技术选型或部署方案——那些留给研发阶段推导。需求含糊时，技能倾向 先写清假设并标注，而不是停笔等补材料；截图命名建议 [模块]-[页面]-[说明].png，宽度与体积按规范控制，避免协作工具里排版失控。