本文介绍前谷歌工程师Michael Lynch的设计文档写作指南，核心是判断力：何时写、写多细、写什么。判断信号包括多人协作、周期超三月、长期运行、跨团队、需求模糊、灾难风险。文档分五类：项目定位、需求边界、技术方案、风险合规、协作留痕。关键是聚焦高代价决策，确保文档可独立阅读，推动评审而非争论。AI时代，工程师仍需掌握此能力。