Agent Task Logger

# Agent Task Logger - Agent 任务日志系统

一个类似 Tomcat catalina.out 的实时任务日志系统，**自动检测 Agent 工作空间**，用于记录和展示 Agent 执行任务的进度。

## 🚀 快速使用

### 1. 初始化日志系统（自动检测工作空间）
```
初始化日志系统
```

### 2. 初始化日志系统（手动指定工作空间）
```
初始化日志系统 workspace=/path/to/workspace
```

### 2. 记录任务开始
```
记录任务开始 task-id=task-001 task-name="停止 Tomcat 8" estimated-time=5s
```

### 3. 记录执行命令
```
记录执行命令 task-id=task-001 command="cd /path && ./shutdown.sh"
```

### 4. 记录任务状态
```
记录任务状态 task-id=task-001 status="成功" actual-time=3.5s
```

### 5. 查看实时日志
```bash
tail -f /Users/openclaw/.openclaw/workspace/logs/agent-task.log
```

## 📋 参数说明

### 初始化日志系统
| 参数 | 必填 | 默认值 | 说明 |
|------|------|--------|------|
| `workspace` | ❌ | 自动检测 | 工作空间根目录（可选，自动检测） |
| `log-dir` | ❌ | `logs` | 日志目录（相对于 workspace） |
| `log-file` | ❌ | `agent-task.log` | 日志文件名 |

### 工作空间自动检测

Skill 会自动检测 Agent 的工作空间位置，检测顺序：

1. `WORKSPACE` 环境变量
2. `OPENCLAW_WORKSPACE` 环境变量
3. 脚本所在目录的父目录
4. `~/.openclaw/workspace`
5. 当前目录

**无需手动指定工作空间，开箱即用！**

### 记录任务开始
| 参数 | 必填 | 说明 |
|------|------|------|
| `task-id` | ✅ | 任务唯一标识 |
| `task-name` | ✅ | 任务描述 |
| `estimated-time` | ❌ | 预估处理时间 |

### 记录执行命令
| 参数 | 必填 | 说明 |
|------|------|------|
| `task-id` | ✅ | 关联的任务 ID |
| `command` | ✅ | 执行的 shell 命令 |

### 记录任务状态
| 参数 | 必填 | 说明 |
|------|------|------|
| `task-id` | ✅ | 关联的任务 ID |
| `status` | ✅ | 任务状态（成功/失败/等待中） |
| `actual-time` | ❌ | 实际处理时间 |

## 💡 触发词

- 初始化日志系统
- 记录任务开始
- 记录执行命令
- 记录任务状态
- 记录任务完成
- 记录错误信息
- 查看任务日志

## 📝 日志格式

参考 Tomcat catalina.out 格式，中文显示：

```
04-3 月 -2026 17:38:00.000 INFO [agent-task-1] com.openclaw.agent.TaskExecutor.execute 任...

# Agent Task Logger - Agent 任务日志系统

一个类似 Tomcat catalina.out 的实时任务日志系统，**自动检测 Agent 工作空间**，用于记录和展示 Agent 执行任务的进度。

## 🚀 快速使用

### 1. 初始化日志系统（自动检测工作空间）
```bash
初始化日志系统
```

### 2. 记录任务开始
```bash
记录任务开始 task-id=task-001 task-name="停止 Tomcat 8" estimated-time=5s
```

### 3. 记录执行命令
```bash
记录执行命令 task-id=task-001 command="cd /path && ./shutdown.sh"
```

### 4. 记录任务状态
```bash
记录任务状态 task-id=task-001 status="成功" actual-time=3.5s
```

### 5. 查看实时日志
```bash
tail -f $(pwd)/logs/agent-task.log
```

## 📋 参数说明

### 初始化日志系统
| 参数 | 必填 | 默认值 | 说明 |
|------|------|--------|------|
| `workspace` | ❌ | 自动检测 | 工作空间根目录（可选，自动检测） |
| `log-dir` | ❌ | `logs` | 日志目录（相对于 workspace） |
| `log-file` | ❌ | `agent-task.log` | 日志文件名 |

### 记录任务开始
| 参数 | 必填 | 说明 |
|------|------|------|
| `task-id` | ✅ | 任务唯一标识 |
| `task-name` | ✅ | 任务描述 |
| `estimated-time` | ❌ | 预估处理时间 |

### 记录执行命令
| 参数 | 必填 | 说明 |
|------|------|------|
| `task-id` | ✅ | 关联的任务 ID |
| `command` | ✅ | 执行的 shell 命令 |

### 记录任务状态
| 参数 | 必填 | 说明 |
|------|------|------|
| `task-id` | ✅ | 关联的任务 ID |
| `status` | ✅ | 任务状态（成功/失败/等待中） |
| `actual-time` | ❌ | 实际处理时间 |

## 💡 触发词

- 初始化日志系统
- 记录任务开始
- 记录执行命令
- 记录任务状态
- 记录任务完成
- 记录错误信息
- 查看任务日志

## 📝 日志格式

参考 Tomcat catalina.out 格式，中文显示：

```
04-3 月 -2026 17:38:00.000 INFO [agent-task-1] com.openclaw.agent.TaskExecutor.execute 任务：停止 Tomcat 8
04-3 月 -2026 17:38:00.100 INFO [agent-task-1] com.openclaw.agent.TaskExecutor.execute 执行命令：cd /path && ./shutdown.sh
04-3 月 -2026 17:38:03.500 INFO [agent-task-1] com.openclaw.agent.TaskExecutor.execute 状态：Tomcat 8 关闭完成
04-3 月 -2026 17:38:03.600 INFO [agent-task-1] com.openclaw.agent.TaskExecutor.execute...