Agent 运行说明不能上线后就不再维护
生产 Agent 最容易被忽略的不是代码，而是运行说明。刚上线时，owner 还记得来源在哪里、Schedule 什么时候跑、Trust Mode 会拦哪些动作、artifact 哪一版被接受。几周后，新 reviewer 只看到一份过期 runbook，照着做却发现字段不一致、权限已变、下游使用方式也改了。于是团队重新进入低效询问、手动排查和重复解释。Agent Runbook 维护规则，就是让运行说明跟着 Agent 一起活着。
OpenAI Agents tracing 展示了运行步骤和状态记录的重要性；OWASP Top 10 for Large Language Model Applications 也提醒团队关注应用层风险。Axon 的运营判断是：runbook 不是一次性文档，而是生产 Agent 的可接手性基础。
这篇文章连接 Agent Workflow 目录卫生、Agent 来源访问到期检查、Agent 权限变更记录 和 定时 Agent 失败策略。runbook 维护不是文档洁癖，而是减少下次运行时的猜测。
什么内容必须跟着更新
Agent Runbook 维护规则不要求记录所有细节。它要求几个关键字段不要过期：
| 字段 | 为什么重要 | 何时更新 |
|---|---|---|
| source boundary | 决定 Agent 读取什么、不读什么 | 来源字段、文件夹、owner 变化 |
| Schedule | 决定谁什么时候接产物 | 时间、频率、冻结窗口变化 |
| Trust Mode | 决定哪些动作可自动继续 | 外发、覆盖、删除、授权变化 |
| accepted artifact | 决定 reviewer 看什么 | 模板或验收标准变化 |
| owner path | 决定问题找谁 | owner、backup owner、reviewer 变化 |
这些字段比长篇背景更重要。runbook 过期，往往就是这几项有一项没人改。
一个轻量 runbook 条目
Agent: weekly renewal summary
source_boundary: CRM renewal export, refreshed before Monday 08:30
schedule: Monday 09:00, no run during freeze window
trust_mode: no external send, confirmation required for shared artifact
accepted_artifact: v2 renewal summary template
owner_path: Agent owner -> backup owner -> reviewer
last_reviewed: 2026-07-05
这条记录不复杂，但足以让新人接手。它告诉团队当前生产版本如何运行，而不是讲一堆历史设计原因。
识别 runbook 已经过期
过期 runbook 通常会露出几个信号：
- operator 按说明找不到来源。
- reviewer 看到的 artifact 和说明不同。
- Schedule 已调整，但说明仍写旧时间。
- Trust Mode 行为和 runbook 不一致。
- owner 离开后没人知道 backup owner。
runbook 过期的危险，不是文档不好看，而是团队开始用记忆替代可复核记录。
发现这些信号时，不要等下次复盘。直接更新相应字段，并标记谁确认过。
触发更新的四类事件
第一步：来源变化时，更新 source boundary 和 stale signal。
第二步：发布或回滚时，更新 accepted artifact 和当前版本。
第三步：权限或 Trust Mode 变化时，更新动作边界。
第四步：owner、reviewer 或 backup owner 变化时，更新接手路径。
这四类事件足够覆盖大多数生产 Agent。它们也能防止 runbook 变成无人维护的长文档。
FAQ
Q1：Agent Runbook 维护规则适合所有 Agent 吗？
适合已经进入生产或团队共享使用的 Agent。个人实验 Agent 可以轻量记录。
Q2：runbook 要不要写很详细？
不需要。先保证 source boundary、Schedule、Trust Mode、accepted artifact 和 owner path 准确。
Q3：谁负责维护？
通常是 Agent owner。reviewer 和 operator 可以提交修正，但 owner 要确认当前生产事实。
Q4：多久复查一次？
稳定 Agent 可以按月复查。只要来源、权限、Schedule 或 owner 改变，就应该立即更新。
Q5：runbook 放在哪里？
放在 Axon Agent note、Workflow 目录或 workspace artifact 中，和 accepted artifact、运行证据放在一起。
下一步
开始使用 Axon 管理生产 Agents 时，为每个关键 Agent 写一条 Agent Runbook 维护规则：source boundary、Schedule、Trust Mode、accepted artifact、owner path 和 last reviewed。了解更多时，不要只看 Agent 是否还在运行，要看运行说明是否仍然可信。