内容
# ⚡ oh-my-orq
**多智能体协同框架，用于 AI 驱动的应用生成**
> 30 个专业 AI 智能体协同工作，从头开始构建任何应用程序 — 具备共享项目内存、持续代码库学习、14 项功能令牌优化、模型上下文协议（MCP）支持、Hermes 通知智能体、视觉主题和实时网页仪表盘。
---
## ✨ 功能特点
- 🧠 **30 个专业智能体** — Apex-1, Atlas, Forge, Nova, Aegis, Sync, Link, Hermes 等
- 🎭 **智能 AI 后端路由** — 自动选择最佳 AI 模型（GPT/Claude/Gemini）适用于每项任务和复杂度
- ⚡ **委托协议** — 结构化 `[DELEGATE TO: <agent>]` 智能体间通信语法
- 🧠 **共享内存（项目皮层）** — 持久的、项目范围的 SQLite/JSON 内存，在 IDE 重启时存活
- 🧠 **持续学习引擎** — 自动检测代码库约定（`ES6`/`CommonJS`, `camelCase`/`snake_case`, 异步和错误模式）
- ☤ **Hermes 自主消息** — 桌面通知、Slack/Discord webhook 和智能体间消息日志
- 🗜️ **14 项功能令牌优化**：
- **增量模式** — 重新读取统一的差异而不是完整的文件（节省 85-95%）
- **代码骨架** — 大型文件重新读取返回 AST 样式的签名和导入
- **输出压缩器** — 压缩 `pytest`、`npm test`、`git log`、`grep` 输出
- **渐进式披露（`expand`）** — 工具输出 > 4KB 存档到磁盘，并带有检索指针
- **压缩检查点和 Intel 摘要** — 在 IDE 上下文压缩后自动恢复状态
- **循环检测器** — 当智能体陷入失败的工具重试循环时发出警报
- **保持活跃缓存** — 保持 API 提示缓存活跃
- **质量评分和教练模式（`orq coach`）** — 实时 S-F 上下文健康评分和 30 天令牌浪费审计
- 🔌 **模型上下文协议（MCP）支持** — GitHub、PostgreSQL、文件系统和网络搜索的预配置 MCP 集成
- 🎨 **视觉主题引擎** — `default-dark`、`cyberpunk`、`dracula`、`nord` 的预设
- 📊 **令牌使用仪表盘** — 显示每个模型的用法，带有定价和预算监视器
- 🔧 **跨平台 CLI** — 适用于 Windows、macOS、Linux
- 📦 **一键安装** — `npx oh-my-orq`
---
## 🏗️ 架构和内部线路图
- **[内部线路图和交互地图](docs/internal-wireframe.md)** — 显示智能体、钩子、共享存储（皮层）、MCP 网关和 Hermes 如何交互的详细区块图。
- **[架构和 IDE 使用指南](docs/architecture.md)** — 执行顺序图、流程图和 Antigravity / VS Code 集成步骤。
---
## 🤖 完整的智能体目录（30 个专业智能体）
### 🏔️ 1. 协调和规划（3 个智能体）
| 智能体名称 | 角色 / 标题 | 分配模型 | 主要专业 |
| :--- | :--- | :--- | :--- |
| **Apex-1** | 主协调器 | `Claude Opus 4.8` | 项目分解、委托、集成和质量循环 |
| **Vector** | 策略规划师 | `Claude Sonnet 5` | 3-7 阶段任务分解、资源和令牌估计 |
| **Aura** | 计划顾问 | `Claude Sonnet 5` | 计划验证、风险检测和优化审查 |
### 🏛️ 2. 架构和技术策略（3 个智能体）
| 智能体名称 | 角色 / 标题 | 分配模型 | 主要专业 |
| :--- | :--- | :--- | :--- |
| **Atlas** | 系统枢纽 | `GPT-5.6 Sol` / `Opus` | 系统设计、技术栈选择、Mermaid 图表 |
| **Nexus** | 数据库和 API 设计师 | `Claude Sonnet 5` | SQL 模式、OpenAPI 规范、REST/GraphQL 设计 |
| **Lexicon** | 技术决策者 | `Claude Sonnet 5` | 构建 vs. 购买分析、权衡矩阵、ROI 评估 |
### ⚒️ 3. 软件开发和工程（4 个智能体）
| 智能体名称 | 角色 / 标题 | 分配模型 | 主要专业 |
| :--- | :--- | :--- | :--- |
| **Forge** | 后端实现专家 | `Claude Sonnet 5` | 生产后端代码、SOLID 原则、API 端点 |
| **Nova** | UI/UX 和前端专家 | `Gemini 2.5 Pro` | 现代响应式 UI、CSS 网格/玻璃态、Google 字体 |
| **Prism** | 代码质量改进者 | `Claude Sonnet 5` | 代码气味检测、DRY 执行、函数提取 |
| **Pulse** | 优化专家 | `Claude Opus 4.8` | 分析、数据库索引、缓存、核心网页生命指标 |
### 🧪 4. 测试、QA 和安全（3 个智能体）
| 智能体名称 | 角色 / 标题 | 分配模型 | 主要专业 |
| :--- | :--- | :--- | :--- |
| **Aegis** | 自动测试专家 | `GPT-5.6 Sol` | 单元和集成测试、Jest/pytest、80%+ 覆盖率目标 |
| **Echo** | 手动测试专家 | `Claude Haiku 4.5` | 测试用例创建、探索性测试计划、错误报告 |
| **Cyber** | 安全审计员 | `Claude Opus 4.8` | OWASP Top 10 审计、输入净化、秘密检测 |
### 📚 5. 研究和文档（4 个智能体）
| 智能体名称 | 角色 / 标题 | 分配模型 | 主要专业 |
| :--- | :--- | :--- | :--- |
| **Veritas** | 研究专家 | `Claude Haiku 4.5` | 文档查找、代码示例、库研究 |
| **Tracker** | 代码导航器 | `Claude Haiku 4.5` | 高速 ripgrep/grep 搜索、符号查找 |
| **Quill** | 技术作家 | `Claude Sonnet 5` | README 生成、JSDoc、API 文档、视觉指南 |
| **Intel** | 多仓库分析师 | `Claude Sonnet 5` | 跨仓库模式提取和行业基准 |
### 📊 6. 数据和分析（5 个智能体）
| 智能体名称 | 角色 / 标题 | 分配模型 | 主要专业 |
| :--- | :--- | :--- | :--- |
| **Sigma-Low** | 快速数据跟踪器 | `Claude Haiku 4.5` | 快速数据加载、描述性统计、基本清理 |
| **Sigma** | 标准统计分析师 | `Claude Sonnet 5` | 假设测试、回归分析、质量门控 |
| **Sigma-High** | 高级研究专家 | `Claude Opus 4.8` | 机器学习、因果推理、时间序列预测 |
| **Flow** | ETL 管道专家 | `Claude Sonnet 5` | 数据验证、转换管道、ETL 自动化 |
| **Query** | 数据库查询专家 | `Claude Sonnet 5` | 复杂 SQL、EXPLAIN ANALYZE、窗口函数 |
### 🛠️ 7. 工具、消息、MCP 和 DevOps（8 个智能体）
| 智能体名称 | 角色 / 标题 | 分配模型 | 主要专业 |
| :--- | :--- | :--- | :--- |
| **Viper** | 错误猎人 | `GPT-5.6 Sol` | 错误日志分析、堆栈跟踪读取、定向快速修复 |
| **Sync** | 版本控制和 GitHub 专家 | `Claude Haiku 4.5` | 原子提交、分支变基、`git pull/push`、PR 创建 |
| **Link** | 模型上下文协议专家 | `Claude Sonnet 5` | 与 GitHub、PostgreSQL、Web Search MCP 服务器接口 |
| **Hermes** | 自主消息者 | `Claude Haiku 4.5` | 系统通知、Slack/Discord webhook 和消息日志 |
| **Matrix** | 部署专家 | `Claude Opus 4.8` | Docker 容器化、CI/CD 管道、云部署 |
| **Automata** | 浏览器自动化专家 | `Claude Sonnet 5` | 端到端浏览器测试、页面对象模型、网页抓取 |
| **Vision** | 视觉分析专家 | `Claude Opus 4.8` | UI 截图审查、图表解析、OCR 文本提取 |
| **Orq-01** | 框架演示智能体 | `Claude Haiku 4.5` | 框架教程、安装验证和示例 |
## 🚀 快速开始和安装
```bash
# 全局安装（必需）
npm i -g oh-my-orq
# 通过 NPX 即时设置
npx oh-my-orq
```
## 💬 IDE 斜杠命令和多智能体协调
只需在 IDE 聊天中输入以下斜杠命令（Antigravity、Cursor、VS Code）：
| 斜杠命令 | 协调器智能体 | 操作 / 执行流程 |
| :--- | :--- | :--- |
| **`/orq <prompt>`** | **Apex-1** | 完整的自主执行管道（`/orq-plan` → `/orq-implement` → `/orq-review`） |
| **`/orq-plan <prompt>`** | **Apex-1** → Vector, Aura, Atlas, Nexus | 策略性 3-7 阶段规划、架构审查和 API 规范设计 |
| **`/orq-implement <prompt>`** | **Apex-1** → Forge, Nova, Link, Sync | 后端逻辑、前端 UI/UX、MCP 集成和 git 提交 |
| **`/orq-review <prompt>`** | **Apex-1** → Prism, Pulse, Aegis, Cyber | 代码质量重构、分析、自动测试和 OWASP 审计 |
---
## 📦 智能体安装命令
```bash
# 安装所有 30 个智能体（全局 / Antigravity IDE）
orq install all
# 将所有 30 个智能体安装到当前项目（.agents/skills）
orq install all --project
# 仅安装主协调器智能体（Apex-1 协调所有子智能体）
orq install apex-1
# 将主协调器安装到当前项目（.agents/skills）
orq install apex-1 --project
```
## 📋 CLI 命令
```bash
# 智能体目录
orq list # 列出所有 30 个智能体及其专业知识
# 智能体管理
orq install <agent|all|apex-1> [--project] # 安装所有、apex-1 或特定智能体
orq remove <agent> # 删除智能体
# 消息和通知（Hermes）
orq notify "<message>" # 通过 Hermes 发送桌面/系统通知
# 学习和优化
orq learn # 扫描代码库并提取持续学习模式
orq coach # 运行令牌教练审计和上下文健康评分
orq expand [id] # 检索或列出存档的渐进式披露输出
orq compact-restore [session] # 生成压缩后上下文 Intel 摘要
orq theme [name] # 列出或切换视觉主题（cyberpunk、dracula、nord）
# 内存和仪表盘
orq memory save "..." # 保存项目内存
orq memory recall "..." # 搜索内存
orq tokens # 显示令牌使用情况摘要
orq dashboard # 打开网页仪表盘
```
## 🔌 模型上下文协议（MCP）
AgentForge 通过 **`link`** 智能体和 `mcp/mcp_config.json` 支持原生 MCP：
- **GitHub MCP**：拉取请求、问题管理、代码树搜索
- **Postgres MCP**：模式检查和参数化数据库查询
- **文件系统 MCP**：本地存储导航
- **网络搜索 MCP**：实时文档搜索
```bash
cp mcp/mcp_config.json ~/.gemini/antigravity/mcp_config.json
```
## 🤝 贡献
我们欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 以了解有关添加智能体技能、MCP 服务器、主题和工作流的指南。
## 📄 许可证
MIT 许可证 — 请参阅 [LICENSE](LICENSE) 以获取详细信息。
