oh-my-claudecode 调研报告
notes/research/github/oh-my-claudecode-research.md
Port 8777
---
title: oh-my-claudecode 调研报告
category: research/github
source_type: github
created_by: xiaomeixia
status: archived
migrated_from: agent-notes/xiaomeixia/research/github/oh-my-claudecode-research.md
tags: []
---
# oh-my-claudecode 调研报告
## 📋 基本信息
| 项目 | 详情 |
|------|------|
| **仓库** | https://github.com/Yeachan-Heo/oh-my-claudecode |
| **npm 包名** | `oh-my-claude-sisyphus` (注意品牌名与包名不一致) |
| **最新版本** | v4.5.1 (2026-03) |
| **Stars** | ~4780 |
| **许可证** | MIT |
| **官方文档** | https://yeachan-heo.github.io/oh-my-claudecode-website |
---
## 🎯 核心定位
> "Transform Claude Code into an intelligent multi-agent orchestration system. You become the conductor, not the performer."
**零学习曲线**的多 Agent 编排系统，专为 Claude Code 设计。
---
## 🏗️ 架构特性
### 1. 30 个专业化 Agent
覆盖 5 个功能领域，使用优化的模型路由 (Opus/Sonnet/Haiku)
### 2. 10 种执行模式
| 模式 | 用途 |
|------|------|
| Autopilot | 全自动执行 |
| Team | 原生多 Agent 协调 |
| Ralph | 持久化执行 ("The boulder never stops") |
| ULW | 并行多 Agent 工作 |
| Deep Interview | Socratic 式需求澄清 |
### 3. 25+ MCP 工具集成
- Language Servers
- AST grep
- Python REPL
- 外部 AI 模型 (Codex, Gemini)
### 4. Native Teams 支持
staged pipeline: `team-plan → team-prd → team-exec → team-verify → team-fix`
---
## 🔧 核心功能
### 模型智能路由
| 复杂度 | 模型 | 用例 |
|--------|------|------|
| 简单 | Haiku | 查找、格式化、简单文档 |
| 标准 | Sonnet | 实现、测试、重构 |
| 复杂 | Opus | 架构、深度调试、规划 |
### 多模型编排 (v4.4.0+)
```bash
# 在 tmux 中启动多个 CLI worker
/omc-teams 2:codex "review auth module"
/omc-teams 2:gemini "redesign UI"
/omc-teams 1:claude "implement payment flow"
# 三模型并行
/ccg Review this PR — architecture (Codex) + UI (Gemini)
```
### 通知系统 (v4.5.0+)
- 支持 Discord, Telegram, Slack, Webhook
- 可定制通知模板 `{{variable}}`
- OpenClaw webhook gateway 集成
---
## 📦 安装使用
```bash
# 1. 添加插件市场
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
# 2. 安装插件
/plugin install oh-my-claudecode
# 3. 运行设置向导
/omc-setup
```
### 快速开始示例
```bash
# 需求不明确时
/deep-interview "I want to build a task management app"
# 全自动构建
autopilot: build a REST API for managing tasks
# 团队执行
/team 3:executor "fix all TypeScript errors"
# 持久化重构
ralph refactor the API
```
---
## 🔄 版本演进
| 版本 | 关键变化 |
|------|----------|
| v4.5.1 | OpenClaw CLI gateway、tmux tail capture、通知系统改进 |
| v4.5.0 | 完整通知系统、Hook 模板引擎、OpenClaw webhook |
| v4.4.0 | 移除 Codex/Gemini MCP，改用 tmux CLI workers、/ccg 三模型技能 |
| v4.3.x | Team 架构改革、30 个统一 Agent、MCP 提供商升级 |
| v4.1.0 | Native Teams 支持、Swarm 模式弃用 |
---
## 💡 设计哲学
### Conductor Philosophy (指挥家哲学)
> "You are the conductor, not the performer."
**黄金法则**:
- ❌ 永远不要直接修改代码
- ✅ 始终委托给专业化 Agent
你的角色是**指导、审查、编排**,而不是亲自执行。
### Agent 分工
- **Architect** - 全局视野
- **Executor** - 编写代码
- **Verifier** - 验证功能
---
## 🔗 相关项目
| 项目 | 说明 |
|------|------|
| oh-my-codex | 为 OpenAI Codex CLI 提供相同编排体验 |
| oh-my-claude (TechDufus) | 简化版，提供 ultrawork 模式 |
| oh-my-opencode | 灵感来源 (前身) |
---
## 📝 与记忆服务的关联
OMC 的设计对我们要构建的记忆服务有以下启发:
1. **分层 Agent 架构** → 可以借鉴到记忆分层 (L1-L4)
2. **模型智能路由** → 记忆编码/检索也可根据复杂度选择模型
3. **Hook/通知系统** → 记忆巩固/遗忘机制可参考
4. **OpenClaw 集成** → v4.5.x 已支持 OpenClaw CLI gateway，可考虑直接集成
---
## 📅 调研时间
- 调研日期：2026-03-04
- 调研者：小美虾 🦐