artwist-polyakov/polyakov-claude-skills

Agent Deck CLI

AI 代理的終端會話管理器。允許啟動、監控並獲取子 Claude 會話的結果。

啟動子代理

觸發詞：「啟動代理」、「啟動子代理」、「launch sub-agent」

簡單啟動（CLI 命令）

# 建立會話
agent-deck add -t "名稱" -c claude /path/to/workdir

# 建立為目前代理的子會話
agent-deck add -t "名稱" --parent "父級" -c claude /path/to/workdir

# 啟動
agent-deck session start "名稱"

# 傳送任務
agent-deck session send "名稱" "你的任務..."

自動啟動（腳本）

scripts/launch-subagent.sh "名稱" "提示" [--mcp exa] [--wait]

腳本會自動：

• 判斷目前會話與設定檔
• 建立子會話
• 等待 Claude 初始化
• 傳送提示

結果獲取模式

模式	指令	使用時機
Fire & forget	(不加 --wait)	預設。告知：「準備好時問我」
On-demand	agent-deck session output "名稱"	當使用者主動詢問時
Blocking	--wait	需要立即取得結果

---

檢查狀態

觸發詞：「檢查會話」、「檢查狀態」、「check session」

agent-deck status                      # 所有會話（摘要）
agent-deck session show "名稱"         # 特定會話的詳細資訊
agent-deck session show -json "名稱"  # JSON 格式
agent-deck session current             # 目前所在的工作會話
agent-deck session current --json      # 目前會話的 JSON 格式

狀態：

• ● 執行中 (running)
• ◐ 等待輸入 (waiting)
• ○ 閒置中 (idle)
• ✕ 錯誤 (error)

---

獲取結果

觸發詞：「顯示代理輸出」、「代理回答了什麼」、「show agent output」

agent-deck session output "名稱"

---

MCP 連線

agent-deck mcp list                        # 列出可用的 MCP 伺服器
agent-deck mcp attach "名稱" exa           # 將 MCP 連接到會話
agent-deck session restart "名稱"          # 連線後「務必」重新啟動！

建議的 MCP

任務	MCP 伺服器
網路搜尋	exa, firecrawl
程式碼文件	context7
複雜推理	sequential-thinking

---

會話管理

# 生命週期
agent-deck session start "名稱"
agent-deck session stop "名稱"
agent-deck session restart "名稱"

# 列出所有會話
agent-deck ls
agent-deck ls -json

# 刪除會話
agent-deck rm "名稱"

---

重要規則

1. 旗標放在引數前面： session show -json name（而非 session show name -json）
2. 執行 mcp attach 後務必使用 session restart 以套用變更
3. 避免輪詢其他代理的結果 — 這可能干擾目標會話
4. **會話識別：**可使用名稱、ID（≥6 個字元）或路徑

---

使用範例

啟動研究代理

# 建立一個用於網路研究的代理
agent-deck add -t "Researcher" -c claude --mcp exa /tmp/research
agent-deck session start "Researcher"
agent-deck session send "Researcher" "尋找最新的 AI 趨勢資訊"

檢查就緒狀態

# 檢查狀態
agent-deck session show "Researcher"

# 如果狀態為 ◐ (waiting) — 代理已完成，取得結果：
agent-deck session output "Researcher"