安装
claude skill add --url github.com/openclaw/skills/tree/main/skills/amd5/work-progress文档
Work Progress Skill - 工作进度检查技能
版本: 3.0
创建日期: 2026-03-11
更新日期: 2026-03-19
作者: 前端 ⚡
📋 技能描述
定期检查工作进度和待办事项完成情况,主动检测子代理超时任务并自动恢复执行。
🎯 功能清单
| 任务 | 频率 | 说明 |
|---|---|---|
| 工作进度检查 | 10 分钟 | 检查待办事项 + 检测超时 + 自动恢复 |
📂 文件结构
code
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. 系统日志中的 timeout 错误\\n3. 超时任务自动恢复\\n\\n---\\n\\n**重要**: 正常→NO_REPLY | 异常→输出报告"}' \
--session-target main \
--delivery '{"mode":"none"}'
方法 2: 使用技能脚本
bash
cd ~/.openclaw/workspace/skills/work-progress
bash scripts/install.sh
📝 任务详情
工作进度检查 (10 分钟)
触发: 每 10 分钟
行为:
- 检查待办事项 - 查看
memory/daily/中的待办 - 检测超时 - 检查系统日志中的 timeout 错误
- 自动恢复 - 发现超时任务时主动恢复执行
- 记录日志 - 超时详情记录到
memory/error.md
主动恢复逻辑:
code
1. 读取最近 10 分钟 journalctl 日志
2. grep 超时错误 (timeout/timed out)
3. 提取任务名称 (task: xxx / session_key: xxx)
4. 记录到 memory/error.md
5. 主动触发恢复执行(建议用户手动重试或自动继续)
静默规则:
- ✅ 一切正常 →
NO_REPLY - ⚠️ 有待办未完成 → 输出提醒
- ⚠️ 有超时任务 → 记录 error.md + 提醒用户
- ❌ 检测到异常 → 输出详细报告
📊 检查流程
code
┌─────────────────────────────────┐
│ 触发:每 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: 进度检查输出
有待办时:
code
⚠️ 有待办事项未完成:
- [ ] 配置 ThinkPHP 路由
当前时间:2026-03-11 14:00
全部完成时:
code
NO_REPLY
⚠️ 注意事项
- 静默模式: 默认静默执行,仅异常时提醒
- 时间间隔: 10 分钟是平衡点,避免过于频繁
- 待办格式: 使用标准 Markdown 复选框格式
- 时间戳: 完成任务后添加完成时间
📝 更新日志
| 日期 | 版本 | 说明 |
|---|---|---|
| 2026-03-11 | 1.0 | 初始版本,封装工作进度检查任务 |
| 2026-03-19 | 2.0 | 新增子代理超时检测 + 自动恢复功能 |
| 2026-03-19 | 3.0 | 超时检测整合到工作进度检查,主动自动恢复 |
技能位置:~/.openclaw/workspace/skills/work-progress/