Skill1.3k repo starsupdated 7d ago

shogun-agent-status

The shogun-agent-status skill displays unified operational status across all agents in a multi-agent system by integrating three data sources: tmux pane states (active/idle/absent), task YAML metadata including task IDs and statuses, and unread message counts from inbox queues. Use this skill when you need to verify which agents are available, identify idle agents before distributing new tasks, or diagnose why specific agents appear unresponsive.

View source Repository: multi-agent-shogun

Install in Claude Code

Copy

git clone --depth 1 https://github.com/yohey-w/multi-agent-shogun /tmp/shogun-agent-status && cp -r /tmp/shogun-agent-status/skills/shogun-agent-status ~/.claude/skills/shogun-agent-status

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# /agent-status - エージェント稼働確認

## Overview

全エージェントの稼働状態を2つのデータソースから統合判定して一覧表示する。

1. **Pane状態**: tmux capture-paneの末尾5行からCLI固有のidle/busyパターンを検出
2. **タスクYAML**: `queue/tasks/{agent}.yaml` のtask_idとstatus
3. **未読inbox**: `queue/inbox/{agent}.yaml` の未処理メッセージ数

Claude Code / Codex CLI 両方に対応。

## When to Use

- 「稼働確認」「エージェント状態」「布陣確認」と言われた時
- 足軽が暇そうか確認したい時
- タスク配分前に空いているエージェントを探す時
- 誰かが止まっているか調べたい時

## Instructions

以下のコマンドを実行する:

```bash
bash scripts/agent_status.sh
```

## 出力の読み方

| Column | 意味 |
|--------|------|
| Agent | エージェント名 |
| CLI | CLI種別（claude/codex） |
| Pane | tmux pane状態: 稼働中/待機中/不在 |
| Task ID | タスクYAMLのtask_id（---=未割当） |
| Status | タスクYAMLのstatus: assigned/done/idle等 |
| Inbox | 未読inboxメッセージ数 |

## 状態の解釈

- **Pane=待機中 + Status=done**: 完了済み、次タスク待ち。新タスク配分可能。
- **Pane=稼働中 + Status=assigned**: 正常にタスク実行中。放置してよい。
- **Pane=待機中 + Status=assigned**: タスク割当済みだがCLIが止まっている。要調査。
- **Pane=稼働中 + Status=done**: タスク完了後に別作業中（inbox処理等）。
- **Inbox > 0**: 未読メッセージあり。エージェントが処理していない可能性。
- **Pane=不在**: tmux paneが存在しない（shutsujin未実行 or pane killed）。