mcpField
A
agent-deck

agent-deck

github.com/asheshgoplaniエージェントワークフロー1.2k127 回インストール3 日前に更新
リポジトリ

agent-deck について

agent-deck セッションを操作するためのスキルガイドです。コーディング作業を開始・調整するエージェント向けに、セッション管理、メッセージ送信、MCP の接続、サブエージェントの運用を説明します。

主な機能

  1. 01セッションの起動と管理
  2. 02メッセージ送信と出力確認
  3. 03対応する会話のフォーク
  4. 04必要に応じた MCP の接続
  5. 05サブエージェントの起動と調整

活用シーン

  1. 01プロジェクトのコーディングセッション開始
  2. 02セッションの最新応答の確認
  3. 03子エージェントへのタスク割り当て
  4. 04セッションへの MCP 接続

MCP 対応

利用可能な MCP の一覧表示、セッションへの接続、読み込みのためのセッション再起動の方法を説明します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/asheshgoplani/agent-deck --skill agent-deck

インストール後、Claude Code で/agent-deckを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
evals.json
RUNNER.md
references/
autonomy.md
capabilities.md
cli-reference.md
conductors.md
config-reference.md
goal.md
gotchas.md
sandbox.md
self-improvement.md
session-communication.md
session-workflows.md
sub-agents.md
troubleshooting.md
tui-reference.md
scripts/
launch-subagent.sh
scripts/goal/
goal.sh
manager.py
scripts/goal/prompts/
worker.md
scripts/goal/tests/
test_manager.py
test_progress_gate.py
test_run_budget.py
test_worker_prompt.py
scripts/self-improvement/
analyze-all-conductors.sh
build_manifest.py
distill.py
file_issue.py
file-issues.sh
list_candidates.py

詳細

Agent Deck

インストール済みのバージョンを確認するには、agent-deck --version を実行してください。このスキルの対象は v1.16.11+ です。ほとんどのパターンは v1.7 でも機能します。≥1.16.11 が必要な項目については、後方互換性を参照してください。

スクリプト

ヘルパースクリプトは、このスキルの scripts/ フォルダーにあります。ユーザーのプロジェクトではなく、スキルの読み込み時に表示されたベースディレクトリを基準にパスを解決してください。

SKILL_DIR="/path/shown/in/base-directory-line"
$SKILL_DIR/scripts/launch-subagent.sh "Title" "Prompt" --wait

プラグインをインストールした場合、パスは ~/.claude/plugins/cache/agent-deck/agent-deck/<hash>/skills/agent-deck/ に解決されます。リポジトリをチェックアウトした場合は、<repo>/skills/agent-deck/ に解決されます。

基本コマンド

コマンド用途
agent-deck対話型 TUI を起動
agent-deck add -t "Name" -c claude /pathセッションを作成
agent-deck launch . -c claude --account <name>名前付きアカウントスロットでセッションを作成して起動
agent-deck session start/stop/restart <name>セッションを操作
agent-deck session send <name> "message"メッセージを送信
agent-deck session send <name> --message-file <file>ファイルからメッセージを送信（- = 標準入力）。シェルでのクォートは不要です。launch／session start でも使用できます
agent-deck session command --json <name> "/compact"Claude Code のスラッシュコマンドまたはスキル（/model、/compact、/clear、/exit）を安全に実行して検証します。session send 経由では実行しないでください。コマンドの一覧は session commands --json <name> で確認できます
agent-deck session output <name>範囲を制限した、ANSI を除去済みの直近の応答を取得（JSON／quiet／copy では元の内容をすべて保持）
agent-deck session children --json子セッションの実行状況と確認済みの完了状態を取得（ノンブロッキング、読み取り専用）
agent-deck session current [-q|--json]現在のセッションを自動検出
agent-deck session fork <name>Claude／OpenCode／Pi／Codex／Oh My Pi の会話をフォーク
agent-deck mcp list利用可能な MCP を一覧表示
agent-deck mcp attach <name> <mcp>MCP をアタッチ（その後、再起動が必要）
agent-deck statusステータスの概要をすばやく表示
agent-deck open report.htmlmacOS アプリのブラウザーパネルで HTML レポートをユーザーに表示（リモートセッションからも利用可能）
agent-deck add --worktree <branch>Git ワークツリーにセッションを作成

ステータス： ● 実行中 | ◐ 待機中 | ○ アイドル | ✕ エラー

その他のコマンドとフラグについては、cli-reference.mdを参照してください。

ルール

  1. 引数より先にフラグを指定します： name -m "Hello" ではなく、session start -m "Hello" name のように指定してください。フラグが無視されたように見える場合、ほとんどは指定位置が間違っています。
  2. MCP のアタッチは依頼された場合に限ります： ユーザーから依頼された場合にアタッチし、その後 session restart を実行してください。アタッチしただけでは読み込まれません。--global はすべてのプロジェクトで Claude の設定を書き換えます。既定では、セッションの .mcp.json に書き込みます。
  3. ほかのセッションの作業を妨げないでください： ポーリングループは対象セッションに干渉することがあるため、ほかのセッションを確認するときは、session output または session children を一度だけ呼び出してください。
  4. 子のプロンプトにはタスクだけを記述してください。 agent-deck が起動する各セッションエージェントには、すでにその識別情報（セッション ID、タイトル、親、基本コマンド、完了センチネル。カスタム --cmd では $AGENTDECK_IDENTITY_FILE）が含まれているため、子が何者か、親への連絡方法をプロンプトで説明する必要はありません。--no-identity または [launch] inject_identity = false で無効化できます。gemini の場合は、識別情報フォルダーも信頼する必要があります（documentation/HARNESS_IDENTITY.md）。

設定

$XDG_CONFIG_HOME/agent-deck/config.toml（既定値は ~/.config/agent-deck/config.toml。従来の ~/.agent-deck/config.toml も引き続き使用されます）。すべてのオプションについては、config-reference.mdを参照してください。

次に確認する場所

上記のコマンド以外の操作を行う前に、該当するリファレンスを読んでください。

タスクの内容読むもの
agent-deck と各セッションの CLI（claude、codex、gemini）でできること、子セッションに使用する -c ツールの選択capabilities.md
セッション間のメッセージ送信、send の配信保証、output、children、inbox drain、handoff、送信時の注意点session-communication.md
サブエージェント（launch-subagent.sh）の起動、取得モード、ワーカープロンプトの慣例、完了を示すセンチネル ===AGENTDECK_DONE===、Codex または Gemini への相談、ルートレベルのピア（-no-parent）sub-agents.md
複数の子セッションへの処理の分散と、ブロックせずにそれらを監督する方法fleet skill
conductor（conductor setup）、Telegram／Slack チャネル、ウォッチャー（webhook、GitHub、ntfy、Slack）conductors.md、次にカスタムウォッチャーについては documentation/WATCHERS.md
コンテキストの確認（session context）、ワークツリー、スクラッチセッション（try）、ランタイムの健全性（health、デッドレター、remote update --from-build）、リコールのヒントと検索、セッション共有、別の Claude アカウントへのセッションの切り替えsession-workflows.md
自己改善（トランスクリプトのマイニング）、目標（目標主導のワーカーの自律性）、完了報告を鵜呑みにせず検証することautonomy.md、次に詳しい説明については self-improvement.md または goal.md
agent-deck をデーモンスーパーバイザーとして使用すること（その用途には対応していません）、既知の問題と回避策（--no-wait の Enter フォールバック、text file busy、-c "claude <subcommand>"、設定の不整合、チャネル登録、Telegram conductor のトポロジー、v1.9.x の調査結果）、および 1.16.11 より新しい deck が必要な機能gotchas.md
TUI のキー、ダイアログ、検索、レイアウトtui-reference.md
エラー状態のセッション、MCP が読み込まれない場合、診断、サポートの依頼、バグの報告troubleshooting.md
Docker でサンドボックス化されたセッションsandbox.md
永続的なセッションのヒントとタグ、ハーネス間で共有されるトランスクリプトインデックス、recall context --into current、フェデレーション検索、recall MCP サーバーrecall skill
別の開発者向けのセッションのエクスポートまたはインポートsession-share skill
ユーザーレベルとプールレベルのスキル、スキルの追加と切り離しdocumentation/SKILLS.md
agent-deck 自体の修正と PR の作成agent-deck のチェックアウトにある .github/skills/agent-deck-contributor/SKILL.md。PR の受付ゲートを反映し、サンドボックス内でテストを実行します

コメント

Markdown 対応