# 8. 文档和沟通

这一节讲 PRD、评审、周报、异步沟通怎么写才省时间又清楚。写清楚能省下的，是整个团队反复对齐的时间。

---

### 1. 文档开头写「结论和要你做的事」
- 成本：调整结构，几乎为零。
- 说人话：读者最想知道「所以呢、要我做什么」。把结论放最前面，细节放后面，阅读效率会完全不同。
- 收益：换时间精力。读者省下的时间是乘上人数算的。
- 证据等级：C
- 来源：结构化表达方法（《金字塔原理》）、Amazon 六页纸备忘录实践。
- 备注：见第 2 节第 11 条。

### 2. PRD 只写「必须知道」的，其余放附录
- 成本：需要判断力。
- 说人话：一份文档如果什么都有，等于什么都没有。核心逻辑、边界条件、验收标准放正文，边缘细节放附录。
- 收益：换时间精力。
- 证据等级：C
- 来源：文档实践共识。
- 备注：见第 6 节第 1 条。

### 3. 需求评审前先发文档，会上只讨论分歧
- 成本：提前发的习惯。
- 说人话：评审会如果用来逐条念文档，就是在浪费所有人时间。提前发，会上只解决有争议的点。
- 收益：换时间精力。
- 证据等级：C
- 来源：评审实践共识。
- 备注：会前明确标注「需要大家重点看哪几处」。

### 4. 用图代替大段文字描述流程和状态
- 成本：画图的时间。
- 说人话：一段三百字的状态描述，一张状态机图就讲清了。图能大幅降低理解成本和后续争执。
- 收益：换时间精力。
- 证据等级：C
- 来源：工程技术文档实践共识。
- 备注：流程图、状态图、时序图按场景选用。

### 5. 每个需求写清「不做什么」（边界）
- 成本：多写几行。
- 说人话：只说做什么，容易让研发默认多做；把「不做什么」写清，能避免大量后期扯皮。
- 收益：换时间精力。
- 证据等级：C
- 来源：需求文档实践共识。
- 备注：异常流程、空状态、权限边界最需要写清楚。

### 6. 异步沟通优先，减少「随时问我」
- 成本：需要写清楚的习惯。
- 说人话：把问题写成文字，对方能在他方便时处理，还能留下记录。口头问一句，往往要问很多次。
- 收益：换时间精力。
- 证据等级：C
- 来源：异步协作实践共识（如 GitLab 协作手册）。
- 备注：见第 2 节第 2 条。

### 7. 用「谁、做什么、什么时候」收尾每次沟通
- 成本：几乎为零。
- 说人话：讨论很热烈但没有待办的会议，等于没开。用三要素收尾，行动才落得下去。
- 收益：换时间精力 + 换职业寿命。
- 证据等级：C
- 来源：会议与协作实践共识。
- 备注：见第 2 节第 3 条。

### 8. 一份文档一个主题，别把三件事塞进一个文档
- 成本：拆分的时间。
- 说人话：文档混着多个主题，评论和讨论会互相干扰，最后谁也说不清。一个文档只解决一个问题。
- 收益：换时间精力。
- 证据等级：C
- 来源：文档实践共识。
- 备注：拆分后互相链接即可。

### 9. 周报写「结论、风险、需要的支持」
- 成本：比流水账多花不了几分钟。
- 说人话：只报「做了 A、B、C」的周报没有人会认真看。写清结论、风险和需要什么支持，才是有效沟通。
- 收益：换时间精力 + 换钱。
- 证据等级：C
- 来源：团队沟通实践共识。
- 备注：见第 6 节第 5 条。

### 10. 重要的口头结论，事后补一条文字确认
- 成本：几秒钟。
- 说人话：口头达成的共识，过几天就可能各记各的。补一条文字（哪怕是群消息）能避免大量扯皮。
- 收益：换职业自由 + 换时间精力。这是防背锅的低成本动作。
- 证据等级：C
- 来源：职场留痕实践共识。
- 备注：语气要自然，写成「我确认一下，我们刚才定的是……」。

### 11. 写给「不了解背景的人」也能看懂
- 成本：需要一点克制和耐心。
- 说人话：文档的读者可能是三个月后的同事，或者完全不懂这个业务的合作方。用词不依赖内部黑话，别人接手时省下的时间就是你的口碑。
- 收益：换职业寿命。
- 证据等级：C
- 来源：技术写作实践共识。
- 备注：第一次出现的缩写要写全称。

### 12. 用模板减少「从空白开始」的成本
- 成本：一次沉淀，长期复用。
- 说人话：把 PRD、周报、复盘做成模板，每次填空即可，既省时间又保证不漏关键项。
- 收益：换时间精力。
- 证据等级：C
- 来源：知识管理实践共识。
- 备注：模板要定期清理，否则会积累过时项。