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 初始化
• 发送提示词

结果获取模式

模式	命令	何时使用
即发即忘	(不含 --wait)	默认。你可以说："做好准备时问我"
按需查询	agent-deck session output "名称"	当用户询问时
阻塞等待	--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"

# 如果状态为 ◐（等待中）——代理已结束，获取结果：
agent-deck session output "Researcher"