核心功能
Claude Code Dispatch 是一种任务代理技能,旨在将超出当前代理能力范围的复杂编码任务委托给 Claude Code CLI 处理。其核心定位是文件系统交互代理,弥补了纯对话式 AI 无法直接操作本地文件、执行 Shell 命令的短板。
该技能通过封装 invoke-claude.sh 脚本,提供标准化的 CLI 调用接口,支持文件读写(Read/Edit/Glob/Grep)与 Shell 命令执行(Bash)两大能力集群,并可灵活配置模型(Sonnet/Opus/Haiku)与工具权限。
显著优势
1. 权限粒度可控:通过 --tools 参数精确限定 Claude Code 的操作范围,从只读审查到全功能编辑均可配置
2. 成本透明化:内置预算控制与成本估算,便于团队管控 API 开支
3. 模型智能路由:根据任务复杂度自动推荐模型——Haiku 处理简单重构、Sonnet 应对常规调试、Opus 负责架构级多文件修改
4. 环境继承:自动继承宿主机的环境变量与 API 密钥,无需重复配置
潜在局限
- 并发限制:同一工作目录禁止并发调用,需手动串行化任务队列
- 无状态会话:每次调用独立执行,不支持多轮对话,复杂任务需一次性提供完整上下文
- 输出截断:2000 字符后的响应会被截断,超长输出需配合文件写入或分页策略
- 前置依赖苛刻:必须预先在
~/.claude/settings.json中授权工具权限,否则非交互模式直接失败
适用人群
- 需要自动化代码审查的 CI/CD 流水线维护者
- 从事大型项目重构、需跨文件协调的开发者
- 希望将 AI 编码助手集成到现有 IDE/编辑器工作流的高级用户
- 需批量处理代码库(如统一升级依赖、迁移语法)的 DevOps 工程师
常规风险
- 配置泄露风险:
settings.json若配置过于宽泛(如Bash(*:*)),可能导致任意命令执行 - 工作目录污染:Claude Code 拥有直接文件写入权限,误操作可能破坏代码库
- 成本失控:Opus 模型在处理大型代码库时代价高昂,需严格设置
--budget上限 - 超时中断:默认 300 秒超时可能不足以完成复杂构建任务,需根据项目规模调整