← ClaudeAtlas

prd-writing-stylelisted

专门撰写 PRD 类需求文档——单个功能的 PRD、模块总览、需求文档导航页、功能变更说明,用于校准读者/深度/语体,写出研发看得懂、可执行的需求。用户要求“写 PRD”“写需求文档”“总结这个模块”“润色 PRD”,或反馈“太口语化”“这是需求文档吧”“看不出重点”“给不懂的人看”时都应触发。注意:产品级文档(规划一个大产品或一个产品的整体形态、产品概述、产品���构图)不属于本技能,用 product-doc-standard。
skyhahalife-11/pm-skill-pack · ★ 0 · AI & Automation · score 67
Install: claude install-skill skyhahalife-11/pm-skill-pack
# PRD / 产品文档写作规范 > 这份规范是从真实的多轮修改中总结出来的——记录的是“改过、被认可”的写法,不是凭空定的规则。写文档前先对照这份规范校准,能明显减少来回改的次数。这份文件合并了原来两份独立技能(`prd-writing-style` 与 `writing-product-documents`),因为两者解决的是同一件事,分开维护反而容易漏看某一半。 ## 1. 动笔前先校准三个独立维度 写产品文档最容易踩的坑不是“写得不够好”,而是反复写错方向——每次改完,用户还要再纠正一次,而且纠正的往往不是同一个维度。真实教训:同一份“模块总览”文档改了五版,用户前后提了四次不同方向的反馈,事后复盘发现根源是没有在动笔前把几个独立的维度一次性问清楚,导致每次只能根据上一句反馈做局部修正,还经常改错维度——用户反馈的是 A 问题,实际去修的是 B。 写之前,先在心里(或者直接问用户)把这三件事分开确认,它们是正交的,改一个不代表另外两个也该跟着变: 1. **读者是谁**:完全没背景的新人/跨部门同事?本模块的开发同学?还是决策层?读者决定了要不要解释术语、要不要先讲产品背景。 2. **内容深度**:这是一份让人“建立整体理解”的导航总览,还是要落到交互细节、字段清单、验收标准的规格文档?总览类文档应该让读者读完能复述“这个模块解决什么问题、由哪几块组成、边界在哪”,但不需要精确到每个按钮怎么点。 3. **语体(register)**:无论读者背景如何、内容深度如何,专业产品文档的语言应该是**书面、精确、陈述式**的,这一条对任何读者都成立——**“对新人友好”从来不等于“语言可以口语化”**。这是最容易踩的坑,第 7 节单独展开。 **最容易搞混的一对:内容可及性 ≠ 语言口语化**。用户说“要讲给完全不懂的人听”,很容易理解成“语言要亲切、要打比方、要像聊天一样讲故事”。但正确做法是让内容本身承担“讲清楚”的责任——补背景章节、解释术语、用“问题—解决思路”的结构替代直接罗列功能、给每块功能加上“负责什么/不负责什么”的边界说明;而不是让语言变得随意来承担这个责任——不用比喻和类比句、不用口语助词和感叹句、不写故事化的举例场景。判断标准:读一遍自己写的段落,如果读起来像“在跟人聊天解释”,是语言维度出了问题,跟内容深度无关;如果读者读完仍不知道这个模块解决什么问题、边界在哪,是内容/结构维度的问题,跟语言口语与否无关。 **减少来回次数的做法**:与其等用户一条条纠正,不如在拿到“写个产品文档”这类要求、且读者/深度/语体三者有任何一个不明确时,主动用一次提问把它们一起问清楚,例如:这份文档主要给谁看(完全没背景的新人 / 内部同学 / 决策层)?是要一份能建立整体理解的导航总览,还是要落到实现细节的规格文档?语言风格上有没有参照物(比如同类型的其他产品文档),还是希望按标准产品经理写作规范来?如果用户已经明确说过“随便你判断”,或者场景明显(已有同类文档可以对齐格式),可以不问,直接按默认模板走。 ## 2. 动笔前先在心里把完整流程走一遍,信息不全就先问 第 1 节校准的是“怎么写”(读者/深度/语体),这一节要校准的是更基础的前提:动笔之前,先确认自己是不是已经把这个功能的完整流程实际想清楚了,而不是只想清楚了正在被要求写的那一小块。 真实教训:设计“加入空间”这个功能时,只想清楚了申请人这一侧的流程——搜索空间、点击申请、按钮变成“审批中”——却完全没想到审批人那一侧:审批人在哪里看到这条申请、通过什么