用途:当宿主 AI 需要把编码、审查、分析、研究、文档或内容子任务交给外部 AI 进程(Codex、Claude Code、Antigravity CLI、Gemini CLI、Kimi CLI、OpenCode、Qwen Code 等)执行,而不是在当前会话内直接完成时使用。注意它调用的是外部 AI 进程,不涉及宿主内置子代理。若当前代理可自行完成、或只需一次性本地 shell 命令且无编排/监控/注入顾虑,则不应调用。
主要能力:任务边界拆分、独立 workdir、防注入 prompt 写法、模型分级矩阵、Worktree 审批门、Anti-Fake-Fix 三步验证;支持显式指定执行器+模型+推理深度,或仅给执行器家族由任务难度自动选型;每次调用后可输出 Token/费用汇总、模型完整性检测、额度预检与断点恢复。各执行器详细命令模板按需从 references/ 加载。
使用方式:用自然语言说明目标并提供文件、URL、repo、workspace 等输入;代理先判断是否命中本技能,再检查依赖、配置、权限与风险动作;能 dry-run 的先预览,涉及删除、覆盖、发送、发布或写远端状态时先征求确认;执行后验证真实输出。安装命令:npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-agent-cli-dispatch -y。自动路由可调用 python3 scripts/route_model.py --executor codex --complexity hard。配置默认读取 ~/.config/soia-skills/soia-open-skills/soia-dev/soia-dev-agent-cli-dispatch/config.yml,也可用 SOIA_DEV_AGENT_CLI_DISPATCH_CONFIG_FILE 指定;凭据只能放私有配置、环境变量或 provider 登录态。
核心原则与限制:先定义任务边界再启动代理;每个代理须有独立 workdir;长任务默认后台运行并定期汇报进度;git worktree add 属不可逆操作,须用户明确批准;禁止在凭据目录、用户配置目录或未知目录直接启动编码代理。派发前须自查 CLI 是否安装、认证/套餐是否有效、上次派发是否失败,不可服务的执行器不得派发。Gemini CLI 消费者 Google OAuth 自 2026-06-18 起停止服务,应迁移到独立命令 agy;禁止 alias、静默替换命令或跨通道套用计费结论。声称全量 benchmark 覆盖前须具备模型发现快照、档位发现证据、完整 case 清单、逐 case 原始 manifest 与聚合报告,否则标记 partial_coverage。Ollama 不属于本技能派发范围。具体可用模型、档位与实测数据以各 CLI 实际输出为准,多数评测状态为 pending_benchmark 或 blocked_auth,样本有限,不构成长期基准。