work-progress

# Work Progress Skill - 工作进度检查技能

**版本**: 3.0  
**创建日期**: 2026-03-11  
**更新日期**: 2026-03-19  
**作者**: 前端 ⚡

---

## 📋 技能描述

定期检查工作进度和待办事项完成情况，**主动检测**子代理超时任务并**自动恢复**执行。

---

## 🎯 功能清单

| 任务 | 频率 | 说明 |
|------|------|------|
| **工作进度检查** | 10 分钟 | 检查待办事项 + 检测超时 + 自动恢复 |

---

## 📂 文件结构

```
skills/work-progress/
├── SKILL.md                      # 本文件
├── scripts/
│   ├── check-progress.sh         # 进度检查 + 超时检测 + 自动恢复
│   └── install.sh                # 安装脚本
└── config.json                   # 配置文件 (可选)
```

---

## 🔧 安装/启用

### 方法 1: 手动注册 cron 任务

```bash
# 工作进度检查 (10 分钟) - 静默模式，仅异常时提醒
openclaw cron add --name "工作进度检查" \
  --schedule '{"kind":"every","everyMs":600000}' \
  --payload '{"kind":"systemEvent","text":"⏰ 工作进度检查（静默模式）\\n\\n请检查：\\n1. 待办事项完成情况\\n2. 子代理会话状态\\n3. 系统日志中的 timeout 错误\\n4. 自动恢复超时任务\\n\\n---\\n\\n**重要**: 这是静默检查任务：\\n- ✅ 一切正常 → 回复 `NO_REPLY`（不输出任何内容）\\n- ⚠️ 检测到问题 → 输出详细报告提醒用户"}' \
  --session-target main \
  --delivery '{"mode":"none"}'
```

### 方法 2: 使用技能脚本

```bash
cd ~/.openclaw/workspace/skills/work-progress
bash scripts/install.sh
```

---

## 📝 任务详情

### 工作进度检查 (10 分钟)

**触发**: 每 10 分钟  
**行为**:
1. **检查待办事项** - 查看 `memory/daily/` 中的待办
2. **检测超时** - 检查系统日志中的 timeout 错误
3. **自动恢复** - 发现超时任务时主动恢复执行
4. **记录日志** - 超时详情记录到 `memory/error.md`

**主动恢复逻辑**:
```
1. 读取最近 10 分钟 journalctl 日志
2. grep 超时错误 (timeout/timed out)
3. 提取任务名称 (task: xxx / session_key: xxx)
4. 记录到 memory/error.md
5. 主动触发恢复执行（建议用户手动重试或自动继续）
```

**静默规则**:
- ✅ 一切正常 → `NO_REPLY`（不输出任何内容到聊天界面）
- ⚠️ 有待办未完成 → 输出提醒
- ⚠️ 有超时任务 → 记录 error.md + 输出提醒
- ❌ 检测到异常 → 输出详细报告

---

## 📊 检查流程

```
┌─────────────────────────────────┐
│  触发：每 10 分钟                │
└───────────────┬─────────────────┘
                │
┌───────────────▼─────────────────┐
│  读取 memory/daily/待办事项      │
└───────────────┬─────────────────┘
                │
        ┌───────┴───────┐
        │ 有待办未完成？ │
        └───┬───────┬───┘
            │       │
           是       否
            │       │
┌───────────▼───┐ ┌─▼─────────────┐
│ 继续执行任务   │ │ 更新状态      │
│ 输出提醒      │ │ 等待新任务    │
└───────────────┘ │ NO_REPLY      │
                  └─────────────────┘
```

---

## 🎛️ 配置选项

### 环境变量

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `WORKSPACE_PATH` | `~/.openclaw/workspace` | 工作区路径 |
| `DAILY_MEMORY_PATH` | `memory/daily` | daily 文件目录 |
| `CHECK_INTERVAL_MS` | `600000` | 检查间隔 (毫秒) |

### 静默模式配置

在 cron 任务的 payload 中添加：

```text
---

**重要**: 这是日常检查，请在处理完成后：
- 如果一切正常 → 回复 `NO_REPLY` (不要输出任何内容到聊天界面)
- 如果检测到异常/问题 → 才在前台输出详细报告提醒用户
```

---

## 📝 待办事项格式

在 `memory/daily/YYYY-MM-DD.md` 中使用标准格式：

```markdown
## 📌 待办

- [ ] 任务 1 描述
- [ ] 任务 2 描述
- [x] 已完成任务
```

或：

```markdown
## ✅ 今日完成

1. 完成事项 1
2. 完成事项 2

## 📋 待办

- 待办事项 1
- 待办事项 2
```

---

## 🔍 诊断命令

```bash
# 查看工作进度检查任务
openclaw cron list | grep "工作进度"

# 查看子代理超时检测任务
openclaw cron list | grep "子代理"

# 查看任务运行历史
openclaw cron runs --jobId <job-id>

# 手动触发检查
openclaw cron run --jobId <job-id>

# 查看待办事项
cat ~/.openclaw/workspace/memory/daily/$(date +%Y-%m-%d).md

# 查看超时错误日志
journalctl --user -u openclaw-gateway --since "30 minutes ago" | grep -i timeout

# 查看错误记录
cat ~/.openclaw/workspace/memory/error.md
```

---

## 💡 使用示例

### 示例 1: 添加待办事项

```markdown
## 📌 待办

- [ ] 完成首页模板开发
- [ ] 修复移动端样式问题
- [ ] 配置 ThinkPHP 路由
```

### 示例 2: 更新完成状态

```markdown
## ✅ 今日完成

1. 完成首页模板开发 (10:30)
2. 修复移动端样式问题 (11:15)

## 📌 待办

- [ ] 配置 ThinkPHP 路由
```

### 示例 3: 进度检查输出

**有待办时**:
```
⚠️ 有待办事项未完成：

- [ ] 配置 ThinkPHP 路由

当前时间：2026-03-11 14:00
```

**全部完成时**:
```
NO_REPLY
```

---

## ⚠️ 注意事项

1. **静默模式**: 默认静默执行，仅异常时提醒
2. **时间间隔**: 10 分钟是平衡点，避免过于频繁
3. **待办格式**: 使用标准 Markdown 复选框格式
4. **时间戳**: 完成任务后添加完成时间

---

## 📝 更新日志

| 日期 | 版本 | 说明 |
|------|------|------|
| 2026-03-11 | 1.0 | 初始版本，封装工作进度检查任务 |
| 2026-03-19 | 2.0 | 新增子代理超时检测 + 自动恢复功能 |
| 2026-03-19 | 3.0 | 超时检测整合到工作进度检查，主动自动恢复 |
| 2026-03-23 | 4.0 | 增强：检查子代理会话状态 + 检测消失/停止 + 下一批次任务恢复 |

---

*技能位置：`~/.openclaw/workspace/skills/work-progress/`*