Oh-My-OpenAgent 项目介绍

Oh-My-OpenAgent

一句话定义：Oh-My-OpenAgent 是一个面向 OpenCode 的多模型 AI Agent 编排插件，将单个 AI Agent 转变为能真正并行协作的开发团队。

项目定位

在 Claude Code、Codex、各类开源模型之间反复切换配置工作流？这个插件把多模型编排、并行 Agent、LSP/AST 工具全部打包为「安装即用」的 OpenCode 插件。不是「又一个提示词模板」，而是经过 $24K 真实 LLM 费用验证的工程实践集合。

核心能力

• 11 个专业 Agent：Sisyphus（主编排器）、Hephaestus（深度研究工匠）、Prometheus（战略规划师）、Atlas（执行指挥）等，每个 Agent 针对特定任务类型优化
• Category 路由系统：按任务意图（visual-engineering、ultrabrain、deep、quick 等 8 类）自动路由到最佳模型，无需手动指定模型名
• 并行后台 Agent：同时启动 5+ 个专业 Agent，上下文保持精简，结果就绪时自动通知
• Hashline 编辑协议：LINE#ID 内容哈希锚定每次编辑，从根源消除「行号漂移」错误，Grok Code Fast 1 成功率从 6.7% 提升至 68.3%
• IntentGate 意图门：在行动前分类用户真实意图（研究/实现/调查/修复），避免字面误解
• Skill-Embedded MCP：技能自带 MCP 服务器，按需启动，任务完成即释放，上下文窗口不膨胀
• Team Mode（v4.0，实验性）：Lead + 最多 8 名并行成员，共享邮箱、共享任务列表、tmux 实时可视化
• Prometheus 规划 + Atlas 执行：Interview 模式需求澄清 → 生成计划 → Atlas 分配子 Agent 执行 → 独立验证完成
• 54+ 生命周期 Hook：编辑错误恢复、注释检查器、上下文窗口监控、Todo 保持、Ralph Loop 等
• Claude Code 兼容性：已有的 hooks、commands、skills、MCP、plugins 无缝迁移

技术栈

维度	选择
语言	TypeScript (ESM)
运行时	Bun（构建 + 运行）
宿主	OpenCode Plugin SDK (@opencode-ai/plugin)
构建	Bun bundler + tsc 类型检查
包管理	Bun workspaces（10 个内部包）
发布	npm（二进制预编译，支持 Darwin/Linux/Windows 多平台）
遥测	PostHog（匿名，每日一次，可禁用）

架构概览

快速体验

1. 安装 OpenCode（opencode.ai）
2. 在 AI Agent 会话中粘贴：

   Install and configure oh-my-openagent by following the instructions here:
   https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

3. 重启 OpenCode，输入 ultrawork（或 ulw），开始体验

最低订阅要求：ChatGPT ($20) + Kimi Code ($19) + GLM 编码计划 ($10) 即可运行。

教程导读

本教程分为 AI 应用 和 编程核心 两个部分：

AI 应用教程（ai/ 目录）

章节	内容	引用 Common
01	Category 路由与多模型路由策略	引用 数据提供商路由 + 多模型回退
02	专业 Agent 编排模式	引用 Agent 核心循环 + 多 Agent 路由
03	IntentGate 意图分类系统	首次覆盖 → 新建 common
04	Hashline 内容哈希编辑协议	首次覆盖 → 新建 common
05	Skill-Embedded MCP 按需加载	补充 MCP 协议 + Skill 设计
06	并行后台 Agent 与上下文管理	引用 上下文管理 + 流式传输
07	Session 恢复与容错策略	引用 上下文压缩
08	Team Mode 多 Agent 并行编排	补充 多 Agent 编排

编程核心教程（dev/ 目录）

章节	内容
01	OpenCode 插件架构与生命周期
02	Bun Monorepo 与 10 包工作空间设计
03	Hook 系统：54+ 生命周期钩子的 5 层组合
04	LSP + AST-Grep 工具集成
05	跨平台二进制构建与发布流水线
06	配置迁移与向后兼容策略