安全扫描（ClawHub）

• VirusTotal ：良性
• OpenClaw ：良性

OpenClaw 评估

The skill's files, instructions, and scripts are consistent with its stated purpose (periodic todo checks, detecting subagent timeouts, and triggering local recovery); it does not request secrets or contact external endpoints, but it will read system logs and register cron jobs on the host.

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「Work Progress」。简介：工作进度检查技能 - 定期检查待办事项 + 子代理超时/消失检测与自动恢复。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/amd5/work-progress/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

---
name: work-progress
description: 工作进度检查技能 - 定期检查待办事项 + 子代理超时主动检测与自动恢复
version: 3.0.1
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 任务

```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 分钟  
**行为**:
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 | 超时检测整合到工作进度检查，主动自动恢复 |

---

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