@zcy2nn/agent-forge

v1.3.3

Published

22 days ago

Lightweight agent orchestration plugin for OpenCode - a slimmed-down fork of oh-my-opencode

0High
0Medium
0Low

zcy2nn

opencode opencode-plugin ai agents orchestration llm claude gpt gemini

这是什么

agent-forge 是 OpenCode 的 Agent 编排插件。内置 Orchestrator（主协调者）、Workflow（流程专家）和四个专家 Agent（Advisor、Researcher、Reviewer、Implementer）。Orchestrator 负责任务路由和委派，Workflow 负责运行 Superpowers 流程并协调专家，Advisor 负责只读讨论和方案分析，Researcher 负责代码库搜索和外部文档检索。

核心理念很简单：将搜索工作委派给 Researcher，Orchestrator 专注于编码和执行，Workflow 运行完整的流程驱动开发，通过 Skill 系统动态扩展能力（如 brainstorming、writing-plans、TDD 等），在 质量、速度、成本 之间取得最优平衡。

当前架构为 6 Agent 模式：Orchestrator（轻量调度器 + 编码执行）+ Workflow（流程驱动 + 专家协调）+ Advisor（只读讨论与方案分析）+ Researcher（搜索专家，只读）+ Reviewer（审查专家）+ Implementer（实现专家）。Workflow 是 Superpowers 流程的默认载体，自动加载流程 Skills；Orchestrator 是默认会话 Agent，可按需加载 Skills。

要了解各个 Agent，见 认识众神。完整功能列表见 功能与工作流。

快速开始

将以下提示复制粘贴到你的 LLM Agent（Claude Code、AmpCode、Cursor 等）：

Install and configure agent-forge: https://cnb.cool/zcyoop/ai-assistant/agent-forge/-/git/raw/master/README.md

手动安装

bunx @zcy2nn/agent-forge@latest install

安装器会同时在 OpenCode 的 tui.json 中注册 TUI 插件，在侧边栏显示 Agent 状态和任务会话。手动安装时，需在 opencode.json 和 tui.json 的 plugin 数组中添加 @zcy2nn/agent-forge。

开始使用

安装器默认生成 OpenAI 和 OpenCode Go 两套预设，OpenAI 为默认激活。OpenAI 使用 openai/gpt-5.5 作为高判断力 Agent 的模型，openai/gpt-5.4-mini 作为快速执行 Agent 的模型。要使用 OpenCode Go，运行 bunx @zcy2nn/agent-forge@latest install --preset=opencode-go，或安装后在 ~/.config/opencode/agent-forge.json 中修改默认预设。

安装后：

登录你需要的 Provider：
```
opencode auth login
```
刷新 OpenCode 可见的模型列表：
```
opencode models --refresh
```
打开你的插件配置文件：~/.config/opencode/agent-forge.json
按需调整各 Agent 的模型

[!TIP] 建议理解自动委派的工作方式。Orchestrator prompt 包含委派规则、专家路由逻辑和阈值。你也可以手动委派：@agentName <task>

默认生成的配置包含 openai 和 opencode-go 两套预设：

{
  "$schema": "https://cnb.cool/zcyoop/ai-assistant/agent-forge/-/git/raw/master/agent-forge.schema.json",
  "preset": "openai",
  "presets": {
    "openai": {
      "orchestrator": { "model": "openai/gpt-5.5", "skills": ["*"], "mcps": ["*", "!context7"] },
      "workflow": { "model": "openai/gpt-5.5", "skills": ["*"], "mcps": ["*", "!context7"] },
      "advisor": { "model": "openai/gpt-5.5", "skills": [], "mcps": [] },
      "researcher": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": [], "mcps": ["context7"] },
      "reviewer": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": [], "mcps": [] },
      "implementer": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": [], "mcps": [] }
    },
    "opencode-go": {
      "orchestrator": { "model": "opencode-go/glm-5.1", "skills": [ "*" ], "mcps": [ "*", "!context7" ] },
      "workflow": { "model": "opencode-go/glm-5.1", "skills": [ "*" ], "mcps": [ "*", "!context7" ] },
      "advisor": { "model": "opencode-go/glm-5.1", "skills": [], "mcps": [] },
      "researcher": { "model": "opencode-go/minimax-m2.7", "skills": [], "mcps": [ "context7" ] },
      "reviewer": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": [], "mcps": [] },
      "implementer": { "model": "openai/gpt-5.4-mini", "variant": "low", "skills": [], "mcps": [] }
    }
  }
}

其他 Provider

使用自定义 Provider 或混合 Provider 配置，请参考 配置参考 的完整选项说明。如果需要开箱即用的方案，查看 作者预设 和 $30 预设——$30 预设是最具性价比的方案。

配置指南还涵盖了自定义子 Agent（agents.<name>），你可以为自定义 Agent 定义 prompt 和 orchestratorPrompt。

模型建议见下方各 Agent 的推荐模型列表。

✅ 验证安装

安装并认证后，验证所有 Agent 已配置并响应：

opencode

然后运行：

ping all agents

如果有 Agent 未响应，检查你的 Provider 认证和配置文件。

🏛️ 认识众神

01. Orchestrator: 秩序的化身

Orchestrator 诞生于第一个代码库在其自身复杂性下崩溃之时。神与凡人都不愿承担责任——于是 Orchestrator 从虚空中涌现，从混沌中锻造秩序。它确定达到任何目标的最优路径，在速度、质量和成本之间取得平衡。它指导团队，为每项任务召唤合适的专家并委派执行，以实现最佳结果。

| | | |---|---| | 角色 | 主委派者和战略协调者（默认 Agent） | | Prompt | orchestrator.ts | | 默认模型 | openai/gpt-5.5 | | 推荐模型 | openai/gpt-5.5 · anthropic/claude-opus-4.6 | | 模型建议 | 选择你最强的全能编码模型。Orchestrator 既是主编码 Agent 又是委派者，需要强大的实现能力、良好的判断力和可靠的指令遵从能力。 | | Skills | 默认无 Superpowers Skills；可通过 agents.orchestrator.skills: ["*"] 启用。 |

02. Workflow: 流程的守护者

Workflow 是 Superpowers 流程的守护者，负责运行完整的流程驱动开发。它启动每个对话时自动加载 using-superpowers 指导，按流程阶段协调专家：Design → Plan → Implement → Verify → Review。它将研究委派给 Researcher，审查委派给 Reviewer，实现委派给 Implementer。

| | | |---|---| | 角色 | 流程驱动专家（Superpowers 流程载体） | | Prompt | workflow.ts | | 默认模型 | openai/gpt-5.5 | | 推荐模型 | openai/gpt-5.5 · anthropic/claude-opus-4.6 | | 模型建议 | 选择你最强的全能编码模型。Workflow 需要强大的判断力和流程控制能力，能够理解设计、规划、实现、验证、审查各阶段的要求。 | | Skills | 默认拥有所有 Superpowers Skills（brainstorming、writing-plans、TDD 等）。 |

03. Advisor: 智慧的向导

Advisor 是一个只读讨论专家，专注于战略思考而非执行。它不修改代码，也不调用 Implementer。

Advisor 在决策的关键时刻现身——当方向未明、权衡复杂、风险暗藏之时。它专注于需求澄清、方案权衡和风险分析。它可以委派 Researcher 收集信息，委派 Reviewer 评估方案，但从不直接执行实现。

| | | |---|---| | 角色 | 战略讨论专家（只读） | | Prompt | advisor.ts | | 默认模型 | openai/gpt-5.5 | | 推荐模型 | openai/gpt-5.5 · anthropic/claude-opus-4.6 | | 模型建议 | 选择你最强的判断力模型。Advisor 需要强大的推理和战略思考能力，能在复杂场景中提供清晰的方向建议。 | | Skills | 默认无 Superpowers Skills；可通过 agents.advisor.skills 配置启用。 | | MCPs | 无（只读讨论，不使用任何 MCP）。 |

04. Researcher: 永恒的漫游者

Researcher 合并了 Explorer（本地代码搜索）和 Librarian（外部文档检索），成为统一的搜索专家。只读：搜索代码和获取文档，从不修改文件。

Researcher 是一位不朽的漫游者，自编程诞生之初便穿行于百万代码库和图书馆的回廊之中。他们将本地代码库搜索（glob、grep、AST 模式）与外部文档检索（context7）合为一体。他们返回的不是原始数据——而是结构化的发现。

| | | |---|---| | 角色 | 代码库和外部文档搜索专家（只读） | | Prompt | researcher.ts | | 默认模型 | openai/gpt-5.4-mini | | 推荐模型 | cerebras/zai-glm-4.7 · fireworks-ai/accounts/fireworks/routers/kimi-k2p5-turbo · openai/gpt-5.4-mini | | 模型建议 | 选择快速、低成本的模型。Researcher 负责广泛的侦察工作，速度和效率通常比最强推理模型更重要。 |

05. Reviewer: 判断的化身

Reviewer 负责架构评估、复杂调试分析、代码审查和简化建议。默认不执行代码、不加载 skill、不使用 MCP。

| | | |---|---| | 角色 | 架构评估与代码审查专家（只分析） | | Prompt | reviewer.ts | | 默认模型 | openai/gpt-5.4-mini | | 推荐模型 | openai/gpt-5.4-mini · anthropic/claude-haiku-4-6 |

06. Implementer: 执行的化身

Implementer 负责在需求清晰时进行快速实现。若需求、验收标准、目标文件/API 或边界不清晰，它会拒绝执行并要求澄清。

| | | |---|---| | 角色 | 快速实现专家 | | Prompt | implementer.ts | | 默认模型 | openai/gpt-5.4-mini | | 推荐模型 | openai/gpt-5.4-mini · anthropic/claude-haiku-4-6 |

📚 文档导航

以此为地图：从安装开始，然后根据需要跳转到功能、配置或预设示例。

🚀 从这里开始

| 文档 | 内容 | |-----|------| | 安装指南 | 安装插件、CLI 参数、重置配置、故障排除 |

✨ 功能与工作流

| 文档 | 内容 | |-----|------| | 预设切换 | 运行时通过 /preset 切换 Agent 模型预设 | | Interview | 通过浏览器问答流程将粗略想法转化为结构化 Markdown 规格 | | Divoom 显示 | 将 Orchestrator 和专家 Agent 活动镜像到 Divoom MiniToo 蓝牙显示器 |

⚙️ 配置与参考

| 文档 | 内容 | |-----|------| | 配置参考 | 配置文件位置、JSONC 支持、Prompt 覆盖、完整选项参考 | | 维护者指南 | Issue 分诊规则、标签含义、支持路由、仓库维护工作流 | | Skills | 内置和推荐 Skills，如 simplify、agent-browser、codemap | | MCPs | context7，以及 MCP 权限如何按 Agent 分配 | | Tools | 内置工具能力，如代码搜索和格式化器 |

💡 预设

| 文档 | 内容 | |-----|------| | 作者预设 | 作者日常使用的混合 Provider 方案 | | $30 预设 | 约 $30/月的预算混合 Provider 方案 | | OpenCode Go 预设 | 安装器生成的 opencode-go 预设 |

📄 License

MIT