news 2026/9/6 21:25:38

oh-my-claudecode：Claude Code 多智能体编排完全指南 —— Team 流水线、魔法关键词与技能学习实战

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
oh-my-claudecode：Claude Code 多智能体编排完全指南 —— Team 流水线、魔法关键词与技能学习实战

oh-my-claudecode：Claude Code 多智能体编排完全指南 —— Team 流水线、魔法关键词与技能学习实战

【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode

oh-my-claudecode（下称 OMC）是一个为 Claude Code 提供「Teams-first」多智能体编排的开源项目，主打零学习成本：你不需要先精通 Claude Code，直接使用autopilot、/team等自然语言指令即可驱动多个专业智能体协作完成开发任务。本文基于仓库根目录的 README.ja.md（官方日语版 README，内容与英文版保持一致）完整展开，并结合src/team/、src/lib/mode-names.ts等源码位置，讲清安装配置、Team 阶段流水线、tmux CLI 多模型工作器、魔法关键词检测、可复用技能文件以及速率限制/通知/OpenClaw 等实用工具链的实现原理，读完后你可以独立完成 OMC 的部署、模式选择与日常运维。

项目定位与核心价值

OMC 的核心主张是「多智能体编排 + 零学习成本」：安装为 Claude Code 插件后，用户用自然语言描述目标，OMC 自动完成规划、并行分发、执行与验证。其 npm 包名为oh-my-claude-sisyphus（仓库、插件、命令统一使用品牌名 oh-my-claudecode），当前仓库 package.json 中版本为 5.0.2，MIT 许可，CLI 入口注册为omc/oh-my-claudecode/omc-cli三个 bin，运行环境要求 Node 20.x～26.x。

官方 README 中列出的设计目标包括：

  • 零配置：合理的默认值，安装即可用；
  • Team 优先编排：Team 是标准多智能体界面，swarm/ultrapilot等旧入口仅作为兼容门面保留；
  • 自然语言界面：无需记忆命令，直接说出想做的事；
  • 自动并行：复杂任务自动拆分给专业智能体；
  • 持久执行：不验证完成不罢休；
  • 成本优化：智能模型路由，README 声称可节省 30～50% token；
  • 经验学习：自动抽取可复用的问题求解模式；
  • 实时可视化：HUD 状态行展示编排背后进展。

从源码结构看，这些目标对应清晰的模块划分：src/team/下包含 100+ 文件（stage-router.ts、role-router.ts、task-router.ts、runtime-v2.ts、git-worktree.ts、merge-orchestrator.ts等），覆盖阶段路由、角色路由、任务分发、tmux 运行时与 Git worktree 隔离；src/hooks/下则按功能拆出autopilot/、ralph/、learner/、wiki/、project-memory/等约 40 个钩子目录。

快速开始

第一步：安装插件

在 Claude Code 中执行：

/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode /plugin install oh-my-claudecode

第二步：运行 Setup

/omc-setup

一个需要注意的细节：如果你通过omc --plugin-dir <path>或claude --plugin-dir <path>方式运行 OMC，omc setup需要追加--plugin-dir-mode参数（或提前导出环境变量OMC_PLUGIN_ROOT），以避免与插件在运行时已提供的技能/智能体重复。完整的判定矩阵与全部可用 flag 见 docs/REFERENCE.md 的Plugin directory flags一节。

第三步：开始构建

autopilot: build a REST API for managing tasks

此后流程自动推进。

需求不明确时：深度访谈

如果需求模糊、只有笼统的想法，或者希望在写代码前充分控制设计，可以使用/deep-interview：

/deep-interview "I want to build a task management app"

深度访谈采用苏格拉底式提问法，在编码前澄清思路：暴露隐藏假设，并按「加权维度」对需求清晰度打分，让你在开工前精确知道要构建什么。源码侧对应 src/features/magic-keywords.ts 中的模式注册机制与 skills/deep-interview/SKILL.md 技能定义。

Team 模式（标准编排方式）

自v4.1.7起，Team是 OMC 的标准编排方式。swarm、ultrapilot等旧入口仍受支持，但内部会被路由到 Team。源码层面可以印证这一点：src/lib/mode-names.ts 将ultrapilot、swarm、pipeline列入DEPRECATED_MODE_NAMES（注释说明 pipeline 在 #1131 统一后废弃），而MODE_NAMES中保留的正式模式为autopilot、autoresearch、team、ralph、ralplan、deep-interview、merge-readiness、self-improve，并为每个模式定义了.omc/state/下的状态文件映射（如team-state.json、ralph-state.json），供会话结束时的清理与指标统计使用。

基本用法

/team 3:executor "fix all TypeScript errors"

Team 以阶段化流水线运行：

team-plan → team-prd → team-exec → team-verify → team-fix (loop)

即先规划、再生成 PRD、然后执行、验证，验证不通过则进入 fix 循环直至达标。该流程由 skills/team/SKILL.md 与src/team/下的stage-router.ts、phase-controller.ts等模块承载。

启用 Claude Code 原生团队

在~/.claude/settings.json中开启实验性 Agent Teams：

{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }

从 skills/team/SKILL.md 可以看到，Claude Code 2.1.178+ 移除了原生的TeamCreate/TeamDelete，开启该环境变量后每个会话拥有一个隐式团队，队友直接用 Agent/Task 工具配合不同name值生成。团队未启用时，OMC 会打印警告并在可能时回退到无 Team 的执行方式。

tmux CLI 工作器：Codex 与 Gemini（v4.4.0+）

v4.4.0 起，Codex/Gemini 的 MCP 服务器（x、gprovider）被移除，取而代之的是/omc-teams：在 tmux 分割窗格中启动真实 CLI 进程：

/omc-teams 2:codex "review auth module for security issues" /omc-teams 2:gemini "redesign UI components for accessibility" /omc-teams 1:claude "implement the payment flow"
技能工作器适用场景
/omc-teams N:codexN 个 Codex CLI 窗格代码审查、安全分析、架构
/omc-teams N:geminiN 个 Gemini CLI 窗格UI/UX 设计、文档、大上下文
/omc-teams N:claudeN 个 Claude CLI 窗格tmux 下的通用 Claude CLI 任务

如需同时听取 Codex 与 Gemini 的意见再让 Claude 整合，可用：

/ask codex "Review this PR — architecture" /ask gemini "Review this PR — UI components"

工作器按需启动、任务完成即退出，不占用空闲资源；前提是已安装codex/geminiCLI 并存在活跃的 tmux 会话。源码上，src/team/cli-detection.ts 负责探测codex、gemini等 CLI 是否可用；skills/team/SKILL.md 进一步描述了codex_worker（代码审查、安全分析、架构）与gemini_worker（UI/设计、文档、大上下文）的角色定位，并指出原生 Windows 下 psmux 提供的 tmux 兼容命令也被视为可用多路复用器。

命名说明：品牌名是 oh-my-claudecode（仓库、插件、命令），npm 包发布名为oh-my-claude-sisyphus，安装 CLI 工具时用npm install -g oh-my-claude-sisyphus。

更新流程

# 1. 更新 marketplace 克隆 /plugin marketplace update omc # 2. 重新执行 setup 以更新配置 /omc-setup

若未开启 marketplace 自动更新，需先手动执行/plugin marketplace update omc同步最新版本；更新后如遇问题，运行/omc-doctor清理陈旧插件缓存。

执行模式对照

README 给出的模式选型表如下：

模式特点用途
Team（推荐）阶段化流水线共享任务列表协作的 Claude 智能体
omc-teamstmux CLI 工作器Codex/Gemini CLI 任务；按需启动、完成即退
Autopilot自主执行极简流程的端到端功能开发
Ralph持久模式必须彻底完成的任务
Pipeline顺序处理需要严格顺序的多步转换
Swarm / Ultrapilot（遗留）路由到 Team兼容旧工作流与旧文档

智能体与路由方面，README 称 OMC 提供 32 个专业智能体（架构、研究、设计、测试、数据科学等），并按任务复杂度做模型路由：简单任务用 Haiku、复杂推理用 Opus。仓库agents/目录下可看到这些角色的提示词定义（如 agents/architect.md、agents/executor.md），而src/features/model-routing/与src/features/delegation-routing/目录则对应模型路由与委托分发逻辑。

魔法关键词

面向高级用户的可选快捷方式，自然语言同样有效：

关键词效果示例
team标准 Team 编排/team 3:executor "fix all TypeScript errors"
omc-teamstmux CLI 工作器（codex/gemini/claude）/omc-teams 2:codex "security review"
autopilot完全自主执行autopilot: build a todo app
ralph持久模式ralph: refactor auth
plan规划访谈plan the API
ralplan迭代式规划共识ralplan this feature
deep-interview苏格拉底式需求澄清deep-interview "vague idea"
swarm已废弃— 请改用teamswarm 5 agents: fix lint errors
ultrapilot已废弃— 请改用teamultrapilot: build a fullstack app

注意事项：

  • 并行任务请用 Team 或 executor 委托：多任务协调用/team，单一实现任务交给 executor，需要持续到验证通过则叠加 Ralph；
  • swarm N agents语法仍会被解析出智能体数量，但 v4.1.7+ 运行时已是 Team 基底。

源码层面，scripts/keyword-detector.mjs（及其模板版本 templates/hooks/keyword-detector.mjs）负责在提示提交时检测关键词并切换模式；src/features/magic-keywords.ts 则实现了另一类「行为增强关键词」：检测到search/analyze/ultrathink等触发词后，会向提示注入「最大化并行检索」「先收集上下文再深入」「扩展推理」等指令块，且检测前先剥离代码块、跳过「这是什么」一类信息性问句上下文（isInformationalKeywordContext），避免误触发——这些行为有 src/tests/keyword-detector-script.test.ts 等测试覆盖。

自定义技能：把调试经验变成可复用资产

OMC 会把调试过程中获得的知识抽取为可移植的技能文件，并在相关场景自动注入上下文。作用域规则：

项目作用域用户作用域
路径.omc/skills/~/.omc/skills/
共享范围团队（受版本控制）所有项目可用
优先级高（覆盖用户作用域）低（兜底）

技能文件格式示例：

# .omc/skills/fix-proxy-crash.md --- name: Fix Proxy Crash description: aiohttp proxy crashes on ClientDisconnectedError triggers: ["proxy", "aiohttp", "disconnected"] source: extracted --- 请将 server.py:42 的 handler 用 try/except ClientDisconnectedError 包裹……
  • 技能管理：/skill list | add | remove | edit | search；
  • 自动学习：/skillify按严格质量标准抽取可复用模式；
  • 自动注入：匹配到的技能自动载入上下文，无需手动调用。

注入机制由 scripts/skill-injector.mjs 实现，内置技能的权限矩阵见 src/config/builtin-skill-entitlements.json 与 scripts/generate-skill-entitlements.mjs；仓库skills/目录下也提供了 30 余个内置技能（autopilot/、ralph/、review/、verify/、ultragoal/等）作为模板参考。

实用工具

速率限制等待

Rate limit 重置后自动恢复 Claude Code 会话：

omc wait # 查看状态与指引 omc wait --start # 启用自动恢复守护 omc wait --stop # 关闭守护

依赖：tmux（用于会话探测）。相关实现见 src/features/rate-limit-wait/。

通知标签（Telegram / Discord / Slack）

stop 回调发送会话摘要时，可配置 @ 谁：

# 设置/整体替换标签列表 omc config-stop-callback telegram --enable --token <bot_token> --chat <chat_id> --tag-list "@alice,bob" omc config-stop-callback discord --enable --webhook <url> --tag-list "@here,123456789012345678,role:987654321098765432" omc config-stop-callback slack --enable --webhook <url> --tag-list "<!here>,<@U1234567890>" # 追加 / 删除 / 清空 omc config-stop-callback telegram --add-tag charlie omc config-stop-callback discord --remove-tag @here omc config-stop-callback discord --clear-tags

各平台标签归一化规则：

  • Telegram：alice自动归一化为@alice；
  • Discord：支持@here、@everyone、纯数字用户 ID、role:<id>；
  • Slack：支持<@MEMBER_ID>、<!channel>、<!here>、<!everyone>、<!subteam^GROUP_ID>；
  • file回调忽略标签选项。

OpenClaw 集成

将 Claude Code 会话事件转发到 OpenClaw 网关，实现经 OpenClaw 智能体的自动应答与工作流。

快速设置（推荐）：

/oh-my-claudecode:configure-notifications # → 提示输入 "openclaw" → 选择 "OpenClaw Gateway"

手动设置：创建~/.claude/omc_config.openclaw.json：

{ "enabled": true, "gateways": { "my-gateway": { "url": "https://your-gateway.example.com/wake", "headers": { "Authorization": "Bearer YOUR_TOKEN" }, "method": "POST", "timeout": 10000 } }, "hooks": { "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true }, "stop": { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true } } }

环境变量：

变量说明
OMC_OPENCLAW=1启用 OpenClaw
OMC_OPENCLAW_DEBUG=1启用调试日志
OMC_OPENCLAW_CONFIG=/path/to/config.json指定配置文件路径

支持的钩子事件（bridge 中 6 个处于激活状态）：

事件触发时机主要模板变量
session-start会话开始{{sessionId}}、{{projectName}}、{{projectPath}}
stopClaude 响应完成{{sessionId}}、{{projectName}}
keyword-detector每次提交提示词{{prompt}}、{{sessionId}}
ask-user-questionClaude 请求用户输入{{question}}、{{sessionId}}
pre-tool-use工具调用前（高频）{{toolName}}、{{sessionId}}
post-tool-use工具调用后（高频）{{toolName}}、{{sessionId}}

Reply Channel 环境变量：

变量说明
OPENCLAW_REPLY_CHANNEL回复渠道（如discord）
OPENCLAW_REPLY_TARGET渠道 ID
OPENCLAW_REPLY_THREAD线程 ID

需要把 OpenClaw 负载中继到自定义 HTTPS 自动化端点的参考网关实现，可查看 scripts/openclaw-gateway-demo.mjs；src/openclaw/目录（12 个源文件）承载了网关客户端与事件转发的核心逻辑。

运行环境与可选的多 AI 编排

基础要求：Claude Code CLI，以及 Claude Max/Pro 订阅或 Anthropic API Key。

OMC 可选地利用外部 AI provider 做交叉验证与设计一致性检查——非必需，缺少它们 OMC 也能完整运行：

Provider安装能力
Gemini CLInpm install -g @google/gemini-cli设计评审、UI 一致性（1M token 上下文）
Codex CLInpm install -g @openai/codex架构校验、代码评审交叉检查

README 估计：Claude + Gemini + ChatGPT 三个 Pro 订阅每月约 $60 即可覆盖上述组合。

延伸阅读

仓库内与本文主题直接相关的文档：

  • docs/REFERENCE.md— 全功能完整参考（含 Plugin directory flags 判定矩阵）；
  • docs/MIGRATION.md— 从 v2.x 升级的迁移指南；
  • docs/ARCHITECTURE.md— 内部架构说明；
  • docs/PERFORMANCE-MONITORING.md— 智能体追踪、调试与性能优化；
  • docs/COMPATIBILITY.md— 兼容性说明；
  • CONTRIBUTING.md— 贡献流程（fork、本地 checkout、以激活插件方式 link、跑测试、提 PR）；
  • skills/team/SKILL.md— Team 模式的完整技能定义，含 tmux 工作器细节与 Windows psmux 门控说明。

小结：OMC 把「多智能体编排」封装成一层可直接说人话的界面——/plugin安装、/omc-setup初始化之后，team-plan → team-prd → team-exec → team-verify → team-fix流水线负责交付质量，魔法关键词提供快捷控制，技能系统让每次排障经验沉淀为可自动注入的资产，而omc wait、通知标签与 OpenClaw 网关则补齐了长任务运维侧的能力。上述所有命令、配置与路径均取自当前仓库（v5.0.2），可据此直接复制使用。

【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/9/6 21:25:33

Video2X：免费AI视频超分框架，把老视频拉到4K只要一条命令

Video2X&#xff1a;免费AI视频超分框架&#xff0c;把老视频拉到4K只要一条命令 【免费下载链接】video2x A machine learning-based video super resolution and frame interpolation framework. Est. Hack the Valley II, 2018. 项目地址: https://gitcode.com/GitHub_Tre…

作者头像 李华
网站建设 2026/9/6 21:19:23

信号少胜率高：通达信主升浪选股公式源码全解析

简介&#xff1a;通达信信号少胜率高公式源码文档&#xff0c;面向股票与期货投资者、量化交易初学者&#xff0c;用于减少无效信号、提升交易胜率。内容围绕“信号少胜率高”公式展开&#xff0c;逐段拆解AI:AMOUNT/VOL/100、C0:REF(C,2)*0.865、C1:REF(C,13) 0.772、DSY:100…

作者头像 李华
网站建设 2026/9/6 21:14:13

ARINC 818航电视频总线：从协议解析到FPGA实现与调试实战

简介&#xff1a;ARINC 818是航空电子数字视频总线&#xff08;ADVB&#xff09;的核心标准之一&#xff0c;这份《ARINC 818 Implementer’s Guide》是一份面向协议实现者的实用指南&#xff0c;适合航空电子系统工程师、FPGA/PLD开发人员以及刚接触视频传输协议的读者&#x…

作者头像 李华
网站建设 2026/9/6 21:13:31

欧姆龙PLC指令体系实战拆解：从基础到避坑指南

简介&#xff1a;面向工业自动化工程师与PLC初学者的欧姆龙PLC指令速查文档&#xff0c;系统梳理LD、AND、OR、NOT、OUT等基本指令&#xff0c;以及ADD、SUB、MUL、DIV、MOV、CONV、FOR...NEXT、CALL、JMP等功能指令&#xff0c;并扩展串行通信、PID控制、高速计数、模拟量处理…

作者头像 李华
网站建设 2026/9/6 21:10:09

免费解锁 WeMod Pro：Wand-Enhancer 补丁工具快速上手指南

免费解锁 WeMod Pro&#xff1a;Wand-Enhancer 补丁工具快速上手指南 【免费下载链接】Wand-Enhancer Advanced UX and interoperability extension for Wand (WeMod) app 项目地址: https://gitcode.com/GitHub_Trending/we/Wand-Enhancer Wand-Enhancer 是一款开源、纯…

作者头像 李华