什么是 批处理？

Batch 技能是一种高可靠性协议，专为 AI 编码智能体设计，用于管理和执行涉及大量项目的任务，例如批量文件编辑、API 请求或数据处理。通过标准化批处理操作的生命周期（从初始演练到最终成功报告），该 Openclaw Skills 条目确保了长时间运行的任务是可预测且可控的。它专注于降低静默失败的风险，并向用户提供智能体进度的清晰可见性。

除了执行，Batch 技能还强调安全性。它强制要求对破坏性操作进行确认，并维护检查点以防止中断时的内容丢失。这使其成为开发者构建复杂自动化工作流的必备工具，这些工作流需要比简单的单轮命令更多的功能。

下载入口:https://github.com/openclaw/skills/tree/main/skills/ivangdavila/batch

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

批处理 应用场景

• 跨数百个独立文件对源代码进行批量重构
• 通过具有内置速率限制管理的外部 API 处理大型数据集
• 在大型仓库中执行大规模文件系统清理或元数据更新
• 进度监控至关重要的遗留资产自动化迁移

1. 对 2-3 个项目进行初步演练，以验证逻辑并识别潜在问题。
2. 计算项目总数并向用户提供预计完成时间。
3. 在进行任何破坏性操作（如批量删除）之前请求明确确认。
4. 定期（每 10 个项目）更新进度，以保持透明度。
5. 每 10 到 50 个项目将操作状态保存到检查点，以便在中断时恢复。
6. 记录特定项目的失败，同时继续整体批处理，以防止轻微错误导致流程停止。
7. 生成总结成功和失败项目的最终报告，将错误保存到 failed.json 文件中以供后续重试。

批处理 配置指南

要将此批处理功能集成到您的 AI 工作流中，请在本地技能目录中包含技能定义。您可以使用以下命令设置所需的文件结构：

mkdir -p .skills && touch .skills/batch.md

确保您的智能体系统提示已配置为识别 Openclaw Skills 协议，以便在多项目任务期间启用自动检查点和进度报告。

批处理 数据架构与分类体系

name: Batch
description: Process multiple items with progress tracking, checkpointing, and failure recovery.

Before Starting

1. Dry run: Test with 2-3 items first
2. Count: "Processing 47 items, ~2 min estimated"
3. Confirm destructive ops: "This will delete 200 files. Proceed?"

During Processing

• Progress every 10 items: "23/47 complete (49%)"
• Checkpoint every 10-50 items: Save state to resume if interrupted
• On error: Log it, continue with rest (don't abort entire batch)

After Completion

Always report:

? 44 succeeded
? 3 failed (saved to failed.json for retry)

Error Handling

Check strategies.md for parallel vs sequential decision matrix. Check errors.md for retry logic and rollback patterns.

Related: For delegating to sub-agents, see delegate.