agent-batch-guard
Installation
SKILL.md
Agent 大任务防卡死指南
AI Agent 执行大任务(批量抓取、翻页采集、历史数据导出)时,极易因 session transcript 膨胀导致卡死。本指南提供从认知层到配置层的完整防护方案。
这个 Skill 解决什么问题
AI Agent(如 OpenClaw agent)在执行大量重复操作时,每一轮工具调用的输入和输出都会堆积在 session transcript 中。当 transcript 膨胀到数 MB 级别后:
- Compaction 超时 — 压缩旧对话的过程本身超过时间限制
- Agent 彻底卡死 — 无法处理新消息,也无法自行恢复
- 用户无感知 — agent 停止响应,但没有任何报错通知
真实案例:agent 被要求翻阅手机 App 抓取 1 年的订单数据,在对话中逐页执行 scroll → uiautomator dump → parse → repeat,200+ 轮后 transcript 膨胀到 9.6MB,compaction 两次超时,agent 静默卡死数小时。
第一层:Agent 行为规范(写入 AGENTS.md)
这是最重要的一层。Agent 不具备对自身运行环境的 meta 认知——它不知道 transcript 有容量上限,需要在 workspace 配置中显式告知。