Skip to content

README.zh.md

Latest commit

 

History

History
338 lines (271 loc) · 15.2 KB

README.zh.md

File metadata and controls

338 lines (271 loc) · 15.2 KB

oh-my-agent: Portable Multi-Agent Harness

npm version npm downloads GitHub stars License Last Updated

English | 한국어 | Português | 日本語 | Français | Español | Nederlands | Polski | Русский | Deutsch | Tiếng Việt | ภาษาไทย

有没有想过，要是你的 AI 助手有同事就好了？oh-my-agent 就是干这个的。

与其让一个 AI 包揽一切（然后做到一半就迷路），oh-my-agent 把工作分配给专业 agent：frontend、backend、architecture、QA、PM、DB、mobile、infra、debug、design 等等。每个 agent 深耕自己的领域，拥有专属工具和检查清单，各司其职。

支持所有主流 AI IDE：Antigravity、Claude Code、Cursor、Gemini CLI、Codex CLI、OpenCode 等。

快速开始

# macOS / Linux — 自动安装 bun、uv & serena
curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash
# Windows (PowerShell) — 自动安装 bun、uv & serena
irm https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.ps1 | iex
# 或者手动运行（任意系统，需要 bun + uv + serena）
bunx oh-my-agent@latest

通过 Agent Package Manager 安装

Microsoft 的 Agent Package Manager（APM）：只分发 skill。点击展开。

别和 oma-observability 的 APM（Application Performance Monitoring）搞混。

# 所有 skill，部署到检测到的每个 runtime
# (.claude, .cursor, .codex, .opencode, .github, .agents)
apm install first-fluke/oh-my-agent

# 单个 skill
apm install first-fluke/oh-my-agent/.agents/skills/oma-frontend

APM 只分发 skill。workflow、规则、oma-config.yaml、关键词检测 hook 和 oma agent:spawn CLI 还是用 bunx oh-my-agent@latest。一个项目挑一种分发方式就好，免得跑偏。

选个预设就能开始：

预设 包含内容
✨ All 所有 agent 和 skill
🌐 Fullstack architecture + frontend + backend + db + pm + qa + debug + brainstorm + scm
🎨 Frontend architecture + frontend + pm + qa + debug + brainstorm + scm
⚙️ Backend architecture + backend + db + pm + qa + debug + brainstorm + scm
📱 Mobile architecture + mobile + pm + qa + debug + brainstorm + scm
🚀 DevOps architecture + tf-infra + dev-workflow + pm + qa + debug + brainstorm + scm

适配所有 Agent

oh-my-agent 始终把 .agents/ 作为唯一信源（SSOT），并按每个运行时的原生布局生成对应文件，所有受支持的工具因此共享同一套技能、工作流和规则。

Claude Code
Claude Code
原生 + 适配器 		Codex CLI
Codex CLI
原生 + 适配器 		Gemini CLI
Gemini CLI
原生 + 适配器 		Cursor
Cursor
原生 + 适配器 		Qwen Code
Qwen Code
原生派发 		Grok
Grok
native hooks + agents
Antigravity
Antigravity
原生 SSOT 		OpenCode
OpenCode
原生兼容 		Amp
Amp
原生兼容 		GitHub Copilot
GitHub Copilot
符号链接技能 		More
& 更多
兼容矩阵 →

Agent 团队

Agent 职责
oma-academic-writer 将学术文章写到发表级别，涵盖起草、修订与审稿
oma-architecture 权衡架构方案、划定模块边界，提供 ADR/ATAM/CBAM 分析
oma-backend 用 Python、Node.js 或 Rust 构建并加固你的 API
oma-brainstorm 在动手之前，先和你一起把想法探索清楚
oma-db 设计 schema、迁移、索引与 vector store
oma-debug 找到根因、修复 bug，并补上回归测试
oma-deepsec 扫描代码中的安全漏洞，拦截高风险 pull request
oma-design 构建含 token、无障碍支持与响应式布局的设计系统
oma-dev-workflow 自动化 CI/CD、发布流程与 monorepo 任务
oma-docs 检查文档中的失效引用，并标出被代码变更波及的内容
oma-frontend 用 React/Next.js、TypeScript、Tailwind CSS v4 与 shadcn/ui 构建 UI
oma-hwp 将 HWP、HWPX 和 HWPML 文件转换为 Markdown
oma-image 同时调用多家 AI 供应商生成图像
oma-market 从社区信号中挖掘市场洞察，并套用 SWOT、Porter's 5F 和 PESTEL 框架呈现结论
oma-mobile 用 Flutter 构建跨平台移动应用
oma-observability 统一路由可观测性工作，覆盖指标、日志、追踪、SLO 与事故取证
oma-orchestrator 通过 CLI 并行调度多个 agent
oma-pdf 将 PDF 文件转换为 Markdown
oma-pm 规划任务、拆解需求、定义 API 契约
oma-qa 审查代码的 OWASP 安全性、性能与无障碍合规
oma-recap 将会话历史整理成有主题分类的工作摘要
oma-scholar 检索学术文献，协助开展同行评审
oma-scm 管理分支、合并、worktree 与 Conventional Commits
oma-search 将每条查询路由至最优来源，并标注结果的可信度评分
oma-skill-creator 以 SSL-lite 格式编写和审计 OMA skill
oma-slide 生成特色鲜明、动画丰富的 HTML 演示文稿卡片，并导出至 PDF/PNG/PPTX
oma-tf-infra 使用 Terraform 完成多云基础设施的自动化编排
oma-translator 将内容翻译成目标语言，读来如同母语写就
oma-voice 在本地完成语音合成与转写，无需任何云服务

工作原理

直接聊就行。描述你想要什么，oh-my-agent 会自动选择合适的 agent。

You: "做一个带用户认证的 TODO 应用"
→ PM 规划任务
→ Backend 构建认证 API
→ Frontend 构建 React UI
→ DB 设计 schema
→ QA 审查全部代码
→ 完成：协调一致、经过审查的代码

也可以用斜杠命令执行结构化工作流：

步骤 命令 说明
1 /brainstorm 自由发散想法
2 /architecture 软件架构评审、权衡、ADR/ATAM/CBAM 式分析
2 /design 7 阶段设计系统工作流
2 /plan PM 把功能拆解成任务
3 /work 逐步执行多 agent 协作
3 /orchestrate 自动并行 agent 调度
3 /ultrawork 含 11 个审查门禁的 5 阶段质量工作流
4 /review 安全 + 性能 + 无障碍审计
4 /deepsec 智能体驱动的深度安全扫描
5 /debug 结构化根因调试
5 /docs 基于 oma-docs 的文档漂移校验与同步
6 /scm SCM 与 Git 工作流，Conventional Commits 支持

自动检测：不用斜杠命令也行，消息里出现“架构”“计划”“审查”“调试”等关键词（支持 11 种语言！）就会自动激活对应工作流。

CLI

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

# 随处使用
oma agent:parallel -i backend:"Auth API" frontend:"Login form"
oma agent:spawn backend "Build auth API" session-01
oma dashboard               # 实时 agent 监控
oma doctor                  # 健康检查
oma image generate "cat"    # 多供应商 AI 图像生成
oma link                    # 从 .agents/ 重新生成 .claude/.codex/.gemini 等
oma model:check             # 检测已注册模型与实时供应商列表的漂移
oma recap --window 1d       # 跨工具对话历史回顾
oma retro 7d --compare      # 含指标与趋势的工程复盘
oma search fetch <url>      # 自动升级策略的机械搜索

模型选择分两层：

  • 同厂商原生调度使用生成在 .claude/agents/、.codex/agents/、.gemini/agents/ 里的厂商 agent 定义。
  • 跨厂商或 CLI 回退调度使用 .agents/skills/oma-orchestrator/config/cli-config.yaml 里的厂商默认值。

按 agent 配置模型：可在 .agents/oma-config.yaml 里为每个 agent 单独指定模型和 effort。内置 runtime profiles：antigravity、claude、codex、cursor、grok、mixed、qwen。用 oma doctor --profile 查看解析后的 auth 矩阵。完整指南：web/docs/guide/per-agent-models.md。

为什么选 oh-my-agent？

深入了解 →

  • 可移植：.agents/ 跟着项目走，不被任何 IDE 绑定
  • 角色化：像真正的工程团队一样建模，而不是一堆 prompt 的堆砌
  • 省 token：双层 skill 设计节省约 75% 的 token
  • 质量优先：内置 Charter preflight、quality gate 和审查工作流：
    • oma verify <agent> — 按 agent 类型的 14 项确定性检查（TypeScript strict、tests、raw SQL、硬编码密钥、Flutter analyze、inline styles、scope 越界、charter 对齐 …）
    • session.quota_cap — 在 oma-config.yaml 中按会话设定 token / spawn / 单厂商预算上限；orchestrate Step 5 在超限时阻断下一次 spawn
    • ralph 工作流 — 独立的 JUDGE 每次迭代都重新校验所有 criterion，捕获静默回归；>30s 的重测有缓存
    • Exploration Loop — 重试 2 次后，orchestrate 并行 spawn 多个 hypothesis 变体并保留得分最高的
    • 单仓自动路由 — detectWorkspace 读取 pnpm / nx / turbo / lerna 并把每个 agent 路由到自己的 workspace
  • 多厂商：按 agent 类型混用 Claude、Codex、Cursor、Qwen
  • 可观测：终端和 Web 仪表盘实时监控

架构

flowchart TD
    subgraph Workflows["Workflows"]
        direction TB
        W0["/brainstorm"]
        W1["/work"]
        W1b["/ultrawork"]
        W2["/orchestrate"]
        W3["/architecture"]
        W4["/plan"]
        W5["/review"]
        W6["/debug"]
        W7["/deepinit"]
        W8["/design"]
    end

    subgraph Orchestration["Orchestration"]
        direction TB
        PM[oma-pm]
        ORC[oma-orchestrator]
    end

    subgraph Domain["Domain Agents"]
        direction TB
        ARC[oma-architecture]
        FE[oma-frontend]
        BE[oma-backend]
        DB[oma-db]
        MB[oma-mobile]
        DES[oma-design]
        TF[oma-tf-infra]
    end

    subgraph Quality["Quality"]
        direction TB
        QA[oma-qa]
        DBG[oma-debug]
    end

    Workflows --> Orchestration
    Orchestration --> Domain
    Domain --> Quality
    Quality --> SCM([oma-scm])
Loading

了解更多

赞助

本项目由慷慨的赞助者们支持维护。

喜欢这个项目？ 给个 star 吧！

gh api --method PUT /user/starred/first-fluke/oh-my-agent

试试我们优化过的入门模板：fullstack-starter

Sponsor Buy Me a Coffee

🚀 Champion

🛸 Booster

☕ Contributor

成为赞助者 →

完整赞助者列表请查看 SPONSORS.md。

Star History

Star History Chart

参考文献

  • Liang, Q., Wang, H., Liang, Z., & Liu, Y. (2026). From skill text to skill structure: The scheduling-structural-logical representation for agent skills (Version 2) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2604.24026
  • Chen, C., Yu, Q., Gu, Y., Huang, Z., Li, H., Liu, H., Liu, S., Liu, J., Peng, D., Wang, J., Yan, Z., Meng, F., Qin, E., Che, C., & Hu, M. (2026). The scaling laws of skills in LLM agent systems (Version 1) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.16508

许可证

MIT