# 如何写成就文档

> 什么是成就文档，为什么每个开发者和 staff 工程师都应该有一份，如何写你自己的，以及 Zebra 如何每周帮你填写。

URL: https://dailyzebra.com/zh/brag-document/

一份持续更新的清单，记录你做了什么、为什么重要，由你自己维护，为你自己所用。

## 它是什么

成就文档是一份单独的文档，你在工作发生时就把它记下来：你交付了什么，帮谁解除了阻碍，推动了哪些决策，学到了什么。Julia Evans 在 [她关于成就文档的文章](https://jvns.ca/blog/brag-documents/) 中让这个想法流行起来，如今它已成为各级工程师的标准建议。

## 为什么你应该写一份

六个月的工作装不进你的记忆。到了绩效评估或准备晋升材料的时候，你只记得最近几周和那一次大发布，其余的都忘了。

你的经理看到的更少。高级和 staff 级工作的很大一部分从不出现在冲刺看板上：帮另一个团队解除阻碍的代码评审、你在深夜处理完的事故、避免了一次重写的设计文档。你不写下来，就没人会写。

它也对你自己有帮助。读一个月的记录，就能看出你的时间实际花在了哪里，以及是否花在了你想要的地方。

## 如何写你的成就文档

- **一份文档，最新的放在最前面。** 笔记应用里的一个页面就够了。按月或按季度给记录分组。
- **从你的目标开始。** 在顶部写两三行，说明你这个周期的目标，这样每条记录都可以对照目标来读。
- **每条记录一行。** 日期、你做了什么以及影响。“上线了账单迁移，为三月的发布扫清了障碍”比“做了账单相关工作”好。
- **附上证据。** 附上拉取请求、文档、讨论串或仪表盘的链接。六个月后，正是链接让这一行可信。
- **写下看不见的工作。** 帮别人解除阻碍的代码评审、指导新人、事故处理、面试，以及你帮忙敲定的决策。
- **每周更新。** 周五下午花十五分钟，趁这一周的事还记得清楚。
- **评估前分享出去。** 在周期结束前几周发给你的经理，让他们可以直接用你的话。

## 模板

```
## 本半年的目标
- 上线账单迁移
- 让平台团队的值班更轻松

## 2026 年 10 月
- 2026-10-17：上线了账单迁移。为三月的发布扫清了障碍。（链接）
- 2026-10-15：评审了 Ana 的重试改动。她的团队得以在冻结前部署。（链接）
- 2026-10-14：把答应 Leo 的事故总结发给了他。复盘在同一周结束。（链接）
```

还需要更多这样的例子？ [按岗位分类的成就文档示例](https://dailyzebra.com/zh/brag-document-examples/)

到了评估周期， [把它整理成你的自我评估](https://dailyzebra.com/zh/self-review/)。

## 一段可以复制的提示

周五把它粘贴到 Claude 或 ChatGPT 中，并连接好你工作所用的工具。

```
帮我更新这一周的成就文档。

1. 看看我这周在 [我工作所用的工具：拉取请求、文档、工单、聊天] 里完成了什么。
2. 按“给别人带来了什么变化”分组：一个上线的功能、一个定下来的决定、一个不再被卡住的人。一组写一行，不管它包含多少项。
3. 每组写一行：日期、我做了什么以及它的影响，最后附上证据链接。
4. 加一小节写看不见的工作：代码评审、指导新人、事故处理和面试。
5. 没完成的不要写。找不到结果的地方，保留这一行并标上（影响？）。
6. 先把这些行给我看，再添加到 [我的成就文档所在的位置]。
```

[在 Claude 中打开](https://claude.ai/new) [在 ChatGPT 中打开](https://chatgpt.com/)

## Zebra 如何帮你填写

成就文档最难的是每周那十五分钟。Zebra 已经有了这些素材，因为你的每一天就是用它们安排的。

每天早上，Zebra 准备你的一天时，首要任务会附带一行理由：它能解除什么阻碍，或者它是为了赶哪个截止日期。Zebra 会保存这一行。每天傍晚，它会保存你在会议和聊天中做出的承诺，以及你当时说的原话。

到了周五，每周总结会在你的任务管理器中核对你完成了哪些首要任务、兑现了哪些承诺，然后你的助手会为每一项在你的成就文档中添加一行，无论它在 Notion、Google Drive 还是你存放笔记的其他地方。没完成的不会写进去，而且每一行你都可以修改。

连接 Zebra，这个周五你的成就文档就开始填写。

[用 Claude 设置](https://dailyzebra.com/zh/claude/) [用 ChatGPT 设置](https://dailyzebra.com/zh/chatgpt/)

## 更多指南

- [如何用 AI 助手规划你的一天](https://dailyzebra.com/zh/plan-your-day/)
- [如何跟踪会议中做出的承诺](https://dailyzebra.com/zh/meeting-promises/)
- [如何根据成就文档写自我评估](https://dailyzebra.com/zh/self-review/)
- [按岗位分类的成就文档示例](https://dailyzebra.com/zh/brag-document-examples/)
