#周报为什么总是写得像流水账
我见过的大部分周报长这样:
本周完成了 A 需求的开发,修复了 B 模块的若干 bug,参与了 C 方案的评审,下周继续推进 A 需求。
这段文字的问题不在于短,而在于它没有提供任何可用于决策的信息。读的人无法判断:A 需求完成到什么程度?B 模块的 bug 是偶发还是系统性问题?C 方案评审有没有结论?下周的风险在哪?
写的人也很委屈——一整天都在解决问题,到周五下午只剩半小时,能想起的只有「做了 A」。
所以问题不在写作能力,而在记录的时机。周五回忆一周,等于用 30 分钟重建 40 小时,必然只能捞出最表层的记忆。
#核心思路:把周报拆成「每天 3 分钟」
我的做法是把周报的产出过程拆散到每一天,周五只做组装。
每天下班前,往一个固定文件里追加一条:
## 2026-09-11 周四
- 完成:订单聚合接口压测,5 万条 P99 从 900ms 降到 540ms
- 定位到 v8 隐藏类问题,字段赋值顺序不一致导致多态
- 结论:新建对象时字段一次写全,避免 delete
- 进行中:灰度方案评审材料(差一个回滚预案)
- 阻塞:需要 DBA 确认新索引在大表上的锁表时间
三条信息,每条约 20 秒。关键不是写得漂亮,而是当天就写下「结论」两个字后面的那句话。三天后再补,你只会记得「调了性能」,记不住「为什么」。
#周五:二十分钟组装
日记录攒够五天,周五只需要做三件事:合并、提炼、排序。
# 周报 2026-W37(09-08 ~ 09-12)
## 一句话
订单聚合接口性能优化完成,P99 下降 40%,灰度方案待回滚预案确认。
## 结果(可直接验收的)
| 事项 | 状态 | 关键指标 | 链接 |
| --- | --- | --- | --- |
| 聚合接口优化 | 已上线 20% 流量 | P99 900ms → 540ms | PR #4821 |
| 灰度方案 | 待评审 | — | 文档 v3 |
## 判断(这周想清楚了什么)
- 字段赋值顺序会显著影响 V8 的对象访问性能,热路径上对象形状必须固定
- 灰度回滚预案不能等评审时才补,应该在设计阶段就写
## 风险与求助
- 新索引在大表上的锁表时间未确认,若超过 30s 需要改走在线 DDL
- 需要 DBA 排期,最迟下周三
## 下周
- 灰度扩到 100%,观察 48 小时
- 输出一份「热路径对象形状」的团队检查清单
注意结构:结果 → 判断 → 风险 → 下一步。这个顺序不是随便定的。
#为什么是这个顺序
结果放最前,因为大部分人只读前两段。把可验收的东西(状态、指标、链接)放进去,读者扫一眼就能判断要不要细看。
判断单独成段,这是整份周报里唯一属于「你」的部分。代码是需求写的,指标是测试测的,只有「从这件事里想清楚了什么」是别人无法替代的。这一段也是三个月后回看时最有价值的内容。
风险必须显式列出,并且带上时间点和具体诉求。写成「需要关注」等于没写;写成「需要 DBA 排期,最迟下周三」才有人动。
下周放最后,因为它最容易被当成承诺。只写下周真正要做的事,别把愿望清单抄进来。
#一个反直觉的建议:不要追求完整
新手写周报最大的心理障碍是「这周好像没做什么大事」。
事实上,一周里真正值得写进「结果」的事情通常只有 1 到 3 件。剩下的时间消耗在会议、沟通、排查、等待——这些不是没价值,而是不适合放在结果里。
它们适合放在「判断」里:
- 这个需求的评审开了三次,根本原因是验收标准在第一次会上没有定死
- 跨团队对齐的成本主要来自术语不一致,不是排期冲突
这类观察比「参与了三次评审」有用一百倍,而且它恰好是流水账里被丢掉的东西。
#工具:越简单越好
我试过 Notion、语雀、飞书文档,最后回到了一个本地 Markdown 文件加 Git。
weekly/
├── 2026-W35.md
├── 2026-W36.md
└── 2026-W37.md
理由是周报的价值在长期。三个月后想查「上次那个锁表问题怎么解决的」,本地文件的全文搜索比任何在线工具都快。而且它和代码放在同一个目录下,不用切换上下文。
如果你需要发给别人,把 Markdown 粘到公司文档里就行——格式本来就通用。
#半年后回看会发生什么
我坚持了大约八个月,最明显的三个变化:
- 述职和晋升材料不用现编。 半年的周报就是素材库,指标、结论、风险应对全在里面;
- 对「时间去哪了」有了实感。 连续几周的「风险」段落里反复出现同一个依赖方,那就是真正的问题所在;
- 写文档的速度变快了。 因为每周都在练习「一句话说清结论」,写方案时的第一段不再卡壳。
第三条是意外收获。周报表面上是汇报,实际上是一次每周一次的高强度压缩训练——把 40 小时的混沌压成 200 字,这个能力在任何岗位都用得上。
#从下周一开始
不需要新工具,不需要模板库。只需要做一件事:
今天下班前,写下三行:完成了什么、卡在哪、想清楚了什么。
坚持两周,你就会发现周五的组装变得毫不费力。周报从「负担」变成「顺手整理的副产品」,这个转变发生的时刻,就是你真正开始积累的时刻。