写作与演讲:把想法说清楚

「写了好几页,别人说看不懂重点。」「汇报时台下玩手机、问结论在哪。」「Q&A 被一个问题问懵,支支吾吾收场。」 架构师既要写清楚(博客、RFC、提案),又要讲清楚(汇报、演讲、即兴与 Q&A)。本章讲结构化写作(结论先行、层次清晰、论据充分)、技术博客 / RFC / 提案的写法、演讲与汇报(听众分析、故事线、幻灯片原则),以及即兴表达与 Q&A 应对

一、结构化写作:结论先行、层次清晰、论据充分

读者时间有限,最怕「看了半天不知道你要说什么」。结论先行:开头就亮出核心观点或建议,再展开理由与细节;这样扫一眼就能抓住重点,愿意往下看的人也有路线图。层次清晰:用标题和小节把信息分层,一段一个意思,避免大段不分段。论据充分:每个关键结论有数据、案例或推理支撑,不堆砌形容词。三者结合:结论像「塔尖」,论据像「塔基」,读者从塔尖到塔基一路顺畅。

Structured writing pyramid 结论 / 建议 (先说) 理由与层次 (再展开) 论据与细节 (数据 / 案例 / 推理) 结论先行 → 层次清晰 → 论据充分
结构化写作金字塔:先结论,再理由,再论据

二、技术博客、RFC 与提案的写法

体裁不同,结构略不同,但都遵循「让人快速抓住要点」的原则。技术博客:标题即结论或问题;开头一段概括「要解决什么问题、得到什么结论」;正文分小节(背景、做法、结果、坑与注意);结尾可总结或给出可复现步骤。RFC / 设计文档:目的、背景、方案(含可选方案对比)、影响与风险、结论与后续;决策点与取舍写清楚,便于评审与日后回溯。提案(如立项、资源申请):要什么、为什么、凭什么(证据与资源)、下一步;结论与「请批准 / 请支持」放在前面,再附详细论证。

技术博客

标题即结论或问题;首段概括问题与结论;正文:背景、做法、结果、坑;结尾总结或步骤。

  • 可读性优先,可配图与代码
RFC / 设计文档

目的、背景、方案(含对比)、影响与风险、结论与后续;决策与取舍写清,便于评审与回溯。

  • 可结合 ADR 格式
提案(立项/申请)

要什么、为什么、凭什么、下一步;结论与「请批准」在前,详细论证在后。

  • 决策者时间少,先给结论
技术博客、RFC、提案的典型结构

三、演讲与汇报:听众分析、故事线、幻灯片原则

汇报和演讲不是「把文档念一遍」。听众分析:他们是谁、关心什么、已有多少背景;决定你讲多深、用什么术语、强调什么利益。故事线:有一条清晰主线(例如「问题 → 方案 → 结果 → 下一步」),每页服务一个点,不堆信息。幻灯片原则:一页一个观点、少字多图、避免大段文字;用标题句概括本页结论,细节口述或留到附录。时间紧时优先保「结论 + 关键论据」,砍掉次要细节。

Presentation design 听众分析 谁 / 关心什么 故事线 问题→方案→结果 幻灯片 一页一观点 Q&A 听众分析 → 故事线 → 少字多图 → 留时间 Q&A
演讲与汇报:听众分析 → 故事线 → 幻灯片原则 → Q&A

幻灯片原则(少字多图、一页一观点)

  • 一页一个观点: 标题句即本页结论,细节口述或放附录。
  • 少字多图: 用图表、示意图替代大段文字;听众听你讲,而不是读屏。
  • 时间紧时: 优先保结论与关键论据,砍次要细节;可准备「附录页」备问。
幻灯片:一页一观点、少字多图

四、即兴表达与 Q&A 应对

即兴时容易啰嗦或跑题,可先用一句结论稳住,再补一两句理由。Q&A:听清问题再答,必要时复述确认;不会的可以说「这块我确认后回复」而非硬编;有分歧的可以对事讨论、不人身攻击。把 Q&A 当成「继续澄清与建立信任」的机会,而不是考场。

好的回答

听清再答、结论先行、简短补理由;不会则说「确认后回复」;对事不对人。

  • 「我的建议是 X,原因是……」
  • 「这个问题我记下,会后给你结论」
Q&A 技巧

复述问题确认理解;分「事实性问题」与「观点性讨论」;控制时间,复杂问题会下跟进。

  • 「您问的是不是……?」再答
  • 避免长篇独白,留时间给更多问题
即兴与 Q&A:结论先行、听清再答、不会则承诺跟进

要点: 写作结论先行、层次清晰、论据充分;博客 / RFC / 提案各有结构但都便于抓要点;汇报先听众分析、故事线、少字多图;即兴与 Q&A 要结论稳住、听清再答、不会则承诺跟进

反例:堆细节不亮结论、汇报念稿、Q&A 硬编。

某份设计文档写了十几页背景与过程,最后才说「建议采用方案 A」,评审人早已失去耐心。某次汇报把每页 PPT 塞满小字,演讲者照念,听众低头看手机。Q&A 时有人问「这个和现有系统的兼容性怎么保证」,主讲人没准备,现场编了一通,被追问细节时露馅。正确做法:文档开头就写「结论与建议」,再展开;汇报用标题句 + 口述,少字多图;不会的问题老实说「我确认后回复」,并记下跟进。写作与演讲的目的是让读者/听众省时间、抓重点、能行动

小结: 结构化写作要结论先行、层次清晰、论据充分;技术博客、RFC、提案各有典型结构,都便于快速抓要点;演讲与汇报依赖听众分析、故事线、幻灯片原则(一页一观点、少字多图);即兴与 Q&A要结论稳住、听清再答、不会则承诺跟进。把想法说清楚,是架构师影响他人的基础。

自检: 最近一篇文档或邮件,第一段有没有直接给出结论或请求?最近一次汇报,有没有「听众是谁、他们最关心什么」的明确假设?若没有,下一篇从「结论/建议」写起;下次汇报前先写一句「听众最需要带走的一句话是什么」。

五、小结

写作与演讲是把想法说清楚的基本功。用结论先行、层次清晰、论据充分写好文档;用听众分析、故事线、少字多图做好汇报;用结论稳住、听清再答、承诺跟进应对即兴与 Q&A。下一章讲持续学习与知识体系构建:在广度与深度之间平衡,构建个人知识图谱与学习策略。