写作与演讲:把想法说清楚
一、结构化写作:结论先行、层次清晰、论据充分
读者时间有限,最怕「看了半天不知道你要说什么」。结论先行:开头就亮出核心观点或建议,再展开理由与细节;这样扫一眼就能抓住重点,愿意往下看的人也有路线图。层次清晰:用标题和小节把信息分层,一段一个意思,避免大段不分段。论据充分:每个关键结论有数据、案例或推理支撑,不堆砌形容词。三者结合:结论像「塔尖」,论据像「塔基」,读者从塔尖到塔基一路顺畅。
二、技术博客、RFC 与提案的写法
体裁不同,结构略不同,但都遵循「让人快速抓住要点」的原则。技术博客:标题即结论或问题;开头一段概括「要解决什么问题、得到什么结论」;正文分小节(背景、做法、结果、坑与注意);结尾可总结或给出可复现步骤。RFC / 设计文档:目的、背景、方案(含可选方案对比)、影响与风险、结论与后续;决策点与取舍写清楚,便于评审与日后回溯。提案(如立项、资源申请):要什么、为什么、凭什么(证据与资源)、下一步;结论与「请批准 / 请支持」放在前面,再附详细论证。
标题即结论或问题;首段概括问题与结论;正文:背景、做法、结果、坑;结尾总结或步骤。
- 可读性优先,可配图与代码
目的、背景、方案(含对比)、影响与风险、结论与后续;决策与取舍写清,便于评审与回溯。
- 可结合 ADR 格式
要什么、为什么、凭什么、下一步;结论与「请批准」在前,详细论证在后。
- 决策者时间少,先给结论
三、演讲与汇报:听众分析、故事线、幻灯片原则
汇报和演讲不是「把文档念一遍」。听众分析:他们是谁、关心什么、已有多少背景;决定你讲多深、用什么术语、强调什么利益。故事线:有一条清晰主线(例如「问题 → 方案 → 结果 → 下一步」),每页服务一个点,不堆信息。幻灯片原则:一页一个观点、少字多图、避免大段文字;用标题句概括本页结论,细节口述或留到附录。时间紧时优先保「结论 + 关键论据」,砍掉次要细节。
四、即兴表达与 Q&A 应对
即兴时容易啰嗦或跑题,可先用一句结论稳住,再补一两句理由。Q&A:听清问题再答,必要时复述确认;不会的可以说「这块我确认后回复」而非硬编;有分歧的可以对事讨论、不人身攻击。把 Q&A 当成「继续澄清与建立信任」的机会,而不是考场。
听清再答、结论先行、简短补理由;不会则说「确认后回复」;对事不对人。
- 「我的建议是 X,原因是……」
- 「这个问题我记下,会后给你结论」
复述问题确认理解;分「事实性问题」与「观点性讨论」;控制时间,复杂问题会下跟进。
- 「您问的是不是……?」再答
- 避免长篇独白,留时间给更多问题
要点: 写作结论先行、层次清晰、论据充分;博客 / RFC / 提案各有结构但都便于抓要点;汇报先听众分析、故事线、少字多图;即兴与 Q&A 要结论稳住、听清再答、不会则承诺跟进。
反例:堆细节不亮结论、汇报念稿、Q&A 硬编。
某份设计文档写了十几页背景与过程,最后才说「建议采用方案 A」,评审人早已失去耐心。某次汇报把每页 PPT 塞满小字,演讲者照念,听众低头看手机。Q&A 时有人问「这个和现有系统的兼容性怎么保证」,主讲人没准备,现场编了一通,被追问细节时露馅。正确做法:文档开头就写「结论与建议」,再展开;汇报用标题句 + 口述,少字多图;不会的问题老实说「我确认后回复」,并记下跟进。写作与演讲的目的是让读者/听众省时间、抓重点、能行动。
小结: 结构化写作要结论先行、层次清晰、论据充分;技术博客、RFC、提案各有典型结构,都便于快速抓要点;演讲与汇报依赖听众分析、故事线、幻灯片原则(一页一观点、少字多图);即兴与 Q&A要结论稳住、听清再答、不会则承诺跟进。把想法说清楚,是架构师影响他人的基础。
五、小结
写作与演讲是把想法说清楚的基本功。用结论先行、层次清晰、论据充分写好文档;用听众分析、故事线、少字多图做好汇报;用结论稳住、听清再答、承诺跟进应对即兴与 Q&A。下一章讲持续学习与知识体系构建:在广度与深度之间平衡,构建个人知识图谱与学习策略。