SuperAPI AI 工具集

opencode-dispatch

智能体与模型

查看项目

更新于 10-15 20:29

技能介绍

用途:把子智能体任务交给 opencode 执行,而不是宿主 CLI 内置的子智能体运行时。默认走 ACP(Agent Client Protocol),技能本身作为 ACP 客户端,通过固定 HTTP 端口连接或启动 opencode acp,操作者可在另一终端用 opencode attach http://<host>:<port> 查看实时会话并手动引导。

主要能力:ACP 模式支持原生权限中继(无需 --dangerously-skip-permissions 或通配符 allow)、提示与参数以 JSON-RPC 传输避免 shell 注入、标准会话生命周期(initialize、newSession、prompt、setSessionModel、idle 检测),以及通过内嵌 HTTP 服务器实时 attach。每次派发都会在 .opencode-dispatch/<task-id>/ 写入磁盘工件(prompt.json、prompt.md、parts.json、events.jsonl、stdout.log),便于重放与审计。

使用方式:宿主运行时以命名参数调用,必需 --kind、--cwd(绝对路径,须通过 verify-cwd.sh 校验为 git 工作树)、--model、--agent、--prompt-file;可选 --branch、--worktree、--worktree-root、--timeout、--mode(acp 默认、cli、http)、--extra-env。派发流程包括解析意图、校验 CWD、分配任务 ID、按 kind 渲染模板、确保 ACP 后端、初始化并新建会话、发送提示、处理权限询问、等待 idle、运行后校验并返回结果。

适用场景:需要使用宿主不原生支持的开源权重模型(Kimi K2、GLM、Qwen、Llama);需要 attach 到运行中的子智能体进行实时检查或手动引导;任务分散在多个独立文件或仓库并需要按任务隔离(每任务一个 worktree);需要把派发工件落盘以便重放或审计。

限制:一次性提示且冷启动成本占主导、不需要实时 attach 时,建议改用 CLI opencode run;宿主禁止派生长期子进程时也应回退 CLI 模式。CLI 模式需要 --dangerously-skip-permissions,且不支持 parallel-review-fanout。HTTP 模式存在权限中继缺陷(issue #16367),配置为询问权限的工具会挂起。该技能不负责在编辑器内充当 ACP 智能体、不通过 MCP 暴露 opencode、不管理 opencode 认证、不创建 worktree、也不做超出按任务隔离的并行智能体协调。配置默认位于 .opencode-dispatch/config.yaml,固定 acp.port 是实时 attach 的前提。