Overview
- Skill Key
- evan966890/agent-batch-guard
- Author
- evan966890
- Source Repo
- openclaw/skills
- Version
- 1.0.0
- Source Path
- skills/evan966890/agent-batch-guard
- Latest Commit SHA
- 5d358842091ca62e054f07776c9d8f3386e2a461
Official OpenClaw
rules
54%
agent-batch-guard
AI Agent 大任务防卡死指南。解决 agent 在批量操作中 session transcript 膨胀导致 compaction 超时、agent 卡死的问题。涵盖 session 保护策略、脚本化批处理、断点续传、熔断器、OpenClaw 配置调优和实战案例。
Stars
0
Installs
0
Status
ACTIVE
Visibility
PUBLIC
安装方式
直接复制以下提示词，发送给你的 AI 助手即可完成安装。
请先检查是否已安装 SkillHub 商店，若未安装，请根据 https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/skillhub.md 安装 SkillHub 商店，然后安装 agent-batch-guard 技能。 若已安装，则直接安装 agent-batch-guard 技能。
Extracted Content
SKILL.md excerpt
# Agent 大任务防卡死指南 AI Agent 执行大任务（批量抓取、翻页采集、历史数据导出）时，极易因 session transcript 膨胀导致卡死。本指南提供从认知层到配置层的完整防护方案。 ## 这个 Skill 解决什么问题 AI Agent（如 OpenClaw agent）在执行大量重复操作时，每一轮工具调用的输入和输出都会堆积在 session transcript 中。当 transcript 膨胀到数 MB 级别后： 1. **Compaction 超时** — 压缩旧对话的过程本身超过时间限制 2. **Agent 彻底卡死** — 无法处理新消息，也无法自行恢复 3. **用户无感知** — agent 停止响应，但没有任何报错通知 **真实案例**：agent 被要求翻阅手机 App 抓取 1 年的订单数据，在对话中逐页执行 scroll → uiautomator dump → parse → repeat，200+ 轮后 transcript 膨胀到 9.6MB，compaction 两次超时，agent 静默卡死数小时。 --- ## 第一层：Agent 行为规范（写入 AGENTS.md） 这是最重要的一层。Agent 不具备对自身运行环境的 meta 认知——它不知道 transcript 有容量上限，需要在 workspace 配置中显式告知。 ### 核心原则 **数据写文件，不要堆在对话里。** ### 判断标准 | 任务规模 | 做法 | |---------|------| | < 5 页/轮 | 可以在对话里直接操作 | | 5-20 页/轮 | 写脚本，一次跑完，结果存文件 | | 20+ 页/轮 | 写脚本 + 分批（按月/按平台/按类别），每批存档 | ### 黄金规则 1. **超过 5 页的翻页操作 → 写脚本**，不在对话里循环 2. **数据写文件**（如 `data/scrape/`），不堆在 transcript 里 3. **分批 + 断点续传**（每批存档，支持中断恢复） 4. **对话里只做三件事**：写脚本 → 检查进度 → 汇总回复 5. **超过 10 轮重复操作 = 立刻停下来写脚本** 6. **熔断保护**：连续失败 5 次暂停，不要无脑重试 ### 建议写入 AGENTS.md 的模板 ```markdown ## 大任务处理规范（防止 session 卡死） **核心原则：数据写文件，不要堆在对话里。** 当任务涉及大量重复操作时（批量处理、翻阅多页数据、爬取历史记录）， **禁止**在对话中逐页循环。 详细批处理模式请读取： ~/.openclaw/skills/agent-batch-guard/SKILL.md ### 快速规则 1. 超过 5 页的翻页操作 → 写脚本，不在对话里循环 2. 数据写文件，不堆在 transcript 里 3. 分批 + 断点续传（每批存档，支持中断恢复） 4. 对话里只做三件事：写脚本 → 检查进度 → 汇总回复 5. 超过 10 轮重复操作 = 立刻停下来写脚本 6. 熔断保护：...
Related Claw Skills
openstockdata
stock-data-skill
OpenClaw Skill for stock data analysis
capt-marbles
geo-optimization
Generative Engine Optimization (GEO) for AI search visibility. Optimize content to appear in ChatGPT, Perplexity, Claude, and Google AI Overviews. Use when optimizing websites, pages, or content for LLM discoverability and citation.
capgoblin
credex-protocol
Access unsecured credit lines for AI agents on the Arc Network using the Credex Protocol. Use for borrowing USDC against reputation, repaying debt to grow credit limits, providing liquidity as an LP, or managing cross-chain USDC via Circle Bridge. Triggers on "borrow from credex", "repay debt", "deposit to pool", "check credit status", "provide liquidity", or any credit/lending task on Arc.
capt-marbles
phantombuster
Control PhantomBuster automation agents via API. List agents, launch automations, get output/results, check status, and abort running agents. Use when the user needs to run LinkedIn scraping, Twitter automation, lead generation phantoms, or any PhantomBuster workflow.
camelsprout
duckdb-en
DuckDB CLI specialist for SQL analysis, data processing and file conversion. Use for SQL queries, CSV/Parquet/JSON analysis, database queries, or data conversion. Triggers on "duckdb", "sql", "query", "data analysis", "parquet", "convert data".
camohiddendj
ddg-search
DuckDuckGo HTML search scraper CLI with JSON, CSV, OpenSearch, markdown, and compact outputs.