Writing tech article

Writing Tech Articles

一句话准则

技术文章不是聊天记录，也不是资料堆砌。它应该把读者必须记住的判断、模型、边界和行动压缩到最小心智负担。

写作目标

目标	判断标准
高密度	每段都回答一个工程判断，不铺垫、不复述常识
第一性原理	先解释为什么这个问题存在，再给规则
可记忆	关键结论能被一句话、表格或图记住
可复用	读者看完能迁移到下一个项目
可面试	能提炼成 3-5 个可讲的工程观点

标准结构

1. 一句话结论：文章先给判断，不卖关子。
2. 问题模型：用图/表描述概念关系或成本结构。
3. 核心规则：3-7 条，不超过读者工作记忆。
4. 反例 vs 正例：展示错误形态和改法。
5. 落地清单：读者下一次做事时照着检查。
6. 出处：只放支撑关键判断的链接，不堆 bibliography。

信息压缩规则

内容	处理
背景故事	压成 1-2 句，除非影响判断
长段解释	改成表格 / 决策树 / 公式
重复例子	留最能代表差异的 1 个
名词定义	只定义会影响决策的词
业界链接	链接后必须说明它支撑哪条判断
口号	没有操作含义就删

图优先

优先使用这些文本图：

decision tree:  什么情况下选 A / B / C
cost model:      L1 常驻税 → L2 触发税 → L3 按需读
pipeline:        input → route → tool/retrieval → model → state → UI
2x2 matrix:      重要/紧急、稳定/变化、常驻/按需

如果一段话能变成表格或流程图，就不要保留成长段文字。

反模式

反模式	改法
“先介绍一下背景”写 500 字	第一段直接给结论
把调研链接排成清单	每个链接绑定一条判断
同一个观点用 3 种说法重复	留最硬的一句
为了显得完整把边缘内容写进去	放进“非目标”或直接删
用形容词代替证据	写数字、阈值、触发条件
AI 模板句	删"值得注意的是 / 此外 / 更重要的是 / 总而言之"，改成事实连接
口号标题	改成判断、边界或触发条件
空喊"第一性原理"	补成本模型、约束表或可证伪条件；补不出就删
完美三段式节奏	按信息密度重排，不为对称而对称

自检

• 第一屏能看到核心结论吗？
• 是否有至少 1 个图 / 表 / 决策树承载核心模型？
• 每个小节是否都能被一句话标题概括？
• 是否删掉了“懂的人不用看，不懂的人看了也不会做”的段落？
• 关键数字是否有出处或标明是实践阈值？
• 是否有 AI 味标题（"深度解析 / 终极指南 / 核心理念 / 一文搞懂"）？→ 改成具体问题
• 是否每 300 字至少有一个具体例子、阈值、文件名、命令或反例？
• 读者能否带走 3 条可复述观点？