omni-agents-cli Skill 技能

omni-agents-cli 是一款工具无关的统一中枢，用于在多个 AI 编程助手（Claude Code、Cursor、Antigravity、GitHub Copilot、Kiro、OpenCode、Codex、Universal AGENTS.md）之间版本化管理、分发和同步子代理（subagent）、开发规则（rules）与模块化技能库（skills）。一份原始资源库即可编译输出到 8 种目标格式，告别每换 IDE 就重写一遍配置文件的痛苦。

核心能力

• 8 种目标适配器：Claude Code（CLAUDE.md + .claude/skills/）、Cursor（.cursor/rules/*.mdc，支持 globs/alwaysApply 元数据）、Antigravity（.agents/）、Copilot（.github/copilot-instructions.md）、Kiro / OpenCode / Codex / Universal（各自专属 AGENTS.md），一份源码多端编译。
• 3 类专业 Subagent：内置 accessibility-reviewer（WCAG 2.1/2.2 + WAI-ARIA 专家）、code-reviewer（Clean Code / SOLID 静态审查）、security-auditor（OWASP Top 10 安全审计），开箱即用。
• 模块化技能库分层加载：Global Core（coding-standards、comunicacao-clara、grug-brained-dev、reducing-entropy、researching-codebases，约 800 tokens 总量）+ 按需启用 Library（planning、docs、frontend、meta、stacks），按项目类型精准挂载，避免上下文浪费。
• 规则档案（Rule Profiles）：按文件夹组织，每个 profile 自带独立 AGENTS.md 契约；内置 general/（国际项目通用）和 pt-br-dev/（葡语项目带重音规范、禁用 emoji、Tailwind CSS 约定）。
• 多语言国际化：内置英 / 葡 / 西三种语言目录，界面与文档可一键切换，所有 rule / skill 文本随之本地化。
• 交互式 TUI + 无头 CLI：既能终端菜单（带 Recent Projects 切换），也可在 CI 中用 omni-agents --list-tools / --list-workspaces / 批量同步命令做自动化。
• 增量同步 / 卸载 / 远程扩展：支持 Synchronize All 批量同步、Clean / Uninstall by Tool 选择性卸载、Remote Extensions (Catalog & Community Packages) 加载社区贡献的 skill 子集。

安装配置

• 官方 uv 安装（推荐）：curl -LsSf https://astral.sh/uv/install.sh | sh → uv tool install omni-agents-cli，隔离环境、即时启动、不污染系统 Python。
• pip 安装：pip install omni-agents-cli，支持 pip install --upgrade omni-agents-cli 平滑升级。
• pipx 安装：pipx install omni-agents-cli，同样的隔离语义；可通过 pipx upgrade omni-agents-cli 升级。
• 一键脚本：Linux / macOS 用 curl -fsSL https://raw.githubusercontent.com/TheCheepeer/omni-agents/main/install.sh | bash，Windows 用 irm .../install.ps1 | iex。
• 工作区设置：通过 omni-agents 或 omni 启动 TUI → [w] Set / Change Target Workspace 选择工程根目录 → [s] Synchronize All 批量同步到已激活的工具。

使用步骤

1. 选择目标 IDE：在 TUI 中 [t] Select Target Tools，勾选 Claude Code、Cursor、Antigravity 等要启用的目标；也可在 CI 中用 omni-agents --list-tools 列出可选目标。
2. 挂载 Subagents：[1] Subagents for Workspace 启用 accessibility-reviewer / code-reviewer / security-auditor 等专家子代理。
3. 应用 Rule Profiles：[2] Rules for Workspace 选择 general/ 或 pt-br-dev/ 等规则档案，编译为对应目标格式。
4. 加载 Modular Skills：[3] Modular Skills for Workspace 按工程类型（前端 / 后端 / 文档 / 元 prompt）挂载按需库；Global Core 会自动随所有项目加载。
5. 同步到 IDE：[s] Synchronize All 把配置批量写入 .claude/、.cursor/、.agents/、.kiro/、.opencode/ 等目标目录，立即生效。
6. 日常维护：用 [c] Clean / Uninstall by Tool 选择性卸载、[l] Language 切换 i18n、[e] Remote Extensions 加载社区 skill 包。

适用场景

• 多 IDE 团队协作：团队成员分散在 Claude Code / Cursor / Antigravity / Copilot 上，需要同一份规则与子代理约定。
• 多项目标准化：维护 5+ 个代码仓库，希望共享一份 a11y / code-review / security 子代理与基础规则。
• Skill 创作者分发：把自研 Skill / Subagent 同步分发到不同 IDE 的对应目录（.claude/skills/、.cursor/rules/*.mdc 等）。
• CI/CD 自动化：在流水线里用无头命令 omni-agents 批量同步配置，避免手动维护每个仓库。
• 多语言项目：同一仓库并行维护英语 / 葡语 / 西语版本的需求。
• Token 优化敏感：模块化分层加载 Global Core 与按需 Library，避免每次调用都把所有 skill 全塞进上下文。

适用人群

• 同时使用多个 AI 编程助手的资深开发者
• 需要为团队制定统一 AI 编码规范的技术负责人 / 架构师
• AI 编程助手 Skill / Subagent 的作者与分发者
• 多语言 / 多区域团队的技术 Lead
• 注重代码质量（a11y / 安全 / Clean Code）的工程团队

工作原理

omni-agents-cli 采用 源 → 适配器 → 目标 的编译架构。在仓库源端维护一次 agents/、rules/、skills/ 三大目录，运行 omni-agents 时由 targets/ 下的各适配器（claude.py、cursor.py、antigravity.py 等）扫描源文件并编译为对应 IDE 的原生配置：写 CLAUDE.md、追加 .claude/skills/ 内容、生成带 globs + alwaysApply 元数据的 .cursor/rules/*.mdc，或合并为单一 .github/copilot-instructions.md。原子写入 + schema 校验保证目标目录一致性，TUI 端到端暴露工作区切换、批量同步、远程扩展加载、卸载等操作；CLI 端则提供给 CI 调用。

官方链接

• PyPI 包：https://pypi.org/project/omni-agents-cli/
• 源码仓库：https://github.com/TheCheepeer/omni-agents
• README（含 8 种目标格式表 + TUI 菜单示意）：https://github.com/TheCheepeer/omni-agents#readme