代理指挥家 MJorgin/dsh-agent-conductor

⚡ dsh-agent-conductor

让你的 DeepSeek Harness 智能体把任务派发给 11 个外部智能体命令行工具 —— Codex、Claude Code、TraeCode、OpenCode、Gemini、Cursor、Kimi、Qwen、Copilot、WorkBuddy、Grok —— 全程无头运行，再把结果带回对话。

English · 简体中文

DeepSeek Harness 是很强的推理引擎 —— 但有些活儿交给另一个编码智能体更合适：让 Codex 做翻译、让 Claude Code 查问题、让 Cursor 做重构。这个插件让你的 DSH 智能体判断何时该委派（靠技能描述匹配）、把自包含的任务派发给 11 个外部智能体命令行工具之一，以无头模式运行，再把 stdout 结果作为答案带回。

灵感来自 Multica —— 把「智能体小队」这个想法做成零安装的 DSH 技能。

🎯 什么时候用 Conductor

- 独立第二意见： 让 Codex、Claude Code 或 Gemini 评审同一份设计，对比它们的推理。
- 遗留代码排查： 让一个智能体追调用链，另一个查风险、回归和迁移方案。
- 跨模型实现： 用工具链或模型更贴合任务的智能体，再把结果带回 DSH。

✨ 你能得到什么

| 能力 | 作用 | 成本 |
| 🧠 自动触发派发 | 说一句「让 Codex 翻译这份 README」—— 模型匹配到技能，运行派发脚本，用结果作答 | 免费（消耗目标命令行工具的额度） |
| 🔧 conductor_dispatch 工具（可选打包） | 同一份注册表，作为一等 DSH 工具，一条命令装进配置档 | 免费 |
| 🩺 doctor 自检 | python3 dispatch.py doctor 探测哪些命令行工具已安装（解析 PATH + 试跑 --version），派发前先摸清底细 | 免费 |
| 👀 试运行预览 | 预览目标、工作目录、argv 和等价的 shell 命令，不启动外部智能体 | 免费 |
| 👥 11 个智能体命令行工具 | Codex、Claude Code、TraeCode、OpenCode、Gemini、Cursor、Kimi、Qwen、Copilot、WorkBuddy、Grok | 各自的登录额度 |
| 🔒 隐私 | 任务文本只发给该命令行工具自己的服务商，密钥留在本地 | — |

🧭 为什么做成技能（而不只是插件）

| | 配置档插件 / 打包 | 动态插件 | 技能（本仓库） |
| 安装 | 写配置档 + 重启 | 在会话内定义 | 复制一个文件夹 |
| 触发 | 手动 | 模型调用工具 | 描述匹配，模型自动识别 |
| 风险 | 会动到宿主机 | 会话级，重启即消失 | 只读脚本，与宿主机无关 |
| 结果 | 工具结果 | 工具结果 | stdout 直接成为答案 |

一份 SKILL.md + 一个零依赖的 dispatch.py（只用 Python 标准库）。

⚡ 快速开始（技能）

把 skills/conductor/ 复制到任意技能根目录（项目级 .dsh/skills/ 或全局 ~/.dsh/skills/）：

mkdir -p .dsh/skills/conductor
cp -R skills/conductor/. .dsh/skills/conductor/

不用重启——从下一条消息开始，直接说：

- “派 codex 把这份 README 翻译成繁体中文”
- “让 Claude Code 查一下这个报错的成因”
- “用 Codex 独立实现一个 XXX”

智能体会自动识别需求（SKILL.md 描述匹配）→ 运行 dispatch.py → 返回结果。

遇到不熟悉、或可能产生写入的派发任务，先预览一遍，不消耗目标智能体的额度：

python3 skills/conductor/scripts/dispatch.py --dry-run claude-code "Read src/auth.ts and explain the token refresh flow. Do not edit files."

🧭 智能体能力矩阵

| 任务 | 首选 | 理由 |
| 架构评审 / 第二意见 | Codex、Claude Code、Gemini | 不同的推理风格有助于发现设计盲点 |
| 遗留代码调用链排查 | Claude Code、Codex、Copilot | 擅长追踪仓库内的依赖关系并附上证据 |
| 以 GitHub 为中心的 issue 或 Actions 分析 | Copilot、Codex | 天然适合仓库、拉取请求和 CI 诊断 |
| 与编辑器耦合的重构 | Cursor、Codex | 工作流与现有项目树紧密相连时很有用 |
| 中文本地化 / 中文文档 | TraeCode、Qwen、Kimi、Codex | 中文能力强的选项；在任务中保持术语一致 |
| 快速替代实现 | OpenCode、Qwen、Kimi | 适合有独立登录 / 工具链的限时探索 |

这张矩阵只是路由的起点，不是硬性规则。优先选已安装、已登录、且能访问正确工作区的命令行。

📋 可直接复制的派发配方

1. 安全诊断：

You are investigating a bug in the current repository. Do not edit files.
Reproduce the issue from this description: <paste error and steps>.
Read only the minimum relevant files. Return:
1) root cause, 2) evidence with file:line, 3) three ranked fix options,
4) tests that should be added or updated.

2. 独立架构评审：

Review this design as an outside staff engineer. Do not assume hidden context.
Design summary: <paste PRD/technical plan>.
Challenge scalability, failure modes, security boundaries, and migration risk.
先返回分歧；每条都要给出影响、证据和兜底方案。

3. 测试驱动的实现：

在当前仓库实现这项改动：<范围与验收标准>。
小步推进。条件允许时先补测试或改测试。
收尾前跑一遍相关测试命令，并汇报：改动文件、已跑测试、剩余风险、后续工作。

🛠️ 前置条件：安装你要分派的命令行

Codex / Claude Code / OpenCode / Gemini / Qwen
npm i -g @openai/codex
npm i -g @anthropic-ai/claude-code
npm i -g opencode-ai
npm i -g @google/gemini-cli
npm i -g @qwen-code/qwen-code
Kimi / Grok / Copilot (headless flags verified against each CLI's own --help)
npm i -g @moonshot-ai/kimi-code
npm i -g @xai-official/grok
npm i -g @github/copilot
TraeCode CLI: https://docs.trae.cn/cli_command-line-parameters
(already have codex-cli? symlink instead: ln -s ~/.codex/plugins/.plugin-appserver/codex ~/.local/bin/codex)

无头模式说明：Copilot 的非交互模式必须自动批准工具，所以注册表里跑的是 copilot -p "<task>" --allow-all-tools。其他命令行用各自标准的 print/无头参数。

然后检查这台机器上实际能分派哪些命令行：

python3 skills/conductor/scripts/dispatch.py doctor
✅ Codex …/codex — codex-cli 0.151.0 …
❌ Gemini … 未找到 gemini → 安装：npm i -g @google/gemini-cli

工作目录自动探测。 打包工具会在当前会话的工作区（exec.agent.session.header.cwd）里跑每个命令行，其次用 CONDUCTOR_CWD，最后用 harness 的 cwd —— 没有写死的路径。Codex 仍要求一个受信任的 git 仓库：如果自动探测到的目录不受信任，就把 CONDUCTOR_CWD=/path/to/git/repo 指向一个受信任的仓库（环境变量或 ~/.dsh/secrets/media-tools.env 都行）。技能脚本认 CONDUCTOR_CWD，没有就回退到当前目录。
想让分派出去的智能体写文件：在 Codex 的 ~/.codex/config.toml 里加上 sandbox_mode = "workspace-write"。
分派会消耗目标命令行的登录额度。

✅ 已验证 vs ⏳ 待验证

| 命令行 | 无头命令 | 状态 |
| Codex | codex exec "{task}" | ✅ 实测通过（翻译任务已交付） |
| Claude Code | claude -p "{task}" --output-format text | ✅ 已安装；依据官方文档 |
| TraeCode | traecli exec "{task}" | ✅ 依据官方文档 |
| OpenCode | opencode run "{task}" | ✅ 依据官方文档 |
| Gemini CLI | gemini -p "{task}" | ✅ 依据官方文档 |
| Qwen Code | qwen --prompt "{task}" | ✅ 依据官方文档（Gemini-CLI 分支） |
| Kimi CLI | kimi --prompt "{task}" | ✅ 参数已从命令行自身的帮助确认（-p, --prompt = 非交互） |
| Copilot CLI | copilot -p "{task}" --allow-all-tools | ✅ 参数已从 copilot --help 确认（可执行文件是 copilot，不是 github-copilot；无头模式必须加 --allow-all-tools） |
| Grok CLI | grok -p "{task}" | ✅ 依据官方 README（grok -p "..." = 跑一个任务） |
| Cursor CLI | cursor-agent -p "{task}" | ⏳ 命令形式待实测（从 cursor.com 安装；npm 上的 cursor-agent 包与此无关） |
| WorkBuddy | workbuddy -p "{task}" | ⏳ 命令形式待实测 |

安装包已对照 npm registry 核实：Kimi 是 @moonshot-ai/kimi-code（可执行文件 kimi），Grok 是 @xai-official/grok（可执行文件 grok），Copilot 是 @github/copilot（可执行文件 copilot），Codex 是 @openai/codex。kimi-cli 这个 npm 包是无关的占位包，没有可执行文件——不要用它。

📦 可选：打包安装（仅宿主侧工具）

这个仓库同时也是一个仅宿主侧的 dsh 包（声明了 dsh.bundle，零客户端代码——Web UI 不受影响）。一条命令就能把 conductor_dispatch 工具装进配置档：

dsh plugin --profile web add dsh-agent-conductor

或者直接从 GitHub 装：dsh plugin --profile web add github:MJorgin/dsh-agent-conductor。

- 工具和技能共用同一份 CLI 注册表（index.js ⇄ conductor-dynamic.js ⇄ dispatch.py——新增 CLI 时三处要同步改）；
- 没有客户端部分，所以 Web UI 永远不受影响（早期带面板的客户端版本已移除——见 git log）；
- 宿主侧执行做了加固：支持 dry-run 预览，显式声明 subprocess 依赖，强制 10 分钟真实超时并终止整个进程树（取消时同样如此——不会留下孤儿 CLI），超长输出会被裁剪（保留头尾，约 20k 字符），话多的智能体撑不爆上下文；
- 面板 / 任务板回收在路线图里。

📂 仓库结构

index.js # bundle host half: conductor_dispatch tool (host-only)
cordis.patch.yml # bundle layer (one row, no client)
skills/conductor/SKILL.md # skill definition: trigger description + dispatch rules + privacy
skills/conductor/scripts/dispatch.py # dispatch engine (Python stdlib, zero deps)
conductor-dynamic.js # alternative: dynamic-plugin edition (cordis_define route)

🗺️ 路线图

- [x] doctor 健康检查与 dry-run 预览
- [ ] 按能力、速度、成本路由
- [ ] 面板 UI（可选，动态插件客户端部分）
- [ ] 任务板回收：把派发结果写回 dsh-task-board 卡片
- [ ] 小队编排：一个任务分发给多个智能体再合并（Multica squads 形态）

🔑 密钥与隐私

- 密钥从不存进这个仓库。技能脚本先读环境变量，再读 ~/.dsh/secrets/media-tools.env（与 dsh-media-skills 同一约定）。
- 任务文本会发给目标 CLI 的服务商——别把密钥或内部数据写进任务。
- 结果归目标 CLI 的服务条款管；交付物请标注「由 <agent name> 完成」。

License

MIT

相关

- 🎨 dsh-media-skills — 给 DSH 用的免费视觉与图像生成（GLM-4V-Flash + Qwen3-VL + Gemini 故障转移）
- 📬 社区收录 PR：awesome-dsh-plugin#664
- 📋 awesome-dsh-plugin · 生态索引：dsh-plugin topic
- 🎯 基准项目：Multica（多智能体工作台）· dsh-web-ui（任务看板）