agent-progress-bar 进度汇报技能

核心原则（无条件执行）

执行任何3步及以上任务时，必须主动推送进度，不闷头做事。

此规则无条件生效，不需要用户提醒，不需要额外配置。只要任务需要多步骤完成，AI 必须按本技能规范主动执行进度汇报。

进度条格式

[████████████░░░░░░░░] 60%

✅ 步骤1：xxx              — 已完成
🔄 步骤2：xxx              — 进行中，预估还需3分钟
⏳ 步骤3：xxx              — 待开始

进度汇报时机

| 时机 | 内容 | |------|------| | 任务启动 | 0% 初始进度 + 里程碑规划 | | 每步完成 | 对应百分比 + 状态表格 | | 超过60秒无进展 | 🔔 心跳消息"仍在执行中" | | 任务完成 | 100% + 内容摘要 + PDF附件 |

里程碑规划（智能分配）

根据任务复杂度自由切分百分比，不强制均分：

| 任务类型 | 建议步骤数 | 示例百分比 | |---------|-----------|-----------| | 搜索调研类 | 4-5步 | 20/45/70/90/100 | | 文件处理类 | 3-4步 | 25/50/75/100 | | 复杂分析类 | 5步以上 | 按工作量分配 |

附件发送顺序

所有内容写完后再发附件，分3条消息：

1. 100% 进度表格
2. 报告核心内容摘要
3. PDF附件

脚本工具

scripts/progress.py — 进度条计算：

python3 scripts/progress.py <当前步骤> <总步骤数> <步骤名称>

scripts/send_progress.py — 进度消息发送：

python3 scripts/send_progress.py <当前步骤> <总步骤> "<步骤名称>" <用户ID>

安装与启用

58技能市场下载后，无需任何手动配置，技能自动生效。

如需手动启用（在 OpenClaw 配置文件中）：

{
  "skills": {
    "entries": {
      "agent-progress-bar": { "enabled": true }
    }
  }
}