# Agent Lifecycle Management

> 面向 OpenClaw 的子 agent 生命周期设计与审计技能。用于设计或检查 sessions_spawn、subagents、隔离 session、上下文继承、进度回传、恢复与清理逻辑。

- Skill: `richard0901/agent-lifecycle-management` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add richard0901/agent-lifecycle-management`
- Raw SKILL.md: https://api.skillmd.com/api/skills/richard0901/agent-lifecycle-management/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: richard0901 (https://skillmd.com/u/richard0901)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/richard0901/agent-lifecycle-management

---


# Agent 生命周期管理

## 这是什么

这个 skill 解决的问题不是“怎么启动一个 agent”，而是：

1. 子 agent 什么时候该创建
2. 创建时应该继承哪些上下文
3. 如何限制它的工具与权限
4. 如何记录执行过程，方便恢复和审计
5. 结束后如何做干净的资源回收

如果这些环节缺失，多 agent 系统很容易出现：

1. 上下文污染
2. 权限外溢
3. 任务跑完但状态没收口
4. session 留一堆垃圾
5. 后续无法 resume 或定位问题

## 在 OpenClaw 里何时使用

当你要做下面这些事时，用这个 skill 的思路：

1. 用 `sessions_spawn` 启动新的 ACP / subagent session
2. 设计长期运行的线程型 agent
3. 设计一次性后台 agent
4. 审计子 agent 为什么越跑越乱
5. 调查子 agent 结束后是否遗留状态、文件句柄、上下文映射、未清理的外部连接

## 不适用场景

1. 单轮直接用 `read` / `edit` / `exec` 就能完成的小任务
2. 只是分析架构概念，不涉及本地 agent 运行方式

## 核心原则

1. 生命周期是协议，不是一次调用。
2. 编排决定“派谁去”，生命周期决定“这个 agent 怎么活、怎么死”。
3. 子 agent 默认应当最小继承，而不是完整复制父上下文。
4. 清理逻辑必须进入 `finally` 思维，而不是只在成功路径里处理。
5. 能恢复的前提是：你在运行时就记录了足够元数据。

## OpenClaw 实战工作流

1. 先判断这个任务是否真的需要独立 agent。
2. 决定用哪种运行方式：
   - `sessions_spawn` + `runtime="acp"`：适合明确要求 Codex / Claude Code / ACP harness 的场景
   - `sessions_spawn` + `runtime="subagent"`：适合本地隔离推理或任务拆分
3. 决定 mode：
   - `mode="run"`：一次性任务，完成就结束
   - `mode="session"`：持续会话，适合线程式长期协作
4. 明确上下文来源：
   - 只给任务摘要
   - 给必要文件路径
   - 给少量历史片段
   - 避免把整段父会话原封不动塞进去
5. 明确权限边界：
   - 子 agent 是否能写文件
   - 是否能执行 shell
   - 是否能对外发送消息
   - 是否允许继续派生子 agent
6. 规定进度与结果格式：
   - 任务开始
   - 中间进度
   - 最终产出
   - 是否需要人工接管
7. 结束时检查：
   - session 是否还需要保留
   - 是否要把结果写回主线程
   - 是否要保留 transcript 便于审计

## 给 OpenClaw 的落地建议

1. 短任务优先本地完成，别为了“高级”乱开 agent。
2. 长任务、重构、大规模搜索、独立验证，才值得开子 agent。
3. 线程型 agent 要有明确标签和用途，避免越积越多。
4. 结果回传要摘要化，不要把海量过程直接灌回主上下文。
5. 如果子 agent 要长期存在，必须有清晰 owner 和退出条件。

## 常见失败模式

1. 把父会话整段复制给子 agent，导致上下文臃肿。
2. 让子 agent 继承了不该有的高权限。
3. 任务结束后没有清理 session 或状态映射。
4. 需要恢复时，发现没有记录任务类型、模型、工具面。
5. 主 agent 把关键责任都甩给子 agent，自己不做最终把关。

## 你可以产出的东西

1. 一个“子 agent 生命周期检查清单”
2. 一个“哪些上下文允许继承、哪些必须裁剪”的表
3. 一个“spawn / 运行 / 回传 / cleanup”流程图