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
小蔥技能站7w4.net每天更新，海量AI技能等你發現。

5. 檢視即時日誌

tail -f /Users/openclaw/.openclaw/workspace/logs/agent-task.log

📋 引數說明

初始化日誌系統

工作空間自動檢測

Skill 會自動檢測 Agent 的工作空間位置，檢測順序：

1. WORKSPACE 環境變數
2. OPENCLAW_WORKSPACE 環境變數
3. 指令碼所在目錄的父目錄
4. ~/.openclaw/workspace
5. 當前目錄

無需手動指定工作空間，開箱即用！

記錄任務開始

記錄執行命令

記錄任務狀態

💡 觸發詞

• 初始化日誌系統
• 記錄任務開始
• 記錄執行命令
• 記錄任務狀態
• 記錄任務完成
• 記錄錯誤資訊
• 檢視任務日誌

📝 日誌格式

參考 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 預估時間：5 秒 | 實際時間：3.5 秒
04-3 月 -2026 17:38:03.700 INFO [agent-task-1] com.openclaw.agent.TaskExecutor.execute 結果：成功

🔧 使用示例

示例 1：完整任務流程（自動檢測工作空間）

# 1. 初始化（自動檢測工作空間）
初始化日誌系統

# 2. 開始任務
記錄任務開始 task-id=deploy-001 task-name="部署 Java 專案" estimated-time=60s

# 3. 執行命令
記錄執行命令 task-id=deploy-001 command="mvn clean package"

# 4. 記錄狀態
記錄任務狀態 task-id=deploy-001 status="成功" actual-time=45s

# 5. 完成任務
記錄任務完成 task-id=deploy-001

示例 2：多工並行

# 任務 1：編譯後端
記錄任務開始 task-id=backend-compile task-name="編譯後端專案" estimated-time=30s
記錄執行命令 task-id=backend-compile command="mvn compile"
記錄任務狀態 task-id=backend-compile status="成功" actual-time=25s

# 任務 2：打包前端
記錄任務開始 task-id=frontend-build task-name="打包前端專案" estimated-time=45s
記錄執行命令 task-id=frontend-build command="npm run build"
記錄任務狀態 task-id=frontend-build status="成功" actual-time=40s

示例 3：錯誤處理

記錄任務開始 task-id=deploy-app task-name="部署應用" estimated-time=30s
記錄執行命令 task-id=deploy-app command="./deploy.sh"
記錄錯誤資訊 task-id=deploy-app error="許可權不足，需要 sudo"
記錄任務狀態 task-id=deploy-app status="失敗" actual-time=5s

📊 日誌級別

🛠️ 高階功能

檢視任務統計

# 檢視所有任務狀態
grep "結果：" /Users/openclaw/.openclaw/workspace/logs/agent-task.log

# 檢視失敗任務
grep "結果：失敗" /Users/openclaw/.openclaw/workspace/logs/agent-task.log

# 檢視任務耗時
grep "實際時間：" /Users/openclaw/.openclaw/workspace/logs/agent-task.log

日誌輪轉

# 按日期歸檔日誌
mv /Users/openclaw/.openclaw/workspace/logs/agent-task.log \
   /Users/openclaw/.openclaw/workspace/logs/agent-task-$(date +%Y%m%d).log

⚠️ 注意事項

1. 日誌檔案許可權：確保日誌目錄可寫
2. 日誌大小：建議定期歸檔，避免檔案過大
3. 併發寫入：支援多工併發記錄
4. 時間格式：使用 24 小時制，精確到毫秒

📁 檔案結構

workspace/
├── logs/
│   ├── agent-task.log          # 主日誌檔案
│   ├── agent-task-20260304.log # 歸檔日誌
│   └── ...
└── skills/
    └── agent-task-logger/
        ├── SKILL.md            # 技能說明
        └── scripts/
            └── logger.sh       # 日誌工具指令碼

🔄 更新日誌

• v1.0 - 初始版本，支援基本任務記錄
• v1.1 - 新增中文支援
• v1.2 - 新增任務統計功能

這個 Skill 質量中等偏上，核心功能完整實用，能有效記錄 Agent 任務執行日誌。它最大的優點是開箱即用、配置簡單，中文日誌清晰易懂，適合快速上手。不足之處在於功能相對基礎，缺少日誌級別控制和檔案管理等進階功能，文件重複較多，且存在版本號標識不一致的小瑕疵。總體來說，作為輕量級任務日誌工具是合格的，但高階功能有待加強。