engineering-weekly-report

工程周报

生成一份每周工程状态报告，供团队发送给利益相关方、工程经理和团队成员。报告格式每周保持一致，让读者清楚知道该看哪里——顶部是交付进展，中间是决策，底部是风险和后续步骤。报告应能在 2 分钟内读完。避免大段文字：使用项目符号、状态标签和简短表格。如果未提供指标数据，请在指标部分标注 [data needed]，不要编造数字。

必需信息

如果尚未提供，请询问以下信息：

• 团队名称和报告周期 — 团队名称，以及周数或日期范围（例如：“平台团队，第 21 周，5 月 12 日至 16 日”）
• 本周已交付的工作项 — 已完成并发布或合并的内容
• 正在进行的工作项 — 正在积极推进的内容，如已知则提供大致完成百分比
• 受阻事项 — 受阻的内容、阻碍事项的负责人，以及解除阻碍所需的信息或资源
• 已做出的关键决策 — 本周做出的架构、流程或优先级决策
• 下周需要做出的决策 — 近期需要做出的决策，以及决策负责人
• 风险和升级事项 — 任何可能影响下周承诺或需要领导层关注的事项
• 下周的首要优先事项 — 团队计划下周完成的 3–5 件事

可选但有帮助的信息：

• 关键指标 — 可靠性（错误率、p99 延迟）、速度（完成的故事点）或其他健康状况指标
• 团队健康状况说明 — 值班休假、新成员加入、人员流失，或值得注意的士气信号
• 迭代或冲刺编号 — 如果团队采用冲刺

输出格式

---

工程周报 — [团队名称]

周次： [周数] | [日期范围，例如：2025 年 5 月 12 日至 16 日] 作者： [姓名或团队负责人] 分发对象： [例如：工程领导层、产品团队、团队成员]

---

交付进展

本周已交付

项目	描述	影响
[功能 / 修复 / 基础设施变更]	[一句话描述]	[受益对象 / 解除的阻碍]
[功能 / 修复 / 基础设施变更]	[一句话描述]	[受益对象 / 解除的阻碍]
[功能 / 修复 / 基础设施变更]	[一句话描述]	[受益对象 / 解除的阻碍]

正在进行

项目	负责人	状态	目标交付时间
[工作项]	[姓名]	[约 40% / 按计划进行 / 有风险]	[日期或冲刺]
[工作项]	[姓名]	[约 70% / 按计划进行 / 有风险]	[日期或冲刺]
[工作项]	[姓名]	[约 20% / 按计划进行 / 有风险]	[日期或冲刺]

受阻事项

项目	受阻开始时间	阻碍说明	负责人	解除阻碍所需事项
[工作项]	[日期]	[阻碍进展的因素]	[姓名]	[具体需求——决策、资源、依赖项]

如果没有受阻事项：目前没有受阻事项。

---

关键指标

指标截至 [日期]。括号内为上周数据。

指标	本周	上周	趋势	目标
错误率（5xx）	[X%]	[X%]	[↑ / ↓ / →]	< [阈值]
p99 延迟	[Xms]	[Xms]	[↑ / ↓ / →]	< [阈值]
部署频率	[X 次部署]	[X 次部署]	[↑ / ↓ / →]	[目标]
已完成故事点	[X]	[X]	[↑ / ↓ / →]	[冲刺目标]
值班告警量	[X 次告警]	[X 次告警]	[↑ / ↓ / →]	< [阈值]

指标说明： [补充说明数据背景，使数字更有意义，例如：“周二错误率上升与下游依赖服务中断有关，已于当天结束前解决。”]

如果未提供指标：将表格行替换为 [data needed — provide metric values for this section]。

---

决策

本周已做出的决策

决策	理由	负责人	已告知相关方
[决策说明]	[原因 — 用 1 句话说明]	[姓名]	[是 / 否 — 告知了谁]
[决策说明]	[原因 — 用 1 句话说明]	[姓名]	[是 / 否 — 告知了谁]

如果本周没有做出任何决策：本周没有重大决策。

下周需要做出的决策

决策	背景	截止日期	决策负责人
[需要做出的决策]	[为何重要，以及延期会有什么后果]	[日期]	[姓名或角色]

如果没有待定决策：没有待定决策。

---

风险与升级事项

风险	可能性	影响	缓解措施	升级至
[风险说明]	[高/中/低]	[高/中/低]	[我们正在采取的措施]	[需要升级时填写姓名/角色]

本周升级事项： [任何需要领导立即关注的事项——请在此明确指出，不要将其埋在表格行中。如果没有："无。"]

---

团队状况

项目	状态
团队本周产能	[Y 人中有 X 人满负荷]
休假 / 不在办公室	[姓名和日期，或"无"]
新成员加入 / 成员离职	[姓名、角色和日期，或"无"]
本周值班	[姓名]
下周值班	[姓名]

团队备注： [任何值得说明的士气、工作量或团队互动信号——请保持客观且有建设性。如果没有需要说明的内容：省略此行。]

---

下周优先事项

团队下周将交付或实质性推进的 [3–5] 项工作。

1. [优先事项] — [用 1 句话说明完成的标准以及负责人]
2. [优先事项] — [用 1 句话说明完成的标准以及负责人]
3. [优先事项] — [用 1 句话说明完成的标准以及负责人]
4. [优先事项] — [用 1 句话说明完成的标准以及负责人]
5. [优先事项] — [用 1 句话说明完成的标准以及负责人]

产能风险： [如果团队下周产能降低（休假、事件等），请在此注明，以便相关方调整预期。]

---

附录：冲刺计分卡（如适用）

冲刺	承诺完成	已完成	完成率	延续至下个冲刺
冲刺 [N-1]	[X pts]	[X pts]	[X%]	[X pts]
冲刺 [N]（当前）	[X pts]	[X pts — 部分完成]	[X% at midpoint]	待定

---

问题或更正：[Slack 频道或电子邮件] | 下次报告：[日期]

---

质量检查

• 每个受阻事项都注明具体负责人，并明确说明解除阻碍具体需要什么，而不只是"在等 X"
• 待决策表包含截止日期和明确的决策负责人，而不是含糊地写"待定"
• 指标表填写了真实数据，或明确标记为 [data needed]——不得编造指标
• 下周优先事项应描述结果（"交付 X""完成 Y 迁移"），而不是活动（"开展 X 工作"）
• 需要领导关注的升级事项应在"风险"部分明确指出，而不只是埋在表格行中
• 整份报告应能在 2 分钟内读完——如果超过一页打印纸，请精简
• 报告周期（周数和日期范围）应在标题中清晰注明

反模式

• 不要捏造指标——如果没有可用数据，请将字段标记为 [data needed]，而不是估算；利益相关者依据虚构数字做决策会造成实际危害
• 不要把下周的优先事项写成活动（“处理 X”）——必须写成结果（“交付 X”“完成 Y 迁移”），以便利益相关者评估团队是否有所交付
• 不要把升级事项埋在风险表格的某一行中——任何需要领导层关注的事项，都必须在“升级事项”部分明确提出
• 不要在列出受阻事项时遗漏具体负责人和明确的解除阻碍措施——“等待 X”不是受阻事项，而只是占位内容
• 报告不要超过两页打印纸——篇幅过长说明作者没有完成编辑工作，没有判断哪些内容对利益相关者最重要

示例触发语

• “撰写团队动态。”
• “撰写每周工程报告。”
• “撰写冲刺状态邮件。”
• “向利益相关者更新团队本周的情况。”