用途：Synapse 是分布式 AI 智能体编排系统，将三类专用服务按角色组合，用于把复杂任务拆解为多步计划、生成实现代码、分析大型代码库、进行代码审查以及执行沙箱命令，也可运行完整的计划—分析—编码—审查—执行流水线。
主要能力与角色：Claude 作为 Orchestrator/Planner，负责任务规划、架构设计与代码生成，默认模型 claude-sonnet-4.5；Gemini 作为 Analyst/Reviewer，负责大上下文分析（>1M tokens）、代码审查与安全审计，默认 gemini-3-pro-preview；Codex 作为 Executor，负责命令执行、构建与自动化测试，默认 gpt-5.2。支持并行专家、顺序流水线、Swarm 自组织和端到端工作流等编排模式，可按角色配置模型。
使用方式：需先运行 Docker 并启动 Synapse 服务，克隆仓库后执行 docker compose up -d，再用 curl -s http://localhost:8000/health 验证网关健康（预期 {"status": "healthy", "service": "gateway"}）。技能可软链接到 ~/.config/opencode/skills/synapse 或 ~/.agents/skills/synapse。主要端点包括 /api/v1/claude/plan、/api/v1/claude/code、/api/v1/gemini/analyze、/api/v1/gemini/review、/api/v1/codex/execute 以及 /api/v1/workflow。可通过 SYNAPSE_HOME 与 SYNAPSE_GATEWAY_URL 环境变量自定义位置和网关地址。
适用场景：复杂任务分解、按描述生成代码、超 20 万 token 的大代码库分析、综合代码评审与质量评分、沙箱内构建测试与自动化。
限制：不适用于无需代码生成的简单问题、仅需本地文件操作的任务，以及 Docker/Synapse 服务不可用时；Codex 仅允许 echo、ls、pwd、date、cat、head、tail、wc、grep、find、python、pip、npm、node、git、make 等命令。