oh-my-agent

oh-my-agent 是一个基于 .agents/ 标准目录的便携式多智能体编排框架，核心设计理念是将 .agents/ 目录作为唯一真相源（SSOT），随项目代码一起版本控制。框架内置 21 个专业化 Agent，分别对应真实工程团队角色（前端、后端、架构、QA、PM、DB、移动端、DevOps、调试、设计等），每个 Agent 拥有独立的工具链、检查清单和领域知识。

多智能体编排#

• 21 个角色化 Agent，各自拥有独立工具与检查清单
• 并行执行：oma agent:parallel 并行生成多个子代理，通过 MCP memory 协调
• 每 Agent 独立模型配置：可在 oma-config.yaml 中为每个角色指定不同模型和 effort 等级

跨 IDE/CLI 便携性#

• 原生子代理生成：自动从 .agents/agents/ 生成 .claude/agents/*.md、.codex/agents/*.toml、.gemini/agents/*.md
• 同厂商优先使用原生子代理路径，跨厂商通过 oma agent:spawn 回退
• 支持运行时：Claude Code、Gemini CLI、Codex CLI、Antigravity IDE、Cursor、OpenCode
• 运行时 Profile：claude-only、codex-only、gemini-only、antigravity、qwen-only

技能管理#

• 两层渐进式加载：Layer 1 SKILL.md（~800 bytes，始终加载）；Layer 2 resources/（按需加载），据称节省约 75% token
• Agent Package Manager (APM) 集成：一键部署 22 个技能到所有检测到的运行时
• 22 个技能目录（21 agents + _shared）

工作流自动化#

• 自动工作流检测：UserPromptSubmit Hook 扫描自然语言关键词（支持 11 种语言），自动激活对应工作流
• 16 个预定义工作流：brainstorm、architecture、design、plan、work、orchestrate、ultrawork、review、debug、scm 等
• 质量门控：Charter 预检、多阶段质量门、OWASP 安全审计、WCAG 无障碍审查

开发者体验#

• HUD 状态栏：Claude Code 中显示 [OMA] 状态指示（模型名、上下文使用率、工作流状态）
• 自然语言交互：直接描述需求，自动路由到对应 Agent
• i18n 支持：文档和关键词检测支持韩语、中文、日语、法语、西班牙语、德语、葡萄牙语、俄语、荷兰语、波兰语
• 安装后预设选择：All / Fullstack / Frontend / Backend / Mobile / DevOps

架构与实现#

• Monorepo 结构：使用 Bun workspaces，分为 cli/（CLI 工具）和 web/（文档站点，Docusaurus）
• SSOT 设计：.agents/ 为唯一真相源，.claude/、.codex/、.gemini/ 等仅为 IDE 集成层
• Hook 系统：UserPromptSubmit（关键词检测）、PreToolUse（工具调用拦截）、Stop（持久模式）
• MCP 协议用于 Agent 间内存共享与 Serena 符号追踪
• 构建工具链：Biome、Husky、commitlint、mise、TypeScript、release-please
• 主要语言：TypeScript（90.9%）、Shell（5.5%）、Rust（1.3%）等

安装方式#

# 一键安装（macOS/Linux）
curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash

# 手动安装
bunx oh-my-agent@latest

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

# 通过 APM 安装
apm install first-fluke/oh-my-agent

CLI 核心命令#

oma doctor                    # 健康检查
oma dashboard                 # 实时 Agent 监控
oma link                      # 从 .agents/ 重新生成各 IDE 配置
oma agent:spawn backend "Build auth API" session-01
oma agent:parallel -i backend:"Auth API" frontend:"Login form"

典型应用场景#

• 全栈应用开发的多角色协同（PM → 架构 → 前后端 → DB → QA）
• 架构决策分析（ADR/ATAM/CBAM 风格权衡）
• 代码质量与安全审计（OWASP Top 10、WCAG 2.1 AA）
• 基础设施即代码（多云 Terraform、OPA/Sentinel 策略）
• 调试与根因分析、文档转换、多语言翻译

当前版本：v5.18.2（CLI）/ web v1.1.3 | 仓库活动：1,377+ commits，229+ releases | 适用平台：macOS、Linux（官方支持）；Windows（需手动安装 bun 和 uv，兼容性待确认）