CODE-DISPATCHER TOOLKIT

Multi-Backend AI Coding Toolkit

Dispatch tasks across Codex, Claude, and Gemini with
reusable Skills and workflow tooling.

中文 | English

基于 code-dispatcher CLI 构建的多后端 AI 编码工具集：执行器 + Skills。

为什么叫 Dispatcher

因为这个词的含义很符合这个工具的核心功能：

接收任务  →  选后端  →  构建参数  →  分发执行  →  收集结果

组件

Dispatcher CLI

code-dispatcher 是一个多后端任务分发器，统一调度 codex、claude、gemini 三个 AI 编码工具。核心能力包括：

• 多后端支持：通过 --backend 自由切换或并行调用多个 AI 后端
• 并行执行：使用 --parallel 基于 DAG 调度同时运行多个独立任务
• 会话恢复：使用 --resume 在上下文重置后继续执行未完成的任务
• 统一配置：单点配置 ~/.code-dispatcher/.env 管理所有后端参数

后端定位（仅推荐，可自由指定）：

• codex：复杂逻辑、bug 修复、优化重构
• claude：快速任务、review、补充分析
• gemini：前端 UI/UX 原型、样式和交互细化

Note

工具 code-dispatcher 核心思路基于 cexll/myclaude 的 codeagent wrapper，经大量重构。

Skills

注：依赖指是否依赖 code-dispatcher CLI 进行调度和执行。

名称	用途	依赖
code‑dispatcher	执行器使用说明；统一 3 个后端 codex/claude/gemini；核心机制 --parallel 和 --resume	必需
dev	需求澄清 → 计划 → 选择后端 → 并行执行（DAG 调度） → 验证	必需
code‑council	多视角并行代码评审（2–3 个 AI reviewer 并行 + host agent 终审）	必需
pr‑review‑reply	自主处理 PR 上的 bot review（Gemini / CodeRabbit 等）→ 验证 → 修复或反驳 → 回复线程 → resolve	可选

安装

Step 1: Code Dispatcher CLI 相关核心安装

安装脚本做了全平台适配：WSL2/Linux + macOS + Windows。默认会从 GitHub Release 的 latest 标签下载当前平台二进制：

python3 install.py

可选参数：

python3 install.py --install-dir ~/.code-dispatcher --force
python3 install.py --skip-dispatcher

脚本会添加如下东西：

• ~/.code-dispatcher/.env：运行时唯一配置源
• ~/.code-dispatcher/prompts/*-prompt.md：每个后端的默认 prompt 模板（可编辑，置空则禁用注入）
• ~/.code-dispatcher/bin/code-dispatcher（Windows 上是 .exe，以此类推）

特别需要注意的是：不同平台下 code agent 的 shell 环境并不完全一致，不能默认都按同一套假设执行。

install.py 会直接输出常见 shell 的持久化设置命令（Windows：PowerShell、CMD、Git Bash；非 Windows：Bash、Zsh、Fish），对应如下：

Windows PowerShell:
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$HOME\.code-dispatcher\bin", "User")

Windows CMD:
setx PATH "%PATH%;%USERPROFILE%\.code-dispatcher\bin"

Git Bash (e.g. Claude Code on Windows):
echo 'export PATH="$HOME/.code-dispatcher/bin:$PATH"' >> ~/.bashrc

Bash (e.g. WSL/Linux):
echo 'export PATH="$PATH:$HOME/.code-dispatcher/bin"' >> ~/.bashrc

Zsh (e.g. macOS 默认):
echo 'export PATH="$PATH:$HOME/.code-dispatcher/bin"' >> ~/.zshrc

Fish:
echo 'set -gx PATH "$HOME/.code-dispatcher/bin" $PATH' >> ~/.config/fish/config.fish

Step 2: 安装 Code Dispatcher Skill

根据目标 code agent 工具的配置目录，复制 code-dispatcher 这个 skill 到相关目录。建议全局安装，下面是一些典型位置：

• General： ~/.agents/skills
• Claude Code : ~/.claude/skills
• Codex CLI : ~/.codex/skills
• OpenCode : ~/.config/opencode/skills
• Gemini CLI : ~/.gemini/skills

Step 3: 挑选 Skills

参考各技能的独立文档了解具体用途，然后挑选你需要的功能模块：

Skills：Skill 是跨 agent 通用的功能模块，核心是 SKILL.md 定义文件，部分还包含 references/ 参考文档。安装时将对应的 skill 目录复制到目标 agent 的 skills 目录，以 Claude 为例：

• 全局：~/.claude/skills/<skill-name>/
• 项目级：<path to your project>/.claude/skills/<skill-name>/

其中 dev skill 建议配合注入 templates/dev-skill-constraint.md 到用户级配置。典型用法：

# 显式触发
/dev "我想实现一个xxx"

# 特定关键词触发
use dispatcher --codex to fix the bug we just discussed

可选配置项

运行时参数统一放在 ~/.code-dispatcher/.env。可配置项包含：

• 执行器超时相关参数
• 执行器并行 worker 上限
• 执行器日志输出设置
• 被调用后端模型覆盖（仅 codex/gemini）

完整字段含义请先看：docs/runtime-config.md，未配置时按默认参数运行。

开发/测试

先决环境

• Go：1.21（code-dispatcher/go.mod）
• Python：3.9+（install.py 使用 list[str]）
• Bash：用于本地构建脚本（scripts/build-dist.sh）

运行验证

cd code-dispatcher
go test ./...

# 验证本地构建
cd ..
bash scripts/build-dist.sh

# 验证安装脚本语法与模板引用
python3 -m py_compile install.py

# 不污染真实环境的安装回归（使用临时目录）
tmpdir="$(mktemp -d)"
python3 install.py --install-dir "$tmpdir/.code-dispatcher" --skip-dispatcher --force
python3 install.py --install-dir "$tmpdir/.code-dispatcher" --force
rm -rf "$tmpdir"