ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

oh-my-claudecode 土耳其语入门指南:安装、Team 模式与多智能体编排实战

oh-my-claudecode 土耳其语入门指南:安装、Team 模式与多智能体编排实战 oh-my-claudecode 土耳其语入门指南安装、Team 模式与多智能体编排实战【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecodeoh-my-claudecode简称 OMC是一个面向 Claude Code 的多智能体编排系统核心理念是零学习曲线——不需要逐个学习 Claude Code 的命令只需要用自然语言描述需求由 OMC 的 Team 管道、魔法关键词和技能注入机制在后台完成规划、执行、验证与修复。本文基于当前仓库的 README.tr.md结合仓库内源码文件逐一讲解安装配置、Team 模式工作原理、编排模式选择、魔法关键词机制、自定义技能以及 OpenClaw 等辅助工具帮助读者掌握从安装到实际运行一次多智能体任务的完整路径。快速开始三步安装第 1 步安装插件/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode /plugin install oh-my-claudecode第 2 步运行配置向导/oh-my-claudecode:omc-setup这里有一个重要的前提条件如果你是通过omc --plugin-dir path或claude --plugin-dir path方式启动 OMC则必须在omc setup时附加--plugin-dir-mode参数或提前导出OMC_PLUGIN_ROOT环境变量以避免插件重复注册它本身已在运行时提供的技能/智能体。完整的决策矩阵和全部标志位参见 docs/REFERENCE.md 中的 Plugin directory flags 章节。从该文档可以看到omc --plugin-dir path会解析该参数、将其解析为绝对路径、设置OMC_PLUGIN_ROOT环境变量然后把标志原样透传给 Claude Code显式--plugin-dir标志优先于已存在的OMC_PLUGIN_ROOT不一致时会给出警告单靠--plugin-dir只影响当前会话必须配合omc setup --plugin-dir-mode或在环境中设置OMC_PLUGIN_ROOT触发自动检测HUD、hooks 和 CLAUDE.md 才会安装到该 checkout 上。第 3 步创建东西autopilot: build a REST API for managing tasks就这样。其余全部自动完成。包命名说明项目使用oh-my-claudecode作为品牌名仓库、插件、命令但 npm 上的包名是oh-my-claude-sisyphus可以在 package.json 中确认name: oh-my-claude-sisyphus当前仓库版本为 5.0.2。如果通过 npm/bun 安装 CLI 工具请使用npm install -g oh-my-claude-sisyphus。Team 模式规范的多智能体编排面从v4.1.7开始Team是 OMC 中规范化的canonical编排入口。旧的swarm和ultrapilot入口仍然受支持但内部会重定向到 Team。/oh-my-claudecode:team 3:executor fix all TypeScript errorsTeam 以分阶段管道pipeline方式运行team-plan → team-prd → team-exec → team-verify → team-fix (loop)这条管道的状态迁移逻辑在源码中有明确定义。src/hooks/team-pipeline/transitions.ts 中的合法迁移表为team-plan → team-prd team-prd → team-exec team-exec → team-verify team-verify → team-fix | complete | failed team-fix → team-exec | team-verify | complete | failed也就是说验证verify失败后会进入team-fix修复阶段修复后可再次进入执行或验证形成循环直到complete或failed终止。该文件还包含迁移守卫例如进入team-exec之前必须已有plan_path或prd_path工件进入team-verify前要求tasks_total 0——这从源码层面印证了文档中分阶段管道的严谨性。启用 Claude Code 原生 teams 需要在~/.claude/settings.json中打开实验开关{ env: { CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: 1 } }如果 Teams 未启用OMC 会给出警告并在可能的情况下降级为无 Team 运行。更新与故障排查# 1. 更新插件 /plugin install oh-my-claudecode # 2. 重新运行 setup 以刷新配置 /oh-my-claudecode:omc-setup更新后遇到问题时清除旧插件缓存/oh-my-claudecode:omc-doctor为什么选择 oh-my-claudecode零配置——智能默认值开箱即用Team-first 编排——Team 是规范的多智能体面swarm/ultrapilot 为兼容面自然语言界面——无需记忆命令只需描述需求自动并行化——复杂任务分发给专门化智能体持久执行——在任务验证完成前不罢休成本优化——智能模型路由文档声称可减少 30–50% 的 token 开销经验学习——自动提炼并复用问题求解模式实时可视化——HUD statusline 展示后台进展编排模式针对不同使用场景提供多种策略——从 Team 支持的编排到 token 高效的重构。模式说明适用场景Team推荐规范分阶段管道team-plan → team-prd → team-exec → team-verify → team-fix在共享任务列表上协作的协调智能体Autopilot自主执行单一 leader 智能体最小仪式感的端到端功能开发Ultrawork最大并行度不依赖 Team不需要 Team 时的并行修复/重构Ralph带验证/修复循环的持久模式必须完全完成的任务不允许静默的部分结果EcomodeToken 高效路由预算敏感的迭代Pipeline顺序分阶段处理严格排序的多步转换Swarm / Ultrapilot旧重定向到Team的兼容面现有工作流与旧文档智能编排与智能体专门化智能体——覆盖架构、研究、设计、测试、数据科学等方向。仓库src/agents/目录下包含 19 个智能体定义文件如analyst.ts、architect.ts、executor.ts、tracer.ts等配合 agents/ 目录中的 19 个 Markdown 智能体模板构成可加载的智能体面README 宣称的32 个专门化智能体应理解为含内置角色在内的整体能力面智能模型路由——简单任务用 Haiku复杂推理用 Opus自动委托——始终为正确的任务匹配正确的智能体魔法关键词面向高级用户的可选快捷方式。自然语言在没有它们时也能正常工作。关键词效果示例team规范 Team 编排/oh-my-claudecode:team 3:executor fix all TypeScript errorsautopilot完全自主执行autopilot: build a todo appralph持久模式ralph: refactor authulw最大并行度ulw fix all errorsecoToken 高效执行eco: migrate databaseplan规划访谈plan the APIralplan迭代式规划共识ralplan this featureswarm旧关键词重定向到 Teamswarm 5 agents: fix lint errorsultrapilot旧关键词重定向到 Teamultrapilot: build a fullstack app说明ralph 包含 ultrawork启用 ralph 模式时自动包含 ultrawork 的并行执行。swarm N agents语法仍被识别用于推断智能体数量但 v4.1.7 的运行时基于 Team。从源码结构看关键词检测由 src/hooks/keyword-detector/index.ts 实现每个模式定义了一个正则模式如ralph、autopilot、ralplan并按KEYWORD_PRIORITY优先级排序cancel → ralph → autopilot → team → ralplan → tdd → ...。一个值得注意的实现细节是team关键词的正则被替换为永不匹配的空位符注释说明team 关键词检测已禁用——team 模式现在仅通过/team技能显式触发以防止 Claude worker 收到包含 team 字样的提示时造成无限派生。这解释了为什么表格中team必须用斜杠命令形式触发而不是裸关键词。此外仓库还有一层独立的魔法关键词增强机制见 src/features/magic-keywords.ts它在提示词中检测search/analyze/ultrathink等触发词并改写提示以激活搜索、深度分析或扩展思考模式例如检测到think时会剥离触发词并注入扩展推理指令。该模块在检测前会先移除代码块与内联代码并且当关键词出现在信息性语境如 what is ... / explain ...附近时会抑制触发避免误报——这类防误报设计保证了魔法关键词在真实对话中的稳定性。开发者体验HUD、技能学习与自定义技能HUD statusline——在状态栏中实时显示编排指标。注意如果直接用claude --plugin-dir path启动绕过omcshim需在 shell 中导出OMC_PLUGIN_ROOTpath让 HUD 包装器与插件加载器解析到同一 checkout细节见 docs/REFERENCE.md 的 Plugin directory flags 章节技能学习——从会话中提炼可复用模式分析与成本跟踪——理解所有会话中的 token 使用自定义技能一次学习永久复用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:42deki handlerı try/except ClientDisconnectedError ile sarın...技能管理/skill list | add | remove | edit | search自动学习/skillify以严格质量标准提炼可复用模式自动注入匹配的技能自动加载到上下文无需手动调用从源码结构看这两个目录的路径约定在 src/hooks/learner/constants.ts 中定义~/.omc/skills为全局技能目录src/hooks/learner/types.ts 则区分技能来自用户目录~/.omc/skills或~/.claude/skills/omc-learned还是项目目录.omc/skills与上表的作用域/优先级模型一致。辅助工具Rate Limit 等待omc wait当限流重置时自动续接 Claude Code 会话omc wait # 查看状态获取指导 omc wait --start # 启用自动续接守护进程 omc wait --stop # 禁用守护进程依赖tmux用于会话检测实现位于 src/features/rate-limit-wait/包含daemon.ts、rate-limit-monitor.ts、tmux-detector.ts等模块命令行入口在 src/cli/commands/wait.ts该文件注释还提到omc wait status查看限流与守护进程状态和omc wait daemon start启动后台守护进程等子命令。通知标签Telegram/Discord可以配置 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 telegram --add-tag charlie omc config-stop-callback discord --remove-tag here omc config-stop-callback discord --clear-tags标签行为Telegramalice与alice会被归一化处理Discord支持here、everyone、数字用户 ID 与role:idfile回调忽略标签选项OpenClaw 集成将 Claude Code 会话事件转发到 OpenClaw 网关通过你的 OpenClaw 智能体构建自动应答与工作流。快速安装推荐/oh-my-claudecode:configure-notifications # → 提示时输入 openclaw → 选择 OpenClaw Gateway手动安装创建~/.claude/omc_config.openclaw.json文件该默认路径与 src/openclaw/config.ts 中读取的配置位置一致{ 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_OPENCLAW1启用 OpenClawOMC_OPENCLAW_DEBUG1启用调试日志OMC_OPENCLAW_CONFIG/path/to/config.json覆盖配置文件路径支持的 hook 事件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}}这些唤醒点在 src/hooks/bridge.ts 中可以确认_openclaw.wake(keyword-detector, ...)、_openclaw.wake(stop, ...)、_openclaw.wake(session-start, ...)、_openclaw.wake(ask-user-question, ...)等调用分别挂在对应 hook 位置事件类型定义在 src/openclaw/types.ts。响应渠道环境变量变量说明OPENCLAW_REPLY_CHANNEL响应渠道如discordOPENCLAW_REPLY_TARGET渠道 IDOPENCLAW_REPLY_THREAD线程 ID将 OpenClaw 负载转发到自定义 HTTPS 自动化端点的参考网关见 scripts/openclaw-gateway-demo.mjs。文档索引完整参考——完整的功能文档性能监控——智能体跟踪、调试与优化迁移指南——从 v2.x 升级架构——底层工作原理CONTRIBUTING.md——Fork、本地 checkout、以启用插件方式挂载、跑测试、发 PR 的完整开发者指南需求与可选的多 AI 编排硬性需求Claude Code CLIClaude Max/Pro 订阅或 Anthropic API 密钥可选多 AI 编排。OMC 可以为交叉验证与设计一致性使用外部 AI 提供商。这些不是必需的——没有它们 OMC 也能完整工作。提供商安装提供什么Gemini CLInpm install -g google/gemini-cli设计评审、UI 一致性1M token 上下文Codex CLInpm install -g openai/codex架构验证、代码评审交叉检查成本参考文档口径3 个 Pro 计划Claude Gemini ChatGPT每月约 $60 即可覆盖全部。许可MIT。适用前提小结本文基于当前仓库内容npm 包版本 5.0.2Team 管道的规范行为自 v4.1.7 起生效omc wait需要 tmux--plugin-dir流程需要配合--plugin-dir-mode或OMC_PLUGIN_ROOT。命令与配置以 docs/REFERENCE.md 为权威参考。【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表