用途:OpenCode Ensemble 是协调系统,而非替代判断的捷径。并行智能体在 lead 负责拆解、排序、审查、合并与验证时效果最好。该仓库内置上游 hueyexe/opencode-ensemble 技能(tag v0.14.2),并针对本 OpenCode 配置调整模型指引。
主要能力:支持团队规划、波次规划、集成、模型指引与适用性检查。核心概念包括 lead、teammate、wave、role group、gate。并行波次建模为一个 lead 拥有的团队,用 team_tasks_add.depends_on 编码波次 DAG,team_spawn.claim_task 绑定任务,波次间由 lead 把关。
使用方式:先判断并行是否合理,用 team_create 建团队,team_tasks_add 加任务并记录返回 ID,team_spawn 逐个生成 teammate(只读探索用 worktree:false,高风险实现用 plan_approval:true),等待消息而非轮询,用 team_results 读取完整结果,team_shutdown 关闭,team_merge 合并并检查 diff,最后运行项目验证再 team_cleanup。角色默认:Scout 用 explore、无 worktree;Builder、QA 用 build、有 worktree;Reviewer 用 explore、无 worktree。建议从两三个 teammate 起步,5-8 个为合理上限。
适用场景:工作可拆为独立研究、实现、测试或审查切片;只读 scout 先摸清陌生代码;多文件或子系统无重叠改动;高风险变更需 plan_approval;最终审查者检查合并结果;可表示为分阶段波次。
限制:任务小、紧耦合、lead 无法描述每个 teammate 的输出与成功标准、需要单一连贯设计决策、仅因任务难但不可分、需一个 lead 同时运行多个活跃团队、需 teammate 子智能体使用 team_* 工具时,不应使用。一个 lead 只能拥有一个活跃团队;teammate 创建的子会话被有意禁止使用 team_* 工具。修改本技能后需运行 python scripts/check.py 与 uv run pytest tests/test_distribution_metadata.py tests/test_sync_agent_stack.py -q。