oh-my-agent (OMA)

oh-my-agent (OMA) 是一个便携式、多智能体（Multi-Agent）编排框架。它的核心理念是：不要让一个全能型 AI 试图包揽所有工作，而是将任务拆解并分配给拥有专属工具、检查清单和领域知识的专业 Agent（如前端、后端、PM、QA、DBA 等）。

OMA 不绑定任何特定 IDE，完美支持 Antigravity, Claude Code, Cursor, Gemini CLI, Codex CLI, OpenCode 等主流 AI 编程环境。它通过标准化的 .agents/ 目录结构，让这支“虚拟团队”随项目移动，实现真正的可移植协作。

快速开始：一行命令组建团队

1. 一键安装

OMA 会自动检测并安装所需运行时（Bun & UV）：

curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash

或者手动运行： bunx oh-my-agent

2. 选择预设配置

根据项目类型选择预设，OMA 会自动加载对应的 Agent 组合：

核心角色：你的虚拟同事

OMA 预置了 13+ 个高度专业化的 Agent，每个都经过特定领域的强化：

工作流：从自然语言到高质量交付

1. 自然语言触发 (Auto-Detect)

无需记忆命令，只需在对话中包含关键词（支持 11 种语言），OMA 会自动激活对应工作流：

你: “我们需要计划一个新的用户认证功能，并在完成后进行安全审查。”
OMA: 自动调用 oma-pm 进行规划，并在代码完成后调用 oma-qa 进行审计。

2. 结构化斜杠命令

对于复杂任务，使用专用命令显式控制流程：

3. 实战示例

任务：“做一个带用户认证的 TODO 应用”

1. oma-pm: 拆解任务 -> [DB Schema, Auth API, Login UI, Todo CRUD]
2. oma-db: 设计 Users/Todos 表，生成迁移脚本。
3. oma-backend: 实现 JWT 认证与 CRUD 接口。
4. oma-frontend: 构建 React 登录页与 Todo 列表。
5. oma-qa: 扫描 SQL 注入风险，检查 A11y 标签。
6. oma-commit: 生成最终提交记录。
   结果：一套经过多轮审查、风格统一、可直接运行的代码。

CLI 工具箱

除了集成在 IDE 中，OMA 还提供强大的命令行工具：

# 全局安装
bun install --global oh-my-agent

# 健康检查
oma doctor

# 实时监控仪表盘 (Web/Terminal)
oma dashboard

# 手动 spawn 特定 Agent
oma agent:spawn backend "Build auth API" session-01

# 并行执行多个任务
oma agent:parallel -i backend:"Auth API" frontend:"Login form" db:"Schema"

为什么选择 oh-my-agent？

1. 真正的可移植性

所有配置存储在项目的 .agents/ 目录下。无论你把代码克隆到哪台机器、使用哪个 IDE（Cursor 还是 Claude Code），这支“团队”都能立刻上岗，零配置迁移。

2. 极致省 Token

采用 双层 Skill 设计：

• 全局层：通用知识。
• 角色层：仅在该 Agent 被激活时加载专属上下文。
  相比将所有上下文塞给一个大模型，OMA 可节省约 75% 的 Token 消耗。

3. 质量优先 (Quality First)

内置 Charter Preflight（任务宪章预检）和 Quality Gates（质量门禁）。代码若不通过 QA 的安全/性能检查，绝不允许进入下一阶段，从源头杜绝“能跑但充满隐患”的代码。

4. 多厂商混合编排

支持按 Agent 类型混用不同模型：

• 用 Gemini 处理长上下文的设计文档。
• 用 Claude 进行复杂的逻辑推理。
• 用 Codex/Qwen 快速生成样板代码。
  OMA 自动路由，发挥各模型长处。

5. 全链路可观测

通过 oma dashboard 实时查看每个 Agent 的状态、Token 消耗、执行日志和依赖关系，让黑盒协作变得透明可控。