name: agent-status-monitor description: 檢查本地開發 Agent（Claude Code、OpenCode、OpenClaw、Cursor 等）的執行狀態、程序、會話和活動狀態。觸發詞："agents_monitor"、"檢查 Claude Code 狀態"、"檢視 opencode 是否在執行"、"監控開發工具"、"agent 監控"。使用 when: (1) 檢視某個 agent 是否在執行，(2) 檢查 agent 當前任務/進度，(3) 獲取 agent 狀態報告，(4) 監控多個 agent 的健康狀態。

Agent Status Monitor

檢查本地開發工具 Agent 的執行狀態和活動狀態。

觸發條件

核心意圖：快速瞭解本地執行的 AI 開發工具（Agent）是否在執行、是否在工作、是否有會話活動。

典型場景： - 同時執行多個 Agent（Claude Code、OpenCode、OpenClaw），想確認各自狀態 - 不確定某個 Agent 是否還在工作，還是已經卡住/閒置 - 想檢視哪個 Agent 正在活躍使用，哪個只是後臺執行 - 定期檢查多個 Agent 的健康狀態

觸發示例： - "檢查 agent 狀態" - "Claude Code 還在工作嗎" - "看看有哪些 agent 在執行" - "opencode 是不是閒置了" - "執行 agents_monitor"

具體成果

一句話目標：執行 agents_monitor 命令，輸出所有本地 Agent 的執行狀態（執行中/工作中/閒置/未執行）和會話數量。

預期輸出：

● Claude Code: 🔥 工作中 (2 分鐘內有更新) · 13 個會話
● OpenClaw: 🔥 工作中 (2 分鐘內有更新) · 1 個會話
● OpenCode: 💤 閒置 (未使用) · 1 個會話
○ Cursor IDE: 未執行

狀態說明： | 狀態 | 含義 | |------|------| | 🔥 工作中 | 2 分鐘內有會話檔案更新 | | ⏳ 等待中 | 10 分鐘內有更新（可能在思考/等待 API） | | 💤 閒置 | 超過 10 分鐘無更新，或未使用 | | ○ 未執行 | 程序不存在 |

步驟邏輯

執行步驟

1. 執行檢測指令碼 bash ~/.openclaw/workspace/skills/agent-status-monitor/scripts/check-agents.sh

2. 程序檢測 - 對每個 Agent 執行：

3. ps aux | grep <agent> 檢查程序是否存在

4. 排除系統誤報程序（如 CursorUIViewService）

5. 活動狀態判斷 - 檢查會話目錄檔案修改時間：

6. 2 分鐘內有更新 → 🔥 工作中
7. 10 分鐘內有更新 → ⏳ 等待中
8. 超過 10 分鐘無更新 → 💤 閒置

9. 只有 1 個檔案且超過 5 分鐘 → 💤 未使用（初始配置）

10. 輸出報告 - 包含：

11. 狀態圖示 + 文字說明
12. 會話檔案數量
13. 詳細配置資訊（版本、配置路徑等）

各 Agent 會話目錄

約束

• 只檢測本地執行的 Agent，不涉及雲端/遠端服務
• 基於檔案系統修改時間，不依賴 Agent API
• 僅讀取公開目錄，不訪問私有資料

正反樣例

✅ 正例

輸入：

檢查 agent 狀態

輸出：

========================================
   Agent Status Monitor
========================================

--- 程序狀態 ---
● Claude Code: 🔥 工作中 (2 分鐘內有更新) · 13 個會話
● OpenClaw: 🔥 工作中 (2 分鐘內有更新) · 1 個會話
● OpenCode: 💤 閒置 (未使用) · 1 個會話
○ Cursor IDE: 未執行

--- OpenCode 詳情 ---
版本：1.2.15
  └─ 配置：~/.config/opencode/opencode.json
  └─ 會話日誌：1 個檔案

--- OpenClaw 狀態 ---
[OpenClaw status 輸出...]

輸入：

Claude Code 還在工作嗎

輸出：

Claude Code: 🔥 工作中 (2 分鐘內有更新) · 13 個會話

❌ 反例

輸入：

檢查 agent 狀態

錯誤輸出：

Claude Code: 執行中
OpenCode: 執行中

❌ 問題：沒有顯示活動狀態（工作中/閒置），資訊不完整

錯誤輸出：

CPU 使用率：Claude Code 3.7%, OpenCode 0.3%

❌ 問題：CPU 使用率不可靠，Agent 等待 API 時 CPU 低但仍在工作中

錯誤輸出：

Claude Code 程序 ID: 12345, 12346, 12347

❌ 問題：使用者不關心程序 ID，關心的是"是否在工作"

想要更強大的技能外掛，就來小蔥技能站7w4.net看看吧。

明確限制

不做什麼

• ❌ 不監控雲端 Agent - 只檢測本地程序和檔案
• ❌ 不統計 Token 使用量 - 各 Agent 日誌格式不統一，暫不支援
• ❌ 不顯示程序 ID/記憶體佔用 - 使用者關心活動狀態，不是系統指標
• ❌ 不控制/停止 Agent - 只讀檢測，不執行任何修改操作
• ❌ 不涉及敏感話題 - 純技術檢測，無內容審查

異常處理

兜底策略

如果指令碼檢測失敗，返回：

⚠️ 無法獲取詳細狀態，嘗試手動檢查：
ps aux | grep -E "(claude|opencode|openclaw)" | grep -v grep

已知限制

1. Cursor IDE - 沒有統一會話目錄，僅程序檢測
2. 新 Agent 型別 - 需要手動新增檢測邏輯
3. 跨使用者檢測 - 只能檢測當前使用者的 Agent
4. 容器/Docker - 不檢測容器內執行的 Agent

相關資源

• scripts/check-agents.sh - 主檢測指令碼
• references/agent-commands.md - 各 Agent 命令參考

更新日誌

• 基於會話檔案修改時間判斷活動狀態（比 CPU 使用率更可靠）
• 支援 Claude Code、OpenCode、OpenClaw、Cursor IDE
• 提供 agents_monitor 命令別名

這是一款實用的本地 Agent 狀態監控工具，能同時檢測 Claude Code、OpenCode、OpenClaw 和 Cursor 是否在執行，並判斷是工作中、等待中還是閒置狀態。文件清晰、安裝簡單、輸出友好。不過它只能檢測本地的 AI 工具，無法監控雲端服務，且狀態判斷依賴檔案更新時間，可能偶有延遲。整體質量良好，適合需要同時執行多個 AI 開發工具的使用者。