用途
该技能用于当任意宿主 AI 需要把编码、审查、分析、研究、文档或内容类工作，派发给外部 AI 模型/CLI（Codex、Antigravity CLI、Gemini CLI、Kimi CLI、OpenCode、Qwen Code，或单独启动的 Claude Code 进程）执行，而不是继续在当前 agent 会话中直接完成。它强调的是调用外部 AI 进程，而不是使用宿主内置的子代理。
主要能力
调度外部 AI 模型/CLI 进行受控派发，覆盖编码、审查、分析、研究、文档和内容任务，包括：任务边界拆分、独立 workdir、防注入 prompt 写法、模型分级矩阵、Worktree 审批门、Anti-Fake-Fix 三步验证。在此之上可显式指定执行器+模型+推理深度，或只给执行器家族由任务难度自动选型。每次调用后输出 Token/费用汇总、模型完整性检测、额度预检与断点续跑。各执行器详细命令模板在 references/ 子目录下按需加载。
使用方式
用自然语言说明目标，并提供必要输入：文件、URL、repo、workspace、proposal、vault 或平台账号状态。Agent 先判断是否命中本技能，再检查依赖、配置、权限和风险动作。能 dry-run 或预览的动作先给预览；涉及删除、覆盖、发送、发布、写远端状态时先征求客户确认。执行后验证真实输出，不用“看起来成功”代替证据。最终回复必须给出客户可见总结：做了什么、日志摘要、文件变化、问题和下一步。
安装命令（单个技能）：
npx skills add soia-team/soia-open-dev-coding-skills -g -a '*' -s soia-dev-agent-cli-dispatch -y
配置约定路径：~/.config/soia-skills/soia-dev-agent-cli-dispatch/config.yml，也可用环境变量 SOIA_DEV_AGENT_CLI_DISPATCH_CONFIG_FILE 指定自定义配置路径。若不需要私有配置，可不创建 config.yml。
触发条件
满足任一即调用：需要把编码、审查、分析、研究、文档或内容子任务交给外部 AI CLI 执行；需要为子 agent 生成 prompt（防注入 temp 文件写法）；需要后台启动长任务（受控 workdir + 进度监控）；需要多 agent 并行（依赖/分配矩阵/派发计划）。不需要调用：自己直接执行代码任务（无派发动作）。
核心原则
先定义任务边界再启动代理；每个代理必须有独立 workdir；长任务默认后台运行并定期汇报进度；git worktree 必须事先获得用户明确批准才能开；禁止在凭据目录、用户配置目录或未知目录直接启动编码代理；所有源代码文件必须携带元数据头。
适用场景
把一个工程任务拆给其他编码代理并行执行；把简单但需要外部 AI 执行、复核或留痕的任务受控派发出去；在受控工作目录中启动长时间运行的编码任务；对子任务执行结果做收集、汇总和复核。
限制与边界
不适用：不发生外部 AI 派发、只由当前 host 或本地工具直接完成的动作；需要立刻得到结果、无法承受异步后台执行；还没有明确子任务范围、工作目录和验收标准。任务简单不是排除条件，只要需要由外部 AI CLI 执行，就按风险、输入范围和验收要求选择最小充分的派发方式。
执行器可用性不得假设，派发前需自查：CLI 是否已安装（which 或 --version）；认证/套餐是否有效（优先使用官方本地状态命令，无该命令时不得把模型调用伪装成只读检查）；上一次派发是否失败。不可服务的执行器不得派发。
Google 认证通道不得混用：Gemini CLI 消费者 Google OAuth 自 2026-06-18 起已停止服务，应迁移到独立命令 agy；Gemini Code Assist Standard/Enterprise、Gemini API Key 和 Vertex AI 通道仍保留在 gemini 执行器中。禁止 alias、静默替换命令、复制 OAuth 文件或把一个通道的套餐/计费结论套到另一个通道。
关于模型推荐：文档中的模型名称、版本号和档位命名仅供参考，以各 CLI 的 --version / models / --help 实际输出为准，版本号会随时间过期。声称“全模型 × 全推理档位已测试”前必须同时具备模型发现快照、档位发现证据、完整笛卡尔积 case 清单、逐 case 原始 manifest.json 和聚合报告，缺少任一项标记 partial_coverage。价格目录中的 availability 只表示价格资料列出该模型，不等于当前账号/CLI 已验证可调用。
本技能不硬绑定任何具体编排系统；日志与完成回执最低格式包含完成说明、日志摘要、文件变化、验证和问题与下一步。