agent-deck

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>	从文件发送消息（- = stdin）；无需 shell 引号。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.html	在 macOS 应用的 Browser 面板中向用户显示 HTML 报告（也适用于远程会话）
agent-deck add --worktree <branch>	在 git worktree 中创建会话

状态： ● 运行中 | ◐ 等待中 | ○ 空闲 | ✕ 错误

其他所有命令和标志均见 cli-reference.md。

规则

1. 标志放在参数前： 使用 session start -m "Hello" name，而不是 name -m "Hello"。看似被忽略的标志，几乎总是因为位置不正确。
2. 仅在用户要求时使用 MCP： 用户要求时才附加 MCP，然后执行 session restart；仅附加并不会加载 MCP。--global 会为所有项目写入 Claude 的配置；默认情况下则写入会话的 .mcp.json。
3. 让其他会话继续工作： 读取另一个会话时，调用一次 session output 或 session children，不要使用轮询循环，以免干扰目标会话。
4. 子会话的提示词只说明任务。 agent-deck 启动的每个会话 Agent 都已包含其身份信息（会话 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
启动子 Agent（launch-subagent.sh）、检索模式、工作者提示词约定、===AGENTDECK_DONE=== 完成标记、咨询 Codex 或 Gemini、根级同级会话（-no-parent）	sub-agents.md
并行启动多个子级并以非阻塞方式监督它们	fleet skill
指挥器（conductor setup）、Telegram/Slack 频道、watcher（webhook、GitHub、ntfy、Slack）	conductors.md，自定义 watcher 请参阅 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 指挥器拓扑、v1.9.x 的调查结果），以及哪些功能需要高于 1.16.11 的 deck	gotchas.md
TUI 按键、对话框、搜索和布局	tui-reference.md
会话出错、MCP 未加载、诊断、获取帮助或提交 bug	troubleshooting.md
Docker 沙盒会话	sandbox.md
持久会话提示和标签、跨 harness 的转录索引、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 受理门槛，并在沙盒中运行测试