work-progress

name	work-progress
description	工作进度检查技能 - 定期检查待办事项 + 子代理超时/消失检测与自动恢复
version	4.0.0
author	前端 ⚡

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 任务

# 工作进度检查 (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: 使用技能脚本

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 中添加：

---

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

---

📝 待办事项格式

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

## 📌 待办

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

或：

## ✅ 今日完成

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

## 📋 待办

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

---

🔍 诊断命令

# 查看工作进度检查任务
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: 添加待办事项

## 📌 待办

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

示例 2: 更新完成状态

## ✅ 今日完成

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/