OpenCode Swarm

OpenCode Swarm 是一个以架构师为中心的多智能体协作编排插件，采用 hub-and-spoke 架构模式，将单个 AI 编码会话转化为由 architect 主导的专家团队协作。

核心能力#

多智能体编排：内置 17+ 专业 agent 角色（architect、coder、reviewer、test_engineer、critic 等），分三类管理——Core（始终可用，9 个）、Optional（默认启用可禁用，5 个）、Conditional（需特定功能配置，3 个）。Architect 作为中心枢纽协调所有专业 agent，agent 之间不会并行修改代码库。

门控流水线：每任务执行 5 步流水线（pre_check_batch → coder 实现 → reviewer 审查 → test_engineer 测试 → architect 回归扫描）。代码提交前必须经过 reviewer + test_engineer 双重审批；阶段完成需通过 completion-verify 和 drift-verifier 门控。防幻觉验证（critic_hallucination_verifier）校验引用 API 的真实性；计划漂移检测（critic_drift_verifier）作为阻塞门控验证实现与规格一致性；占位符/TODO 扫描拒绝包含未完成桩代码的提交。

安全与质量：内置 SAST 扫描（63+ 规则，覆盖 9 种语言，完全离线执行）、secrets scanning、dependency audit。strict 项目模式下启用 slop-detector 检测低质量输出。

执行与项目模式：三种执行模式（Balanced 默认高安全 / Turbo 快速迭代跳过非关键门控 / Full-Auto 无人值守 critic_oversight 独立审批）和三种项目模式（strict / balanced / fast）。可与 OpenCode Zen 的免费模型列表配合使用。

多语言支持：通过 Tree-sitter WASM（web-tree-sitter + @vscode/tree-sitter-wasm）实现 20 种编程语言的语法解析与安全扫描，包括 TypeScript、Python、Go、Rust、Java、Kotlin、C/C++、C#、Ruby、Swift、Dart、PHP、JavaScript、CSS、Bash、PowerShell、INI、Regex。

状态持久化：所有会话状态保存在项目根目录 .swarm/ 下（plans、evidence、context、knowledge、telemetry），支持跨会话恢复。

架构与实现#

基于 TypeScript + Bun 运行时（>=1.3.13）构建，使用 Zod（^4.1.8）进行运行时类型校验，Biome（v2.3.14）管控代码质量。通过 @opencode-ai/plugin（^1.1.53）和 @opencode-ai/sdk（^1.1.53）接入 OpenCode 插件体系。CLI 入口为 dist/cli/index.js，Bun build 输出 ESM 格式配合 tsc 生成类型声明。

安装与使用#

前置条件：Bun 运行时及 OpenCode。

bunx opencode-swarm install

该命令执行：安装包 → 注册为 OpenCode 插件 → 禁用冲突的默认 agent → 创建配置文件。也可使用 npm：npm install -g opencode-swarm && opencode-swarm install。

提供 41 个斜杠命令，关键命令包括 /swarm status（当前阶段和任务）、/swarm plan [N]（查看计划）、/swarm agents（查看注册 agent）、/swarm evidence [task]（查看测试审查结果）、/swarm diagnose（健康检查）、/swarm turbo [on|off]、/swarm full-auto [on|off]。

配置文件位于全局 ~/.config/opencode/opencode-swarm.json 或项目级 .opencode/opencode-swarm.json，可覆盖 agent 模型、禁用特定 agent、调整安全门控等。

待确认事项#

• 文档站（https://opencode-swarm.dev）内容可达性未验证
• 与 opencode-ai/opencode 的具体关系（官方插件或社区第三方）未明确
• 作者 zaxbysauce 背景信息未披露
• v7.7.0（1,388 次提交）的升级路径和兼容性策略需查看 CHANGELOG