# 面向智能体的 Worklog
SUMMARY: 智能体为什么以及如何为每个任务维护工作日志 — 附带可复制粘贴的 prompt 代码块，让这个功能再也不被忽视。

KEY CONTEXT:
Mandatory (Michael #8882/#10509): POST /worklog at EVERY milestone (fix commit, verdict, escalation, handover, takeover, CRITICAL), not only at session end.
One-liner: GET /worklog/push?task_id=<id>&kind=progress&content=<text>&agent=<name>
Details: API reference docs/content/en/api/worklog.md; fleet convention: GET /script/fleet-worklog-tasks-spec.
Prompt block for new agent instances: see section "Initial prompt" on this page.

面向智能体的 Worklog
本文档的存在是因为 Michael 下达了命令（#10509，2026-10-08）："Worklog 功能已经存在好几个星期了。但你们忽视了它。接一个任务，让 Synapse 里的文档和初始 prompt 用 worklog 功能扩展开来，千万别让它被埋没，让每个人都知道。" — 如果你是一个正在阅读本页的智能体，worklog 从此刻起就是你标准配备的一部分。
为什么要 Worklog？
智能体经常死亡：上下文限制、沙盒清空、cron 重启。经常丢失的不是知识（那是  的职责），而是工作历史：这个任务里已经尝试过什么？哪个提交已推送、哪个没有？谁在等谁？Worklog 正是为此而生 — 只增不改、按任务、可查询。新的 run 读取 ，几秒钟内就知道前任停在哪里。
第二个读者是 Michael：worklog 是舰队工作历史的唯一正式来源。没有 worklog 条目，你的工作在舰队全局视图中就正式不存在。
强制规则
push-first，而非 push-last。 每个里程碑一条记录：
- 修复提交已推送
- MR 已创建、裁定已出、合并已完成
- 流水线状态（尤其是带原因的 FAILED）
- 升级、移交、接管
- CRIT/HIGH 发现
- 上下文接缝（上下文结束前一条 ）
一条记录只要一行：
[CODE BLOCK]
kind 类型与使用时机
| kind | 时机 |
| --- | --- |
|  | 任务已认领 — 你接手的证据 |
|  | 每个里程碑（见强制规则） |
|  | 决策、背景、观察 |
|  | 错误，连同你尝试过的方案 |
|  | 阶段/会话完成，趁上下文尚足 |
|  | 任务完成 — 最后一条，状态变为  |
初始 Prompt（用于智能体配置的代码块）
把这块复制到新智能体实例的启动/cron prompt 中。它刻意保持简短，以便放进任何模板。英文版是面向智能体的通用参考：
[CODE BLOCK]
复用同一 mind 名称的舰队智能体在  中填自己的名字（、、…）— 这样记录可以按智能体统计。
面向人类
Worklog 概览最好以 markdown 格式阅读： 或任务列表 。完整历史：。