Oh My OpenCode
| 特性 | 功能说明 | |
|---|---|---|
| 🤖 | 自律军团 (Discipline Agents) | Sisyphus 负责调度 Hephaestus、Oracle、Librarian 和 Explore。一支完整的 AI 开发团队并行工作。 |
| ⚡ | ultrawork / ulw | 一键触发,所有智能体出动。任务完成前绝不罢休。 |
| 🚪 | IntentGate 意图门 | 真正行动前,先分析用户的真实意图。彻底告别被字面意思误导的 AI 废话。 |
| 🔗 | 基于哈希的编辑工具 | 每次修改都通过 LINE#ID 内容哈希验证、0% 错误修改。灵感来自 oh-my-pi。马具问题 → |
| 🛠️ | LSP + AST-Grep | 工作区级别的重命名、构建前诊断、基于 AST 的重写。为 Agent 提供 IDE 级别的精度。 |
| 🧠 | 后台智能体 | 同时发射 5+ 个专家并行工作。保持上下文干净,随时获取成果。 |
| 📚 | 内置 MCP | Exa (网络搜索)、Context7 (官方文档)、Grep.app (GitHub 源码搜索)。默认开启。 |
| 🔁 | Ralph Loop | /ulw-loop 自我引用闭环。达不到 100% 完成度绝不停止。 |
| ✅ | Todo 强制执行 | Agent 想要摸鱼?系统直接揪着领子拽回来。你的任务,必须完成。 |
| 💬 | 注释审查员 | 剔除带有浓烈 AI 味的冗余注释。写出的代码就像老练的高级工程师写的。 |
| 🖥️ | Tmux 集成 | 完整的交互式终端支持。跑 REPL、用调试器、用 TUI 工具,全都在实时会话中完成。 |
| 🔌 | Claude Code 兼容 | 你现有的 Hooks、命令、技能、MCP 和插件?全都能无缝迁移过来。 |
| 🎯 | 技能内嵌 MCP | 技能自带其所需的 MCP 服务器。按需开启,不会撑爆你的上下文窗口。 |
| 📋 | Prometheus 规划师 | 动手写代码前,先通过访谈模式做好战略规划。 |
| 🔍 | /init-deep | 在整个项目目录层级中自动生成 AGENTS.md。不仅省 Token,还能大幅提升 Agent 理解力。 |
自律军团 (Discipline Agents)
- Sisyphus (claude-opus-4-7 / kimi-k2.5 / glm-5): 是你的主指挥官。他负责制定计划、分配任务给专家团队,并以极其激进的并行策略推动任务直至完成。他从不半途而废。
- Hephaestus (gpt-5.4): 是你的自主深度工作者。你只需要给他目标,不要给他具体做法。他会自动探索代码库模式,从头到尾独立执行任务,绝不会中途要你当保姆。名副其实的正牌工匠。
- Prometheus (claude-opus-4-7 / kimi-k2.5 / glm-5): 是你的战略规划师。他通过访谈模式,在动一行代码之前,先通过提问确定范围并构建详尽的执行计划。
每一个 Agent 都针对其底层模型的特点进行了专门调优。
智能体调度机制
当 Sisyphus 把任务分配给子智能体时,他选择的不是具体的模型,而是 类别 (Category)。系统会自动将类别映射到最合适的模型。
| 类别 | 作用领域 |
|---|---|
| visual-engineering | 前端、UI/UX、设计 |
| deep | 深度自主调研与执行 |
| quick | 单文件修改、修错字 |
| ultrabrain | 复杂硬核逻辑、架构决策 |
智能体只需要说明要做什么类型的工作,框架就会挑选出最合适的模型去干。
深度上下文初始化:/init-deep
执行一次 /init-deep。它会为你生成一个树状的 AGENTS.md 文件系统:
project/
├── AGENTS.md ← 全局级架构与约定
├── src/
│ ├── AGENTS.md ← src 级规范
│ └── components/
│ └── AGENTS.md ← 组件级详细说明
Agent 会自动顺藤摸瓜加载对应的 Context,免去了你所有的手动喂喂喂的麻烦。
让 Agent 动手前先过脑子:Prometheus
输入 /start-work,召唤 Prometheus 出场。他会像一个真实的主管那样去采访你,主动深挖需求、指出模糊地带,并在改动哪怕一行代码之前产出经过严密论证的计划。你的 Agent 终于知道了自己在干嘛。
多智能体协作系统
Oh-My-OpenCode 的核心是多智能体协作系统,每个智能体都有专门的角色和能力:
| 智能体 | 角色定位 | 推荐模型 | 主要职责 |
|---|---|---|---|
| Sisyphus | 主编排者 | Claude 3.5 Sonnet | 任务规划、分配、协调 |
| Oracle | 架构顾问 | GPT-4/GPT-4 Turbo | 架构设计、复杂问题解答 |
| Librarian | 文档专家 | Gemini 1.5 Flash/Gemini Pro | 文档查询、代码库研究 |
| Frontend-UI-UX-Engineer | 前端工程师 | Claude 3 Sonnet/Gemini 3 Pro | UI/UX 开发、界面设计 |
| Explore | 代码探索者 | Grok/Gemini Flash | 快速代码分析、模式发现 |
Ralph Loop 自我循环机制
Ralph Loop 是 Oh-My-OpenCode 的自我迭代机制,让智能体持续工作直到任务完成。
# 通过 slash 命令触发
/ralph-loop 或 /stop-ralph
# 或通过任务管理器
"启动ralph-loop,持续优化代码直到性能测试通过"
Hook 系统
Oh-My-OpenCode 提供了 20+ 个内置 Hook,可全面自动化工作流程。
- 核心 Hook
- preemptive-compaction
- 用途:预防性上下文压缩,节省 token 消耗
- 自动在上下文接近限制时压缩历史对话
- ralph-loop
- 用途:Ralph 智能体循环管理,持续任务执行
- 适合需要多轮迭代的复杂任务
- todo-enforcer
- 用途:任务强制执行器,确保任务 100% 完成
- 失败重试机制,最多可配置重试次数
- preemptive-compaction
- 高级 Hook
- ulw-loop
- Ultrawork 循环模式,持续高强度工作
- 用于大规模重构或开发任务
- start-work
- 从 Prometheus 计划开始工作会话
- 优化复杂项目的启动流程
- refactor
- 智能重构命令,包含 LSP、AST、架构分析和测试验证
- ulw-loop