oh-my-claudecode omc-setup 收尾阶段全解析2.x 升级检测、魔法关键词与 Phase 4 完成流程实战【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecodeoh-my-claudecodeOMC是一套为 Claude Code 设计的 Teams-first 多智能体编排框架。当你运行/oh-my-claudecode:omc-setup完成前面三个阶段安装 CLAUDE.md、环境配置、集成配置后会进入最后一个阶段 —— Phase 4 Completion即skills/omc-setup/phases/04-welcome.md。这一阶段负责升级检测、欢迎信息展示、可选规则模板落盘、收藏提示与最终状态标记是整个安装向导的收口。读完本文你将掌握 Phase 4 每一步的执行逻辑、全部魔法关键词与退役命令的准确含义、规则模板的启用方法以及 setup 完成状态是如何被持久化与复用的。Phase 4 在安装向导中的定位omc-setup技能入口见 skills/omc-setup/SKILL.md把完整安装编排为顺序执行的四个阶段文件位于 skills/omc-setup/phases/Phase 1 – Install CLAUDE.md01-install-claude-md.mdPhase 2 – Environment Configuration02-configure.mdHUD/statusLine 必须委托给hud技能Phase 3 – Integration Setup03-integrations.md插件校验、MCP 指针说明、可选 agent teams 配置Phase 4 – Completion04-welcome.md本文主题读完执行即可每个阶段结束后都会通过scripts/setup-progress.sh save记录进度因此中断后可用setup-progress.sh resume从断点续跑避免重复烧 token。Phase 4 本身不做安装决策只完成三件事识别升级来源、按身份给出收尾引导、把“已完成”状态写进持久化配置最后一步调用bash ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh complete $OMC_VERSION收口注意其中变量实际是OMC_SETUP_PLUGIN_ROOT。第一步检测是否来自 2.x 的升级Phase 4 的第一项任务是区分“全新用户”与“从 2.x 升级的用户”。关键判据是旧的 2.x 配置遗留物ralph-loop.md是否存在CONFIG_DIR${CLAUDE_CONFIG_DIR:-$HOME/.claude} case $CONFIG_DIR in ~) CONFIG_DIR$HOME ;; ~/*) CONFIG_DIR$HOME/${CONFIG_DIR#\~/} ;; ~\\*) CONFIG_DIR$HOME/${CONFIG_DIR#\~\\} ;; esac ls $CONFIG_DIR/commands/ralph-loop.md 2/dev/null文件存在 → 判定为 2.x 升级置IS_UPGRADEtrue文件不存在 → 全新安装。这里反复出现的CONFIG_DIR归一化逻辑~、~/、~\三种形态还原为绝对路径在整个安装流程中被一致使用其正式实现封装在 scripts/lib/config-dir.sh 的resolve_claude_config_dir()中并由scripts/setup-progress.sh引用保证配置目录解析在保存状态、检测已完成状态等环节行为一致。展示欢迎信息新用户版当IS_UPGRADE不为 true 时展示面向新用户的欢迎信息。它最核心的传播理念是OMC 完成安装后不需要你额外学习一堆命令——多数能力通过“魔法关键词”在自然语言中自动激活。自动行为与魔法关键词总表安装完成后以下行为自动生效复杂任务 → 自动并行化并委派给专业智能体探索、架构、执行、审查等分工。同时提供可选的“魔法关键词”快捷方式——直接在请求里自然地带入这些词即可。文档中的完整速查表如下KeywordEffectExampleautopilotAutonomous executionautopilot build me a todo appralphPersistence moderalph: fix the auth bugralplanIterative consensus planningralplan this featuredeep interviewRequirements interviewdeep interview me before codingdeslop / anti-slopCleanup reviewdeslop this moduledeep-analyzeAnalysis modedeep-analyze the flaky testtddTDD modetdd the parserdeepsearchCodebase searchdeepsearch where config is loadedultrathinkDeep reasoningultrathink this designcancelomcStop active OMC modescancelomc其中搜索/分析/深度推理类的关键词在仓库中有直接的实现样本src/features/magic-keywords.ts。该模块用正则探测提示词中的 trigger 词并注入增强指令如 search 模式会要求并行启动多个 explore/document-specialist agent、要求“不要停在第一个结果”并带有两处防御设计先通过removeCodeBlocks剥离 与代码片段避免代码里的词误触发通过isInformationalKeywordContext判断命中词前后约 80 字符内是否属于“这是什么 / 怎么用 / explain / 使い方 / 如何使用”等问句意图——若是提问则豁免避免用户问“autopilot 是什么”时反而被切成 autopilot 执行模式。autopilot、ralph、deep interview等词则对应仓库中的同名 skill见 skills/autopilot/SKILL.md、skills/ralph/SKILL.md 等与 keyword-detector 侧挂钩协同作为“自动激活”的载体。规范工作流Tier-0与命令命名空间欢迎信息同时给出五条顶级规范工作流omc-plan - execute - omc-review - verify前两者以omc-plan、omc-review命名通过/oh-my-claudecode:omc-plan、/oh-my-claudecode:omc-review调用execute、verify阶段由衔接机制接力/deep-interview与/ralplan是独立的规划类工作流/research与/team属于内部通道/autopilot、/autoresearch、/ralph、/ultragoal保持可直接调用。注意 OMC 当前没有裸的team魔法词团队编排一律通过显式/team命令完成。使用 Teams 孵化协调智能体欢迎信息为希望使用 Claude Code 实验性 agent teams 的用户给出样例/oh-my-claudecode:team 3:executor fix all TypeScript errors /oh-my-claudecode:team 5:debugger fix build errors in src/即“N 个同类型 agent 共享任务列表 实时消息”的协调模式。这些 teams 使用 Claude Code 的隐式 agent teamClaude Code 2.1.178 直接用带 distinctname的 teammate 拉起无需 TeamCreate/TeamDelete。需要提示的是agent teams 是实验特性必须在settings.json设置CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1才会启用——这一点由 skills/omc-setup/phases/03-integrations.md 在 Phase 3 询问并写入Phase 4 只负责引导使用。注册额外 MCP ServerOMC 自身的 bundled MCP serverbridge/mcp-server.cjs已随插件的.mcp.json注册无需手动操作。若要再挂 web search、GitHub 等额外 MCP请走 Claude Code 原生 MCP 配置面claude mcp add name ...详见claude mcp --help或直接编辑由CLAUDE_MCP_CONFIG_PATH指定的原生 MCP 配置默认是${CLAUDE_CONFIG_DIR:-$HOME/.claude}同级的.claude.json。HUD 状态栏与 OMC CLI 助手欢迎信息提示状态栏现在会展示 OMC 状态重启 Claude Code 后即可看到。若同时安装了 CLI 助手可用如下命令omc hud - Render the current HUD statusline omc teleport - Create an isolated git worktree omc team status - Inspect a running team job其中omc teleport、omc team status均有对应的命令行实现见 src/cli/commands/teleport.ts 与 src/cli/commands/team.ts会话摘要写入.omc/sessions/*.json。收尾语是“Thats it! Just use Claude Code normally.”——即到此为止正常使用即可。5.0.0 起退役的命令与关键词面向所有用户欢迎信息里有一段“Retired in 5.0.0 (all users)”列明 5.0.0 中被移除且不再提供别名的命令与关键词/ultrawork, /ultraqa, /ultrapilot, /swarm, /pipeline, /merge-readiness, /deep-dive, /sciomc, /ccg, /omc-teams, /setup, /mcp-setup, /omc-reference, /learner, /writer-memory, /local-build-reminder文档给出的常见替代方案/execute替代 ultrawork/verify替代 ultraqa/team替代 omc-teams/omc-setup替代 setup/wiki替代 omc-referenceMCP 类mcp-setup改用 Claude Code 原生 MCP 配置。完整的替换映射表位于仓库根目录的 docs/MIGRATION.md其中v4.x → v5.0: Workflow Retirement一节以表格形式列出了 17 个被移除工作流及逐项替代方案包括ultrawork→/oh-my-claudecode:execute 或 /team、learner/writer-memory→/oh-my-claudecode:remember等升级后应先去查阅该表再决定迁移动作。面向 2.x 升级用户的欢迎信息当检测到 2.x 配置IS_UPGRADEtrue时展示的是另一个更简短的版本重点强调三件事部分命令已在 5.0.0 退役且不设别名请按迁移表替换3.0 起无需再记命令——行为自动激活说 “autopilot build me ...” 取代/autopilot说 “ralph: ” 取代/ralph说 “cancelomc” 取代/cancel老命令到新关键词的速查表KeywordSame as old...Exampleautopilot/autopilotautopilot build me a todo appralph/ralphralph: fix the bugralplan/ralplanralplan this featuredeep interview/deep-interviewdeep interview me before codingcancelomc/cancelcancelomc升级版同样包含 Teams、HUD 与 CLI 助手提示并额外说明既有配置会被完整保留已退役命令不会被重建。可选规则模板自动注入项目上下文OMC 提供一套规则模板可复制到项目根目录的.claude/rules/由系统自动发现并注入到该项目的所有 agent 上下文中。模板清单来自仓库 templates/rules/TemplatePurposecoding-style.mdCode style, immutability, file organizationtesting.mdTDD workflow, 80% coverage targetsecurity.mdSecret management, input validationperformance.mdModel selection, context managementgit-workflow.mdCommit conventions, PR workflowkarpathy-guidelines.mdCoding discipline -- think before coding, simplicity, surgical changes启用方式一次性全量复制或按需挑选mkdir -p .claude/rules cp ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/templates/rules/*.md .claude/rules/详细说明见 templates/rules/README.md该 README 补充了两个关键细节——模板内带有[CUSTOMIZE]标记指示用户按项目补充专属准则.claude/rules/*.md会被 oh-my-claudecode 自动发现并注入到项目中所有 agent 的上下文因此先复制、再按项目定制是推荐流程。询问是否收藏仓库Ask About Starring收尾前会礼貌地征询一次是否给项目加星且严格“静默、非阻塞”gh auth status /dev/nullgh 可用且已认证先探测仓库是否已被加星gh api user/starred/Yeachan-Heo/oh-my-claudecode /dev/null已加星exit code 0→ 跳过询问直接进入完成阶段未加星 → 通过 AskUserQuestion 询问选项为Yes, star it! / No thanks / Maybe later选择加星时执行gh api -X PUT /user/starred/Yeachan-Heo/oh-my-claudecode 2/dev/null echo Thanks for starring! || true该 API 调用即使失败也静默吞掉|| true绝不阻塞安装完成的流程gh 不可用或未认证仅打印一行文字提示不调用 API。标记完成版本采集与 setup 状态持久化Phase 4 最后一步是获取当前 OMC 版本并把完成状态写入持久化配置。版本采集有三级回退OMC_VERSION CONFIG_DIR${CLAUDE_CONFIG_DIR:-$HOME/.claude} case $CONFIG_DIR in ~) CONFIG_DIR$HOME ;; ~/*) CONFIG_DIR$HOME/${CONFIG_DIR#\~/} ;; ~\\*) CONFIG_DIR$HOME/${CONFIG_DIR#\~\\} ;; esac if [ -f .claude/CLAUDE.md ]; then OMC_VERSION$(grep -m1 OMC:VERSION: .claude/CLAUDE.md 2/dev/null | sed -E s/.*OMC:VERSION:([^ ]).*/\1/ || true) elif [ -f $CONFIG_DIR/CLAUDE.md ]; then OMC_VERSION$(grep -m1 OMC:VERSION: $CONFIG_DIR/CLAUDE.md 2/dev/null | sed -E s/.*OMC:VERSION:([^ ]).*/\1/ || true) fi if [ -z $OMC_VERSION ]; then OMC_VERSION$(omc --version 2/dev/null | head -1 || true) fi if [ -z $OMC_VERSION ]; then OMC_VERSIONunknown fi bash ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh complete $OMC_VERSION版本号的最终事实来源是CLAUDE.md顶部的!-- OMC:VERSION:5.0.2 --注释标记当前仓库根目录 CLAUDE.md 与 docs/CLAUDE.md 均为该格式它同时被scripts/generate-prompt-projections.mjs用于产物版本注入从而保证 CLAUDE.md、生成的 prompt 投影与omc --version之间版本一致。setup-progress.sh complete的实现见 scripts/setup-progress.sh值得注意它比“写个标记”复杂得多清理临时状态删除.omc/state/setup-state.json并按CLAUDE_SESSION_ID或CLAUDECODE_SESSION_ID清理嵌套 skill 遗留的skill-active-state.json否则 stop hook 会以 “skill still executing” 拦截收尾无会话 ID 时仅清理超过 30 分钟的老文件幂等合并写入读取${CLAUDE_CONFIG_DIR:-$HOME/.claude}/.omc-config.json存在与否均可用jq原子合并setupCompleted: ISO时间与setupVersion: 版本两个字段通过mktempmv保证写入安全版本号落库的意义Pre-Setup 检查见 skills/omc-setup/SKILL.md正是读取同一文件的setupCompleted/setupVersion字段来判断“已配置”。因此之后每次更新只需运行/oh-my-claudecode:omc-setup就会被识别为已配置并提供“只刷新 CLAUDE.md 清理退役配置值、跳过完整向导”的快捷更新路径而无需重走全部四阶段。小结与更新后的维护路径Phase 4 是安装向导的“验收与交接”环节它通过ralph-loop.md识别 2.x 升级者按身份输出不同的能力地图魔法关键词、Tier-0 工作流、Teams、MCP、HUD、CLI 助手提示 5.0.0 退役命令并指向 docs/MIGRATION.md顺带把可选规则模板从 templates/rules/ 复制进项目最后把带版本号的完成标记原子写入.omc-config.json。后续维护只需要记住一点更新 OMC 后直接重跑/oh-my-claudecode:omc-setup无需加任何 flag在“Update CLAUDE.md and clear retired setup values”选项上确认即可无需为小版本更新付出完整向导的 token 成本。【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 oh-my-claudecode omc-setup 收尾阶段全解析：2.x 升级检测、魔法关键词与 Phase 4 完成流程实战
oh-my-claudecode omc-setup 收尾阶段全解析2.x 升级检测、魔法关键词与 Phase 4 完成流程实战【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecodeoh-my-claudecodeOMC是一套为 Claude Code 设计的 Teams-first 多智能体编排框架。当你运行/oh-my-claudecode:omc-setup完成前面三个阶段安装 CLAUDE.md、环境配置、集成配置后会进入最后一个阶段 —— Phase 4 Completion即skills/omc-setup/phases/04-welcome.md。这一阶段负责升级检测、欢迎信息展示、可选规则模板落盘、收藏提示与最终状态标记是整个安装向导的收口。读完本文你将掌握 Phase 4 每一步的执行逻辑、全部魔法关键词与退役命令的准确含义、规则模板的启用方法以及 setup 完成状态是如何被持久化与复用的。Phase 4 在安装向导中的定位omc-setup技能入口见 skills/omc-setup/SKILL.md把完整安装编排为顺序执行的四个阶段文件位于 skills/omc-setup/phases/Phase 1 – Install CLAUDE.md01-install-claude-md.mdPhase 2 – Environment Configuration02-configure.mdHUD/statusLine 必须委托给hud技能Phase 3 – Integration Setup03-integrations.md插件校验、MCP 指针说明、可选 agent teams 配置Phase 4 – Completion04-welcome.md本文主题读完执行即可每个阶段结束后都会通过scripts/setup-progress.sh save记录进度因此中断后可用setup-progress.sh resume从断点续跑避免重复烧 token。Phase 4 本身不做安装决策只完成三件事识别升级来源、按身份给出收尾引导、把“已完成”状态写进持久化配置最后一步调用bash ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh complete $OMC_VERSION收口注意其中变量实际是OMC_SETUP_PLUGIN_ROOT。第一步检测是否来自 2.x 的升级Phase 4 的第一项任务是区分“全新用户”与“从 2.x 升级的用户”。关键判据是旧的 2.x 配置遗留物ralph-loop.md是否存在CONFIG_DIR${CLAUDE_CONFIG_DIR:-$HOME/.claude} case $CONFIG_DIR in ~) CONFIG_DIR$HOME ;; ~/*) CONFIG_DIR$HOME/${CONFIG_DIR#\~/} ;; ~\\*) CONFIG_DIR$HOME/${CONFIG_DIR#\~\\} ;; esac ls $CONFIG_DIR/commands/ralph-loop.md 2/dev/null文件存在 → 判定为 2.x 升级置IS_UPGRADEtrue文件不存在 → 全新安装。这里反复出现的CONFIG_DIR归一化逻辑~、~/、~\三种形态还原为绝对路径在整个安装流程中被一致使用其正式实现封装在 scripts/lib/config-dir.sh 的resolve_claude_config_dir()中并由scripts/setup-progress.sh引用保证配置目录解析在保存状态、检测已完成状态等环节行为一致。展示欢迎信息新用户版当IS_UPGRADE不为 true 时展示面向新用户的欢迎信息。它最核心的传播理念是OMC 完成安装后不需要你额外学习一堆命令——多数能力通过“魔法关键词”在自然语言中自动激活。自动行为与魔法关键词总表安装完成后以下行为自动生效复杂任务 → 自动并行化并委派给专业智能体探索、架构、执行、审查等分工。同时提供可选的“魔法关键词”快捷方式——直接在请求里自然地带入这些词即可。文档中的完整速查表如下KeywordEffectExampleautopilotAutonomous executionautopilot build me a todo appralphPersistence moderalph: fix the auth bugralplanIterative consensus planningralplan this featuredeep interviewRequirements interviewdeep interview me before codingdeslop / anti-slopCleanup reviewdeslop this moduledeep-analyzeAnalysis modedeep-analyze the flaky testtddTDD modetdd the parserdeepsearchCodebase searchdeepsearch where config is loadedultrathinkDeep reasoningultrathink this designcancelomcStop active OMC modescancelomc其中搜索/分析/深度推理类的关键词在仓库中有直接的实现样本src/features/magic-keywords.ts。该模块用正则探测提示词中的 trigger 词并注入增强指令如 search 模式会要求并行启动多个 explore/document-specialist agent、要求“不要停在第一个结果”并带有两处防御设计先通过removeCodeBlocks剥离 与代码片段避免代码里的词误触发通过isInformationalKeywordContext判断命中词前后约 80 字符内是否属于“这是什么 / 怎么用 / explain / 使い方 / 如何使用”等问句意图——若是提问则豁免避免用户问“autopilot 是什么”时反而被切成 autopilot 执行模式。autopilot、ralph、deep interview等词则对应仓库中的同名 skill见 skills/autopilot/SKILL.md、skills/ralph/SKILL.md 等与 keyword-detector 侧挂钩协同作为“自动激活”的载体。规范工作流Tier-0与命令命名空间欢迎信息同时给出五条顶级规范工作流omc-plan - execute - omc-review - verify前两者以omc-plan、omc-review命名通过/oh-my-claudecode:omc-plan、/oh-my-claudecode:omc-review调用execute、verify阶段由衔接机制接力/deep-interview与/ralplan是独立的规划类工作流/research与/team属于内部通道/autopilot、/autoresearch、/ralph、/ultragoal保持可直接调用。注意 OMC 当前没有裸的team魔法词团队编排一律通过显式/team命令完成。使用 Teams 孵化协调智能体欢迎信息为希望使用 Claude Code 实验性 agent teams 的用户给出样例/oh-my-claudecode:team 3:executor fix all TypeScript errors /oh-my-claudecode:team 5:debugger fix build errors in src/即“N 个同类型 agent 共享任务列表 实时消息”的协调模式。这些 teams 使用 Claude Code 的隐式 agent teamClaude Code 2.1.178 直接用带 distinctname的 teammate 拉起无需 TeamCreate/TeamDelete。需要提示的是agent teams 是实验特性必须在settings.json设置CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1才会启用——这一点由 skills/omc-setup/phases/03-integrations.md 在 Phase 3 询问并写入Phase 4 只负责引导使用。注册额外 MCP ServerOMC 自身的 bundled MCP serverbridge/mcp-server.cjs已随插件的.mcp.json注册无需手动操作。若要再挂 web search、GitHub 等额外 MCP请走 Claude Code 原生 MCP 配置面claude mcp add name ...详见claude mcp --help或直接编辑由CLAUDE_MCP_CONFIG_PATH指定的原生 MCP 配置默认是${CLAUDE_CONFIG_DIR:-$HOME/.claude}同级的.claude.json。HUD 状态栏与 OMC CLI 助手欢迎信息提示状态栏现在会展示 OMC 状态重启 Claude Code 后即可看到。若同时安装了 CLI 助手可用如下命令omc hud - Render the current HUD statusline omc teleport - Create an isolated git worktree omc team status - Inspect a running team job其中omc teleport、omc team status均有对应的命令行实现见 src/cli/commands/teleport.ts 与 src/cli/commands/team.ts会话摘要写入.omc/sessions/*.json。收尾语是“Thats it! Just use Claude Code normally.”——即到此为止正常使用即可。5.0.0 起退役的命令与关键词面向所有用户欢迎信息里有一段“Retired in 5.0.0 (all users)”列明 5.0.0 中被移除且不再提供别名的命令与关键词/ultrawork, /ultraqa, /ultrapilot, /swarm, /pipeline, /merge-readiness, /deep-dive, /sciomc, /ccg, /omc-teams, /setup, /mcp-setup, /omc-reference, /learner, /writer-memory, /local-build-reminder文档给出的常见替代方案/execute替代 ultrawork/verify替代 ultraqa/team替代 omc-teams/omc-setup替代 setup/wiki替代 omc-referenceMCP 类mcp-setup改用 Claude Code 原生 MCP 配置。完整的替换映射表位于仓库根目录的 docs/MIGRATION.md其中v4.x → v5.0: Workflow Retirement一节以表格形式列出了 17 个被移除工作流及逐项替代方案包括ultrawork→/oh-my-claudecode:execute 或 /team、learner/writer-memory→/oh-my-claudecode:remember等升级后应先去查阅该表再决定迁移动作。面向 2.x 升级用户的欢迎信息当检测到 2.x 配置IS_UPGRADEtrue时展示的是另一个更简短的版本重点强调三件事部分命令已在 5.0.0 退役且不设别名请按迁移表替换3.0 起无需再记命令——行为自动激活说 “autopilot build me ...” 取代/autopilot说 “ralph: ” 取代/ralph说 “cancelomc” 取代/cancel老命令到新关键词的速查表KeywordSame as old...Exampleautopilot/autopilotautopilot build me a todo appralph/ralphralph: fix the bugralplan/ralplanralplan this featuredeep interview/deep-interviewdeep interview me before codingcancelomc/cancelcancelomc升级版同样包含 Teams、HUD 与 CLI 助手提示并额外说明既有配置会被完整保留已退役命令不会被重建。可选规则模板自动注入项目上下文OMC 提供一套规则模板可复制到项目根目录的.claude/rules/由系统自动发现并注入到该项目的所有 agent 上下文中。模板清单来自仓库 templates/rules/TemplatePurposecoding-style.mdCode style, immutability, file organizationtesting.mdTDD workflow, 80% coverage targetsecurity.mdSecret management, input validationperformance.mdModel selection, context managementgit-workflow.mdCommit conventions, PR workflowkarpathy-guidelines.mdCoding discipline -- think before coding, simplicity, surgical changes启用方式一次性全量复制或按需挑选mkdir -p .claude/rules cp ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/templates/rules/*.md .claude/rules/详细说明见 templates/rules/README.md该 README 补充了两个关键细节——模板内带有[CUSTOMIZE]标记指示用户按项目补充专属准则.claude/rules/*.md会被 oh-my-claudecode 自动发现并注入到项目中所有 agent 的上下文因此先复制、再按项目定制是推荐流程。询问是否收藏仓库Ask About Starring收尾前会礼貌地征询一次是否给项目加星且严格“静默、非阻塞”gh auth status /dev/nullgh 可用且已认证先探测仓库是否已被加星gh api user/starred/Yeachan-Heo/oh-my-claudecode /dev/null已加星exit code 0→ 跳过询问直接进入完成阶段未加星 → 通过 AskUserQuestion 询问选项为Yes, star it! / No thanks / Maybe later选择加星时执行gh api -X PUT /user/starred/Yeachan-Heo/oh-my-claudecode 2/dev/null echo Thanks for starring! || true该 API 调用即使失败也静默吞掉|| true绝不阻塞安装完成的流程gh 不可用或未认证仅打印一行文字提示不调用 API。标记完成版本采集与 setup 状态持久化Phase 4 最后一步是获取当前 OMC 版本并把完成状态写入持久化配置。版本采集有三级回退OMC_VERSION CONFIG_DIR${CLAUDE_CONFIG_DIR:-$HOME/.claude} case $CONFIG_DIR in ~) CONFIG_DIR$HOME ;; ~/*) CONFIG_DIR$HOME/${CONFIG_DIR#\~/} ;; ~\\*) CONFIG_DIR$HOME/${CONFIG_DIR#\~\\} ;; esac if [ -f .claude/CLAUDE.md ]; then OMC_VERSION$(grep -m1 OMC:VERSION: .claude/CLAUDE.md 2/dev/null | sed -E s/.*OMC:VERSION:([^ ]).*/\1/ || true) elif [ -f $CONFIG_DIR/CLAUDE.md ]; then OMC_VERSION$(grep -m1 OMC:VERSION: $CONFIG_DIR/CLAUDE.md 2/dev/null | sed -E s/.*OMC:VERSION:([^ ]).*/\1/ || true) fi if [ -z $OMC_VERSION ]; then OMC_VERSION$(omc --version 2/dev/null | head -1 || true) fi if [ -z $OMC_VERSION ]; then OMC_VERSIONunknown fi bash ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh complete $OMC_VERSION版本号的最终事实来源是CLAUDE.md顶部的!-- OMC:VERSION:5.0.2 --注释标记当前仓库根目录 CLAUDE.md 与 docs/CLAUDE.md 均为该格式它同时被scripts/generate-prompt-projections.mjs用于产物版本注入从而保证 CLAUDE.md、生成的 prompt 投影与omc --version之间版本一致。setup-progress.sh complete的实现见 scripts/setup-progress.sh值得注意它比“写个标记”复杂得多清理临时状态删除.omc/state/setup-state.json并按CLAUDE_SESSION_ID或CLAUDECODE_SESSION_ID清理嵌套 skill 遗留的skill-active-state.json否则 stop hook 会以 “skill still executing” 拦截收尾无会话 ID 时仅清理超过 30 分钟的老文件幂等合并写入读取${CLAUDE_CONFIG_DIR:-$HOME/.claude}/.omc-config.json存在与否均可用jq原子合并setupCompleted: ISO时间与setupVersion: 版本两个字段通过mktempmv保证写入安全版本号落库的意义Pre-Setup 检查见 skills/omc-setup/SKILL.md正是读取同一文件的setupCompleted/setupVersion字段来判断“已配置”。因此之后每次更新只需运行/oh-my-claudecode:omc-setup就会被识别为已配置并提供“只刷新 CLAUDE.md 清理退役配置值、跳过完整向导”的快捷更新路径而无需重走全部四阶段。小结与更新后的维护路径Phase 4 是安装向导的“验收与交接”环节它通过ralph-loop.md识别 2.x 升级者按身份输出不同的能力地图魔法关键词、Tier-0 工作流、Teams、MCP、HUD、CLI 助手提示 5.0.0 退役命令并指向 docs/MIGRATION.md顺带把可选规则模板从 templates/rules/ 复制进项目最后把带版本号的完成标记原子写入.omc-config.json。后续维护只需要记住一点更新 OMC 后直接重跑/oh-my-claudecode:omc-setup无需加任何 flag在“Update CLAUDE.md and clear retired setup values”选项上确认即可无需为小版本更新付出完整向导的 token 成本。【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考