ohmg

ohmg — 跨厂商便携式多 Agent 框架（oh-my-agent v10.4.1）

何时使用此技能

• 你想在任意 AI IDE 中采用 oh-my-agent 作为便携式多 Agent 框架
• 你想以单一 .agents/ 作为事实来源，并将其投射到 Claude Code、Codex、Gemini、Antigravity、Cursor、Grok Build、Kimi Code、OpenCode、Pi、Qwen Code、Reasonix、Amp、GitHub Copilot 或 Kiro CLI
• 你需要在任何运行时中使用 OMA 对应的 Claude /team、/autopilot、/ultrawork 或 /ultraqa
• 你需要专用领域 Agent（前端、后端、架构、QA、PM、DB、移动端、基础设施、调试、设计等），并让它们在不同运行时中保持一致
• 你需要说明何时使用原生生成的 Agent 文件，以及何时需要回退到 oma agent:spawn
• 你想采用与厂商无关的框架路径，而不受完整的 Claude 优先（omc）或 Codex 优先（omx）运行时栈限制

说明

第 1 步：确定运行时和所需的所有权模式

确定用户实际需要以下哪种模式：

1. 便携式框架优先 — 用户希望以一个 .agents/ 作为事实来源，并将其投射到任何受支持的运行时
2. 特定运行时优先 — 用户有主要使用的 IDE，但希望通过 OMA 获得多 Agent 支持
3. 改用 Claude Code 原生方案 — 转到 omc
4. 改用 Codex CLI 原生方案 — 转到 omx

如果请求实际涉及 Claude Code 原生编排，请转到 omc。 如果请求实际涉及 Codex CLI 原生编排，请转到 omx。 当用户需要跨厂商便携式框架，或其运行时不是 Claude Code 或 Codex 时，请使用 ohmg。

第 2 步：介绍当前上游的思路

围绕现代上游形态介绍 ohmg：

• 产品／运行时名称：oh-my-agent
• 常用 CLI：oma / oh-my-agent
• 事实来源：项目中的 .agents/
• 原生生成的厂商视图：
  • .gemini/agents/*.md
  • .claude/agents/*.md
  • .codex/agents/*.toml
• 分派规则：
  • 同厂商运行时 → 优先使用原生生成的厂商 Agent 文件
  • 跨厂商任务 → 回退到 oma agent:spawn / oma agent:parallel

不要以旧的 oh-my-ag 命名、/coordinate 或 .agent/skills/ 路径作为介绍重点。

第 3 步：提供合适的安装／引导路径

Gemini CLI／通用便携式设置

# one-liner installer (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash

# or launch directly
bunx oh-my-agent@latest

# or install globally
bun install --global oh-my-agent

安装后，使用交互式 oma 流程选择预设，并生成项目本地框架。

实用的操作员命令：

oma doctor
oma link
oma dashboard
oma dashboard:web

存在安装限制时

如果不适合使用交互式设置，请说明手动操作方式：

1. 将 .agents/ 放入项目
2. 运行 oma link，重新生成特定运行时的视图
3. 验证生成的 Gemini／Claude／Codex 文件是否位于预期位置

第 4 步：正确说明 Gemini 原生与 Antigravity 的行为差异

Gemini CLI 路径

当运行时厂商与目标厂商一致时，Gemini 可以使用 .gemini/agents/*.md 中的生成原生 Agent 文件。

说明时应强调：

• 保持 .agents/ 为规范来源
• 生成／更新 .gemini/agents/*.md
• 尽可能让 Gemini 使用原生生成的 Agent 定义

Antigravity 路径

Antigravity 可以直接使用 .agents/agents/，但不支持自定义子 Agent 派生，其方式不同于 Gemini／Claude／Codex 运行时。

说明时应强调：

• Antigravity 是该框架的便携式使用界面
• 不要夸大其能力，声称它与 Gemini 原生多 Agent 派生完全相同
• 当任务需要明确的跨厂商或自定义派生行为时，应说明回退到 CLI／运行时的路径，而不要假装 Antigravity 原生支持这些功能

第 5 步：展示实际的工作流场景

使用与当前 oh-my-agent 文档一致的上游工作流术语：

• /plan — PM 任务拆解和面向 API 契约的规划
• /work — 分步、有门控的多 Agent 执行
• /orchestrate — 基于 CLI 的并行 Agent 执行
• /ultrawork — 强度更高的质量工作流
• /review — 安全性 / 性能 / 无障碍性审查
• /debug — 结构化调试
• /scm — SCM 和 Git 工作流支持

实用的 CLI 示例：

oma agent:spawn backend "Build auth API" session-01
oma agent:parallel -i backend:"Auth API" frontend:"Login form"
oma dashboard
oma dashboard:web

请将这些作为便携式框架的示例，而不是承诺每种运行时都提供相同的原生 UI。

第 5.5 步：将 Claude team / autopilot / ultrawork / ultraqa 映射到 OMA

用户询问如何将 Claude OMC 工作流迁移到 Gemini 或 Antigravity 时，请阅读 references/parallel-quality-workflows.md。

Claude / OMC 意图	OMA / Gemini 形式	Antigravity 边界
/team N:role "task"	/orchestrate "task" 或 oma agent:parallel -i role:"task"	Antigravity 可以使用 .agents/agents/，但显式启动可能需要回退到 OMA CLI
/autopilot "task" 或 autopilot: task	/plan "task"，随后执行 /work；只有在工作必须拆分为明确的执行路径时才使用 /orchestrate	Antigravity 可以遵循生成的框架，但除非本地投影中提供原生命令，否则不要承诺存在 Claude 风格的原生 /autopilot 命令
/ultrawork "task"	/ultrawork "task" 或使用 oma agent:parallel 执行相互独立的路径	保持 .agents/ 为规范来源，并使用 oma link 重新生成视图
/ultraqa "target"	/review "target" 或使用 /ultrawork "QA target" 并行开展 QA / 安全性 / 性能工作	除非本地投影中提供原生命令，否则不要承诺存在原生 /ultraqa 命令

第 6 步：明确界限，处理跨厂商问题

按以下逻辑路由：

• 请求涉及以下内容时，使用 ohmg：

  • oh-my-agent 的 Gemini CLI 设置
  • Antigravity 兼容性
  • .agents/ 源事实结构
  • Gemini 原生生成的 Agent
  • 选择各厂商运行时层之前采用便携式框架

• 请求涉及以下内容时，使用 omc：

  • Claude Code 插件 / 会话内编排
  • /team、/autopilot、/ralph、/ccg 或以 Claude 为先的运行时操作

• 请求涉及以下内容时，使用 omx：

  • Codex CLI 工作流技能，例如 $deep-interview、$autopilot、$ralplan、$team、$ralph
  • .omx/ 运行时状态和以 Codex 为先的编排行为

如果用户希望使用一个便携式框架，之后可供 Gemini + Claude + Codex 使用，请以 ohmg 为核心，并将 omc / omx 作为下游的厂商优先层介绍，而非 .agents/ 源事实的替代品。

第 7 步：排查最常见的偏差点

优先检查以下内容：

1. 产品名称错误 — 使用 oh-my-agent / oma，不要使用旧名称 oh-my-ag
2. 源事实路径错误 — 优先使用 .agents/，不要使用旧版 .agent/
3. 生成的文件过期或缺失 — 重新运行 oma link
4. 环境不匹配 — Gemini 原生行为与 Antigravity 的能力不同
5. 对监控的误解 — 仪表板用于观察 Agent / 记忆活动，并不代表完整的编排模型
6. 对混合厂商的预期有误 — 如果原生分派无法接管任务，请说明 oma agent:spawn / oma agent:parallel
7. 对 Claude 工作流对等性的误解 — 应将 team、autopilot、ultrawork 和 ultraqa 映射为工作流意图，而非视为实现相同的命令

示例

示例 1：采用 Gemini CLI

用户：“为 Gemini CLI 配置 oh-my-agent。”

**回复：**使用 ohmg。安装 oh-my-agent，将 .agents/ 保留为唯一事实来源，然后重新生成 Gemini 原生 Agent 文件，以便在运行时供应商匹配时，Gemini 可以使用 .gemini/agents/*.md。一个不错的起步方式是运行 curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash 或 bunx oh-my-agent@latest，然后运行 oma doctor 和 oma link。

示例 2：兼容 Antigravity

用户：“我想让 Antigravity 使用与 Gemini 相同的多 Agent 配置。”

**回复：**使用 ohmg，但要清楚说明能力边界：Antigravity 可以从同一个可移植框架中使用 .agents/agents/，但它不支持与 Gemini 原生方式或 CLI 回退路径相同的自定义子 Agent 调用方式。将 .agents/ 保持为规范来源，并将 Antigravity 用作兼容的使用端。

示例 3：可移植框架，之后再路由到 Claude/Codex

用户：“我现在需要 Gemini 原生 Agent，但之后可能会把工作路由到 Claude 或 Codex。”

回复：ohmg 是合适的基础。先使用 oh-my-agent，并将 .agents/ 作为项目本地的唯一事实来源。现在让 Gemini 使用生成的原生 Agent 文件，之后再将同一框架映射到 .claude/agents/ 或 .codex/agents/。如果用户之后希望优先使用 Claude 进行运行时编排，请将运行时细节引导至 omc；如果他们希望优先使用 Codex 工作流技能，请引导至 omx。

示例 4：在 ohmg、omc 和 omx 之间选择

用户：“我应该使用 ohmg、omc 还是 omx？”

**回复：**如果你的主要目标是以 .agents/ 为中心、适用于 Gemini / Antigravity 的可移植框架，请使用 ohmg。Claude 优先的编排使用 omc，Codex 优先的编排使用 omx。ohmg 是采用可移植框架的路径；omc 和 omx 则是优先面向特定供应商的运行时扩展层。

最佳实践

1. 使用当前上游命名 — oh-my-agent / oma，而非 oh-my-ag
2. 将 .agents/ 作为规范来源 — 生成的 Gemini/Claude/Codex 文件应从中派生
3. 优先使用同一供应商的原生调度方式 — 只有在供应商/运行时不匹配时，才改用 CLI 启动
4. 明确说明 Antigravity 的限制 — 它具备兼容性，但与 Gemini 原生的自定义子 Agent 行为并不完全相同
5. 妥善引导供应商优先的运行时问题 — Claude 优先的运行时细节保留在 omc 中，Codex 优先的运行时细节保留在 omx 中
6. 结构发生变化后运行 oma link — 生成文件过期是常见的困惑来源
7. 将仪表板视为可观测性辅助工具 — 它们为工作流提供支持，但本身不是工作流
8. 谨慎映射 QA — OMA /review 或 /ultrawork 可以满足 ultraqa 意图，但只有在本地存在该工作流时，才称其为 /ultraqa

参考资料

• 安装、布局和生成文件
• 运行时边界：Gemini 与 Antigravity 及 OMC/OMX
• 工作流和命令包
• 并行与质量工作流
• 上游 README
• 支持的 Agent 矩阵