用途:Dispatch 是 AI 智能体编排 CLI,把工作项转成可运行代码。流水线为 Issues → --spec → 规格文件 → dispatch → 规划 → 执行 → 提交/PR。工作项来源包括 GitHub Issues、Azure DevOps 和本地 markdown 文件。
主要能力:用 dispatch --spec 生成规格(--spec 42、--spec 42,43、--spec "文本" 或 --respec 42 重生成);dispatch 42 执行(规划+执行);dispatch ".dispatch/specs/*.md" 按 glob 执行;--dry-run 预览任务;--no-plan 跳过规划;--provider claude 指定提供方;--concurrency 4 并行;--fix-tests 运行并修复测试;--feature 名 42,43 合并到同一特性分支;dispatch config 交互式配置。其他标志:--plan-timeout、--retries、--spec-timeout、--no-branch、--no-worktree、--verbose。
关键纪律:不要对前置未实现的 Issue 生成规格。规格会探索当前代码库,依赖缺失会导致规格错误。先分析全部 Issue 建依赖图,按层排序:Layer 0 无依赖可并行 spec 与执行,Layer 1 依赖 Layer 0,需等前层执行完成后再 spec,依此类推。层内可并发。未确认依赖已存在于代码库时先不要 spec。
规格内任务顺序:--spec 会自动生成带 (P) 并行安全、(S) 串行/依赖、(I) 隔离/屏障标记的任务;连续 (P) 任务并发运行,(S) 收束当前组,(I) 清空后单独运行,组间顺序执行。
常见工作流:单 Issue 完整流水线(spec → 查看 .dispatch/specs/42-*.md → dry-run → 执行);多个独立 Issue 并发 spec 与执行;依赖链逐层执行;内联描述生成规格后按 glob 执行;--no-plan 快速修复;--fix-tests 修复测试;--feature 分组到同一分支。
限制与排错:规格引用不存在的代码说明前置未执行,需先执行前置再 --respec;任务报 file/symbol not found 同理需按依赖顺序执行;规划超时可用 --plan-timeout 或 --no-plan;任务未提交可 --respec 让规格代理嵌入提交说明。资料未提供具体版本、价格与平台支持细节。