oh-my-claudecode Skill:团队协作场景下的 Claude Code 多 Agent 编排框架
oh-my-claudecode Skill:团队协作场景下的 Claude Code 多 Agent 编排框架
oh-my-claudecode 是一个面向 Claude Code 的多 Agent 编排框架,主打团队协作场景下的多角色、多任务并行推进。当前 GitHub Star 38.4k(截至 2026-08-06),近两周持续活跃,最近一次提交为 2026-07-23,是 8 月初 GitHub Trending 榜单上的常客。
功能与原则
oh-my-claudecode 的核心设计理念是将 Claude Code 从单 Agent 工具升级为多 Agent 协作平台。它允许用户在同一个项目会话中同时调度多个专业 Agent(规划者、编码者、审查者等),各 Agent 分工明确、协同完成任务。
框架遵循以下设计原则:
- 多角色分工:内置 Planner、Executor、Reviewer、Reporter 等标准 Agent 角色,支持自定义扩展
- 任务并行推进:多个子任务可同时交由不同 Agent 处理,显著提升复杂项目的执行效率
- 上下文隔离:各 Agent 拥有独立上下文,避免信息相互干扰
- 结果汇总与验证:最终结果由专门的 Reviewer Agent 校验质量,确保输出可靠
认可度
- GitHub Star:38.4k(截至 2026-08-06)
- Fork:3.5k
- 最近活跃:2026-07-23 仍有提交(v4.15.7 发布)
- Trending:2026-08-06 GitHub Trending 榜单第 2 位,日增 Star 约 835
- Issues/PR:Issue 5 个,Pull requests 持续有社区贡献
链接
GitHub:https://github.com/Yeachan-Heo/oh-my-claudecode
原作者
Yeachan-Heo(GitHub username: Yechan-Heo),专注于 Claude Code 生态工具开发,是 oh-my-claudecode 项目的主要维护者。其项目覆盖 Agent 编排、工作流自动化等多个方向。
介绍
oh-my-claudecode 脱胎于 Yechan-Heo 在实际开发中对 Claude Code 的深度使用经验。随着 AI 编码工具的普及,单一 Agent 在面对大型项目时逐渐暴露出上下文窗口有限、任务切换效率低等瓶颈。作者由此出发,构建了一套完整的多 Agent 协作框架。
框架的核心是 .omx/ 目录结构,其中定义了各类 Agent 的角色定义、技能配置和任务协调逻辑。用户可通过 omc(项目提供的 CLI 工具)快速启动多 Agent 会话,也可以将其集成到现有 Claude Code 工作流中。
在 v4.x 版本之后,项目引入了”任务规划(Plans)”机制——系统会自动将复杂任务拆解为可执行的子任务列表,再分发至对应的专业 Agent 处理。这一设计让大型项目的 AI 协作从”一个人干所有事”变成”一个团队各司其职”。
特点
- 开箱即用的多 Agent 模板:内置多种标准角色模板,无需从零配置
- 灵活的技能扩展:支持在
skills/目录下自定义 Agent 专属技能 - CLI 工具 omc:提供命令行交互界面,快速初始化和管理多 Agent 会话
- 版本活跃度高:近一个月保持高频更新(v4.11 → v4.15),社区反馈积极
- 与 Git 工作流深度集成:支持 Git 分支、PR 等场景下的 Agent 协作
使用方法
安装
# 通过 npm 安装 CLI 工具
npm install -g @oh-my-claude/omc
# 或者克隆整个仓库获取完整框架
git clone https://github.com/Yeachan-Heo/oh-my-claudecode.git
cd oh-my-claudecode
基础调用
# 启动多 Agent 会话
omc start --project ./my-project
# 指定 Agent 角色执行任务
omc run --agent planner --task "分析项目结构并制定开发计划"
# 使用内置技能
omc skill add oh-my-claudecode --skill code-review
最小示例
在项目根目录运行 omc interactive 进入交互模式,系统会自动加载默认的 Agent 组合(Planner + Executor + Reviewer),用户用自然语言描述任务后,多 Agent 协作自动开始。
使用场景与人群
适用场景:
- 大型前端/后端项目的多人协作开发
- 需要跨模块(前端、后端、测试、运维)并行推进的复杂任务
- Code Review 流程的自动化执行
- 团队内部 AI 编码规范的统一执行
目标用户:
- 已在团队中规模化部署 Claude Code 的技术负责人
- 希望将 AI 编码工具从”个人效率提升”升级为”团队协作增强”的开发者
- 对 Agent 编排、多角色协同有实践需求的 AI 工程化团队
输入与输出案例
案例 1:多模块并行开发
Input:
omc run --task "为一个电商项目同步开发用户模块、商品模块和订单模块"
Output:
[Planner Agent] 任务已拆解为 3 个子任务:
→ User Module: 负责用户注册/登录/权限
→ Product Module: 负责商品展示/搜索/分类
→ Order Module: 负责下单/支付/物流
[Executor Agent × 3] 三个子任务并行执行中...
[Reviewer Agent] User Module 代码审查通过,发现 2 处潜在 NPE,已修复
[Reviewer Agent] Product Module 代码审查通过
[Reviewer Agent] Order Module 代码审查通过,发现 1 处事务问题,已修复
[Reporter Agent] 汇总:3 个模块开发完成,代码质量良好
案例 2:自动化 Code Review
Input:
omc run --agent reviewer --task "Review 最新提交的 PR #3541"
Output:
[Reviewer Agent] 正在分析 PR #3541 差异...
→ 文件变更:12 个文件,+486 行 / -123 行
→ 发现:1 处类型安全问题(已建议修复)
→ 发现:2 处测试覆盖不足
→ 总体评分:8.5/10,建议合并前处理类型问题
评论区
登录后可评论。