Agent Progress Bar 进度汇报技能

SKILL.md

---
name: agent-progress-bar
description: |
  多步骤任务进度汇报技能。本技能为默认启用的工作规范。
  
  【核心原则】
  执行任何3步及以上任务时，必须按以下格式主动向用户推送进度，不得闷头做事。
  此规则无条件生效，无需用户提醒。
  
  【进度格式】
  进度条: [████░░░░░░░░░░░░░░░] 20%
  状态表: ✅已完成 / 🔄进行中 / ⏳待开始
  
  【汇报时机】
  - 任务启动时 → 发0%初始进度
  - 每步完成后 → 发对应百分比进度
  - 超过60秒无进展 → 发心跳消息 🔔
  - 任务完成 → 发100%最终进度
  
  【消息格式】
  每条消息必须包含：进度条 + 百分比 + 状态表格 + 当前步骤说明
  
  【附件发送】
  所有任务完成 → 先发内容摘要 → 再发PDF附件
  
  【使用方式】
  直接开始多步骤任务，本技能自动生效。
---

# 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` — 进度条计算：
```bash
python3 scripts/progress.py <当前步骤> <总步骤数> <步骤名称>
```

`scripts/send_progress.py` — 进度消息发送：
```bash
python3 scripts/send_progress.py <当前步骤> <总步骤> "<步骤名称>" <用户ID>
```

## 安装与启用

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

如需手动启用（在 OpenClaw 配置文件中）：
```json
{
  "skills": {
    "entries": {
      "agent-progress-bar": { "enabled": true }
    }
  }
}
```