code-yeongyu/oh-my-openagent

## 评论 # Oh My OpenCode 你正在周旋于 Claude Code、Codex 和各种 OSS 模型之间。配置工作流。调试 agent。 我们替你完成了这些工作。测试了一切。保留了真正能上线的东西。 安装 OmO。输入 `ultrawork`。搞定。 ## 安装说明 ### 供人类使用 将此提示词复制并粘贴到你的 LLM agent（Claude Code、AmpCode、Cursor 等）： ``` Install and configure oh-my-opencode by following the instructions here: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md ``` 或者阅读 [安装指南](docs/guide/installation.md)，不过说真的，还是让 agent 来做吧。人类手动配置容易出错。 ### 供 LLM Agent 使用 获取安装指南并按照说明操作： ``` curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md ``` **注意**：请使用已发布的包名和二进制文件名 `oh-my-opencode`。在 `opencode.json` 内部，兼容层现在优先使用插件入口 `oh-my-openagent`，而旧的 `oh-my-opencode` 条目仍会加载（但会显示警告）。插件配置文件通常仍使用 `oh-my-opencode.json` 或 `oh-my-opencode.jsonc`，在过渡期间，新旧形式的文件名都会被识别。 ## 跳过此 README 我们已经过了需要阅读文档的时代。只需将此内容粘贴到你的 agent： ``` Read this and tell me why it's not just another boilerplate: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/README.md ``` ## 亮点 ### 🪄 `ultrawork` 你居然真的在读这个？太狂了。 安装。输入 `ultrawork`（或 `ulw`）。搞定。 下面所有内容、所有功能、所有优化，你都不需要了解。它就是能用。 即使只有以下订阅，ultrawork 也能正常运行（本项目无任何关联，仅为个人推荐）： - [ChatGPT 订阅 ($20)](https://chatgpt.com/) - [Kimi Code 订阅 ($0.99)（*仅限本月*）](https://www.kimi.com/kimiplus/sale) - [GLM Coding 计划 ($10)](https://z.ai/subscribe) - 如果你有资格使用按量付费，使用 kimi 和 gemini 模型的花费并不高。 | | 功能 | 作用 | | :---: | :------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 🤖 | **Discipline Agents** | Sisyphus 编排调度 Hephaestus、Oracle、Librarian、Explore。一支完整的 AI 开发团队并行工作。 | | ⚡ | **`ultrawork` / `ulw`** | 一个词。所有 agent 激活。不完成不罢休。 | | 🚪 | **[IntentGate](https://factory.ai/news/terminal-bench)** | 在分类或行动之前分析用户的真实意图。不再有字面误解。 | | 🔗 | **Hash-Anchored Edit Tool** | `LINE#ID` 内容哈希验证每一次更改。零过时行错误。灵感来自 [oh-my-pi](https://github.com/can1357/oh-my-pi)。[The Harness Problem →](https://blog.can.ac/2026/02/12/the-harness-problem/) | | 🛠️ | **LSP + AST-Grep** | 工作区重命名、预构建诊断、AST 感知重写。为 agent 提供 IDE 级精度。 | | 🧠 | **Background Agents** | 并行启动 5 个以上专家 agent。上下文保持精简。结果就绪时获取。 | | 📚 | **Built-in MCPs** | Exa（网页搜索）、Context7（官方文档）、Grep.app（GitHub 搜索）。始终开启。 | | 🔁 | **Ralph Loop / `/ulw-loop`** | 自引用循环。不达 100% 完成不停止。 | | ✅ | **Todo Enforcer** | Agent 闲下来了？系统会把它拉回来。你的任务一定会完成，就这样。 | | 💬 | **Comment Checker** | 注释中没有 AI 废话。代码读起来像资深工程师写的。 | | 🖥️ | **Tmux Integration** | 完全交互式终端。REPL、调试器、TUI。全部实时。 | | 🔌 | **Claude Code Compatible** | 你的 hooks、commands、skills、MCPs 和 plugins？全部在此可用。 | | 🎯 | **Skill-Embedded MCPs** | Skill 自带 MCP server。无上下文膨胀。 | | 📋 | **Prometheus Planner** | 在任何执行之前进行访谈模式的战略规划。 | | 🔍 | **`/init-deep`** | 在整个项目中自动生成层级化的 `AGENTS.md` 文件。对 token 效率和 agent 性能都很有帮助 | ### Discipline Agents **Sisyphus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`** ) 是你的主编排者。他规划、委托给专家，并通过激进的并行执行推动任务完成。他不会半途而废。 **Hephaestus** (`gpt-5.4`) 是你的自主深度工作者。给他一个目标，而不是步骤。他探索代码库、研究模式，并在无需手把手指导的情况下端到端执行。*真正的工匠。* **Prometheus** (`claude-opus-4-6` / **`kimi-k2.5`** / **`glm-5`** ) 是你的战略规划师。访谈模式：它会提问、确定范围，在写一行代码之前构建详细的计划。 每个 agent 都针对其模型的具体优势进行了调优。无需手动切换模型。[了解更多 →](docs/guide/overview.md) ### Agent 编排 当 Sisyphus 委托给子 agent 时，它不选择模型。它选择一个**类别**。该类别自动映射到正确的模型： | Category | 用途 | | :------------------- | :--------------------------------- | | `visual-engineering` | 前端、UI/UX、设计 | | `deep` | 自主研究 + 执行 | | `quick` | 单文件更改、错别字修复 | | `ultrabrain` | 硬核逻辑、架构决策 | Agent 说明工作类型。Harness 选择正确的模型。`ultrabrain` 现在默认路由到 GPT-5.4 xhigh。你无需任何操作。 ### Claude Code 兼容性 你精心调校了你的 Claude Code 设置。很好。 每一个 hook、command、skill、MCP、plugin 都在此无需更改即可工作。完全兼容，包括 plugins。 ### 为你的 Agent 提供世界级工具 LSP、AST-Grep、Tmux、MCP 真正集成，而非拼凑。 - **LSP**：`lsp_rename`、`lsp_goto_definition`、`lsp_find_references`、`lsp_diagnostics`。为每个 agent 提供 IDE 精度 - **AST-Grep**：跨 25 种语言的感知模式的代码搜索和重写 - **Tmux**：完全交互式终端。REPL、调试器、TUI 应用。你的 agent 保持在会话中 - **MCP**：网页搜索、官方文档、GitHub 代码搜索。全部内置 ### Skill-Embedded MCPs MCP server 消耗你的上下文预算。我们解决了这个问题。 Skill 自带 MCP server。按需启动，限定任务范围，完成后消失。上下文窗口保持干净。 ### 写出更好的代码。Hash-Anchored Edits Harness 问题是真实存在的。大多数 agent 失败不是因为模型。而是因为编辑工具。 受 [oh-my-pi](https://github.com/can1357/oh-my-pi) 启发，我们实现了 **Hashline**。agent 读取的每一行都带有内容哈希标签： ``` 11#VK| function hello() { 22#XJ| return "world"; 33#MB| } ``` agent 通过引用这些标签进行编辑。如果文件自上次读取后发生了更改，哈希将不匹配，编辑会在造成破坏之前被拒绝。无需复制空白字符。无过时行错误。 Grok Code Fast 1：**6.7% → 68.3%** 成功率。仅通过更改编辑工具实现。 ### 深度初始化。`/init-deep` 运行 `/init-deep`。它会生成层级化的 `AGENTS.md` 文件： ``` project/ ├── AGENTS.md ← project-wide context ├── src/ │ ├── AGENTS.md ← src-specific context │ └── components/ │ └── AGENTS.md ← component-specific context ``` Agent 自动读取相关上下文。零手动管理。 ### 规划。Prometheus 任务复杂？不要提示了就祈祷。 `/start-work` 调用 Prometheus。**像真正的工程师一样面试你**，确定范围和模糊之处，在接触代码之前构建经过验证的计划。Agent 在开始之前就知道它在构建什么。 ### Skills Skills 不仅仅是提示词。每一个都带来： - 领域调优的系统指令 - 嵌入式 MCP server，按需启动 - 限定权限。Agent 保持在界限内 内置：`playwright`（浏览器自动化）、`git-master`（原子提交、变基手术）、`frontend-ui-ux`（设计优先的 UI）。 添加你自己的：`.opencode/skills/*/SKILL.md` 或 `~/.config/opencode/skills/*/SKILL.md`。 **想要完整功能分解？** 请参阅 **[功能文档](docs/reference/features.md)**，了解 agents、hooks、tools、MCPs 及其他所有内容的详细信息。 ## 卸载说明 要移除 oh-my-opencode： 1. **从你的 OpenCode 配置中移除 plugin** 编辑 `~/.config/opencode/opencode.json`（或 `opencode.jsonc`）并从 `plugin` 数组中移除 `"oh-my-openagent"` 或旧的 `"oh-my-opencode"` 条目： # 使用 jq jq '.plugin = [.plugin[] | select(. != "oh-my-openagent" and . != "oh-my-opencode")]' \ ~/.config/opencode/opencode.json > /tmp/oc.json && \ mv /tmp/oc.json ~/.config/opencode/opencode.json 2. **移除配置文件（可选）** # 移除在兼容窗口期间识别的 plugin config 文件 rm -f ~/.config/opencode/oh-my-openagent.jsonc ~/.config/opencode/oh-my-openagent.json \ ~/.config/opencode/oh-my-opencode.jsonc ~/.config/opencode/oh-my-opencode.json # 移除项目配置（如果存在） rm -f .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \ .opencode/oh-my-opencode.jsonc .opencode/oh-my-opencode.json 3. **验证移除** opencode --version # Plugin 应不再被加载 ## 功能 你会觉得这些功能本该一直存在。一旦使用，就无法回头。 请参阅完整的 [功能文档](docs/reference/features.md)。 **快速概览：** - **Agents**：Sisyphus（主 agent）、Prometheus（规划师）、Oracle（架构/调试）、Librarian（文档/代码搜索）、Explore（快速代码库 grep）、Multimodal Looker - **Background Agents**：像真正的开发团队一样并行运行多个 agent - **LSP & AST Tools**：重构、重命名、诊断、AST 感知代码搜索 - **Hash-anchored Edit Tool**：`LINE#ID` 引用在应用每次更改之前验证内容。精准编辑，零过时行错误 - **Context Injection**：自动注入 AGENTS.md、README.md、条件规则 - **Claude Code Compatibility**：完整的 hook 系统commands、skills、agents、MCPs - **Built-in MCPs**：websearch (Exa)、context7 (docs)、grep_app (GitHub search) - **Session Tools**：列出、读取、搜索和分析会话历史 - **Productivity Features**：Ralph Loop、Todo Enforcer、Comment Checker、Think Mode 等 - **Doctor Command**：内置诊断（`bunx oh-my-opencode doctor`）验证 plugin 注册、配置、模型和环境 - **Model Fallbacks**：`fallback_models` 可以在同一数组中混合普通模型字符串和按 fallback 对象设置 - **File Prompts**：在 agent 配置中使用 `file://` 支持从文件加载提示词 - **Session Recovery**：自动从会话错误、上下文窗口限制和 API 故障中恢复 - **Model Setup**：Agent-模型匹配已内置在 [安装指南](docs/guide/installation.md#step-5-understand-your-model-setup) 中 ## 配置 有主见的默认值，如果你坚持可以调整。 请参阅 [配置文档](docs/reference/configuration.md)。 **快速概览：** - **Config Locations**：兼容层同时识别 `oh-my-openagent.json[c]` 和旧的 `oh-my-opencode.json[c]` plugin config 文件。现有安装通常仍使用旧的基本名称。 - **JSONC Support**：支持注释和尾随逗号 - **Agents**：覆盖任何 agent 的模型、温度、提示词和权限 - **Built-in Skills**：`playwright`（浏览器自动化）、`git-master`（原子提交） - **Sisyphus Agent**：主编排者，带有 Prometheus（规划师）和 Metis（计划顾问） - **Background Tasks**：按 provider/model 配置并发限制 - **Categories**：特定领域任务委托（`visual`、`business-logic`、自定义） - **Hooks**：25 个以上内置 hooks，全部可通过 `disabled_hooks` 配置 - **MCPs**：内置 websearch (Exa)、context7 (docs)、grep_app (GitHub search) - **LSP**：带有重构工具的完整 LSP 支持 - **Experimental**：激进截断、自动恢复等 ## 作者说明 **想了解理念？** 阅读 [Ultrawork Manifesto](docs/manifesto.md)。 我在个人项目上烧掉了 $24K 的 LLM token。尝试了所有工具。把所有东西都配置到极致。OpenCode 赢了。 我遇到的每个问题，解决方案都已烘焙进这个 plugin。安装即可使用。 如果 OpenCode 是 Debian/Arch，那 OmO 就是 Ubuntu/[Omarchy](https://omarchy.org/)。 深受 [AmpCode](https://ampcode.com) 和 [Claude Code](https://code.claude.com/docs/overview) 影响。移植了功能，通常还做了改进。仍在构建。这是 **Open**Code。 其他 harness 承诺多模型编排。我们交付了。还有稳定性。以及真正有效的功能。 我是这个项目最痴迷的用户： - 哪个模型逻辑最敏锐？ - 谁是调试之神？ - 谁写的文章最好？ - 谁主宰前端？ - 谁拥有后端？ - 日常使用什么最快？ - 竞争对手在发布什么？ 这个 plugin 是精华提炼。取其精华。有改进？欢迎 PR。 **停止为 harness 选择而焦虑。** **我会研究、偷最好的，然后在这里发布。** 听起来傲慢？有更好的方法？来贡献。不客气。 与提到的任何项目/模型无关。只是个人实验。 这个项目的 99% 是用 OpenCode 构建的。我不太懂 TypeScript。**但我亲自审阅并大部分重写了这份文档。** ## 受到以下专业人士喜爱 - [Indent](https://indentcorp.com) - Making Spray - influencer marketing solution, vovushop - crossborder commerce platform, vreview - ai commerce review marketing solution - [Google](https://google.com) - [Microsoft](https://microsoft.com) - [ELESTYLE](https://elestyle.jp) - Making elepay - multi-mobile payment gateway, OneQR - mobile application SaaS for cashless solutions *特别感谢 [@junhoyeo](https://github.com/junhoyeo) 提供的精美封面图片。*

标签：Agent Harness, Cilium, CLI, DLL 劫持, DNS解析, LLM, MITM代理, NPM, Oh-My-OpenCode, RAG, Unmanaged PE, WiFi技术, 大语言模型, 威胁情报, 工作流自动化, 开发者工具, 开源项目, 智能体框架, 编码助手, 网络调试, 自动化, 自动化攻击