| name | agent-lifecycle-management |
| description | 面向 OpenClaw 的子 agent 生命周期设计与审计技能。用于设计或检查 sessions_spawn、subagents、隔离 session、上下文继承、进度回传、恢复与清理逻辑。 |
Agent 生命周期管理
这是什么
这个 skill 解决的问题不是“怎么启动一个 agent”，而是：
- 子 agent 什么时候该创建
- 创建时应该继承哪些上下文
- 如何限制它的工具与权限
- 如何记录执行过程，方便恢复和审计
- 结束后如何做干净的资源回收
如果这些环节缺失，多 agent 系统很容易出现：
- 上下文污染
- 权限外溢
- 任务跑完但状态没收口
- session 留一堆垃圾
- 后续无法 resume 或定位问题
在 OpenClaw 里何时使用
当你要做下面这些事时，用这个 skill 的思路：
- 用
sessions_spawn 启动新的 ACP / subagent session
- 设计长期运行的线程型 agent
- 设计一次性后台 agent
- 审计子 agent 为什么越跑越乱
- 调查子 agent 结束后是否遗留状态、文件句柄、上下文映射、未清理的外部连接
不适用场景
- 单轮直接用
read / edit / exec 就能完成的小任务
- 只是分析架构概念，不涉及本地 agent 运行方式
核心原则
- 生命周期是协议，不是一次调用。
- 编排决定“派谁去”，生命周期决定“这个 agent 怎么活、怎么死”。
- 子 agent 默认应当最小继承，而不是完整复制父上下文。
- 清理逻辑必须进入
finally 思维，而不是只在成功路径里处理。
- 能恢复的前提是：你在运行时就记录了足够元数据。
OpenClaw 实战工作流
- 先判断这个任务是否真的需要独立 agent。
- 决定用哪种运行方式：
sessions_spawn + runtime="acp"：适合明确要求 Codex / Claude Code / ACP harness 的场景sessions_spawn + runtime="subagent"：适合本地隔离推理或任务拆分
- 决定 mode：
mode="run"：一次性任务，完成就结束mode="session"：持续会话，适合线程式长期协作
- 明确上下文来源：
- 只给任务摘要
- 给必要文件路径
- 给少量历史片段
- 避免把整段父会话原封不动塞进去
- 明确权限边界：
- 子 agent 是否能写文件
- 是否能执行 shell
- 是否能对外发送消息
- 是否允许继续派生子 agent
- 规定进度与结果格式：
- 结束时检查：
- session 是否还需要保留
- 是否要把结果写回主线程
- 是否要保留 transcript 便于审计
给 OpenClaw 的落地建议
- 短任务优先本地完成，别为了“高级”乱开 agent。
- 长任务、重构、大规模搜索、独立验证，才值得开子 agent。
- 线程型 agent 要有明确标签和用途，避免越积越多。
- 结果回传要摘要化，不要把海量过程直接灌回主上下文。
- 如果子 agent 要长期存在，必须有清晰 owner 和退出条件。
常见失败模式
- 把父会话整段复制给子 agent，导致上下文臃肿。
- 让子 agent 继承了不该有的高权限。
- 任务结束后没有清理 session 或状态映射。
- 需要恢复时，发现没有记录任务类型、模型、工具面。
- 主 agent 把关键责任都甩给子 agent，自己不做最终把关。
你可以产出的东西
- 一个“子 agent 生命周期检查清单”
- 一个“哪些上下文允许继承、哪些必须裁剪”的表
- 一个“spawn / 运行 / 回传 / cleanup”流程图
