# AI Agent Engine

**Repository Path**: jiangqiang1996/ai-agent-engine

## Basic Information

- **Project Name**: AI Agent Engine
- **Description**: 基于opencode深度定制的插件，可彻底替代OMO，superpowers等插件。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 17
- **Forks**: 5
- **Created**: 2026-04-18
- **Last Updated**: 2026-07-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Agent Engine

AI Agent Engine（AE）是 opencode 的工程工作流插件。它提供技能、命令、子代理、工具和内置规则，让 AI 代理按可检查流程完成需求澄清、设计、计划、实现、审查、验证、交接和交付。

AE 不要求业务项目采用本仓库结构。面向用户的运行时能力以 `src/` 下资产为真源，安装后的实际可用能力以 `/ae-help` 为准。

## 快速开始

### 安装、更新与卸载

首次安装时（AE 技能尚未可用），把以下指令复制给 opencode AI 代理执行：

全局安装（所有项目共享 AE）：

```text
Fetch and follow the global install instructions from https://gitee.com/jiangqiang1996/ai-agent-engine/raw/master/docs/INSTALL.md
```

项目级安装（仅当前项目，可与全局共存，项目级优先加载）：

```text
Fetch and follow the project-level install instructions from https://gitee.com/jiangqiang1996/ai-agent-engine/raw/master/docs/INSTALL.md
```

安装完成后，后续更新或卸载可用 AE 内置命令。不传参数为全局操作，传 `project` 为项目级操作：

```text
# 全局更新
/ae-install

# 项目级更新
/ae-install project
```

卸载无需传参数，命令会自动检测全局和项目级安装状态，让你选择卸载范围（全局、项目级、两者或不卸载）：

```text
/ae-uninstall
```

> 脚本会自动判断：已安装则更新，未安装则全新安装。项目级安装和全局安装可以共存，项目级优先加载。

### 验证

重启 opencode 后运行：

```text
/ae-help
/ae-help review
```

能看到技能、命令、代理和模型路由，说明插件已加载。

## 经典用法

手动控制阶段：

```text
/ae-brainstorm 设计一个多租户数据隔离方案
/ae-prd
/ae-design
/ae-review domain:document
/ae-work
/ae-review
```

`/ae-brainstorm` 仅做多视角发散讨论与汇总，不产出文档；当讨论结果需要沉淀为正式需求文档时，由 `/ae-prd` 接续。`/ae-design` 在需求之后产出设计文档，包含架构、接口、数据模型、测试用例和实现单元，供 `/ae-work` 直接执行。

只做代码或文档审查：

```text
/ae-review mode:report-only
/ae-review domain:document docs/ae/designs/example.md
```

前端和浏览器验收：

```text
/ae-chrome-devtools
/ae-web-forge 实现登录页
/ae-web-forge --inspect http://localhost:3000/login
```

解析 Swagger/OpenAPI：

```text
/ae-swagger-parser ./openapi.json method:POST keyword:login mode:detail
```

探索性修复：

```text
/ae-task-loop 修复所有 TypeScript 编译错误
```

## 常用入口

| 目标 | 入口 |
| --- | --- |
| 查看当前能力 | `/ae-help` |
| 多视角发散讨论 | `/ae-brainstorm` |
| 需求澄清与需求文档 | `/ae-prd` |
| 设计阶段（架构、接口、数据模型、实现单元） | `/ae-design` |
| 计划执行 | `/ae-work` |
| Worktree 继续执行 | `/ae-work-continue` |
| 分支或 worktree 合并 | `/ae-merge-branch` |
| 工作总结 | `/ae-work-report` |
| 查看本人代码变更 | `/ae-my-code-changes` |
| 代码或文档审查 | `/ae-review` |
| 前端设计、还原、交互或验收 | `/ae-web-forge` |
| chrome-devtools 浏览器能力 | `/ae-chrome-devtools` |
| 接口测试 | `/ae-api-tester` |
| Swagger/OpenAPI 摘要 | `/ae-swagger-parser` |
| 图片转 Markdown 描述 | `/ae-image` |
| 创建或编辑 DOCX | `/ae-docx` |
| 创建或编辑 PDF | `/ae-pdf` |
| 创建或编辑 PPTX | `/ae-pptx` |
| 创建或编辑 XLSX | `/ae-xlsx` |
| Office 文档原生操作 | `/ae-officecli` |
| 幻灯片大纲生成 | `/ae-slides-outline` |
| 项目关系图谱 | `/ae-graph-build`、`/ae-graph-query` |
| 探索性修复 | `/ae-task-loop` |
| 数据库操作 | `/ae-sql` |
| 会话交接 | `/ae-handoff` |
| 创建技能 | `/ae-skill-creator` |
| 提示词优化 | `/ae-prompt-optimize` |
| 创建代理 | `/ae-agent-creator` |
| 安装或更新 AE 插件 | `/ae-install` |
| 卸载 AE 插件 | `/ae-uninstall` |

详细参数、代理分工、工具边界和产物路径见 [docs/usage-guide.md](docs/usage-guide.md)。配置合并和模型场景路由见 [docs/builtin-config.md](docs/builtin-config.md)。

## 工作规则

| 规则 | 说明 |
| --- | --- |
| 需求不清先澄清 | 复杂实现前先产出需求或设计，避免直接编码 |
| 审查先定范围 | 代码、文档或通用混合范围按目标类型选择审查代理 |
| 交付必须验证 | `/ae-work` 交付前检查验证、审查和 Git 授权证据 |
| 浏览器先注册 MCP | 当前会话使用 chrome-devtools-mcp 工具前必须先通过 `/ae-chrome-devtools` 完成动态注册或连接状态确认 |
| Git 写操作需授权 | 提交、拉取、重置、清理、变基、推送等都需要明确授权；`/ae-commit` 不等同于 push |
| 远程写操作不默认提供 | 用户侧流程不提供 push、创建 PR、创建 Issue 或 Release 的可复制流程 |

## 资产快照

| 类型 | 当前快照 | 真源 |
| --- | ---: | --- |
| 技能 | 33 | `src/assets/skills/`、`src/schemas/ae-asset-schema.ts` |
| 命令 | 40 | `src/services/command-registration.ts`、`src/assets/commands/` |
| 代理 | 32 | `src/assets/agents/`、`src/services/agent-registration.ts` |
| 工具 | 26 | `src/tools/` |
| 规则 | 4 | `src/assets/rules/` |
| 内置配置 | 1 | `src/assets/config/ae.jsonc` |

该表是文档快照，不替代 `/ae-help`。

## 配置

AE 默认注入两个远程 MCP：

| 名称 | 作用 |
| --- | --- |
| `context7` | 获取库/框架文档 |
| `gh_grep` | 搜索真实 GitHub 代码示例 |

可选配置入口：

| 路径 | 作用 |
| --- | --- |
| `.opencode/ae.jsonc` | 当前项目覆盖 AE 内置配置 |
| `~/.config/opencode/ae.jsonc` | 当前用户的全局默认配置 |

示例：

```jsonc
{
  "$schema": "https://raw.giteeusercontent.com/jiangqiang1996/ai-agent-engine/raw/master/src/assets/config/ae.schema.json",
  "modelScenarios": {
    "quick": "provider/fast-model",
    "standard": "provider/default-model",
    "deep": "provider/strong-model",
    "vision": "provider/vision-model"
  }
}
```

完整规则见 [docs/builtin-config.md](docs/builtin-config.md)。

## 开发

本仓库是 AE opencode 插件源码仓库。`dist/` 是构建产物，`.opencode/plugins/` 是本仓库调试桥接目录，不代表业务项目必须具备的结构。

| 操作 | 命令 |
| --- | --- |
| 安装依赖 | `npm install` |
| 构建 | `npm run build` |
| 测试 | `npm run test` |
| 类型检查 | `npm run typecheck` |

| 路径 | 作用 |
| --- | --- |
| `src/index.ts` | server 插件入口 |
| `src/assets/skills/` | 技能提示词和参考文件 |
| `src/assets/commands/` | Markdown 命令 |
| `src/assets/agents/` | 子代理提示词 |
| `src/assets/rules/` | 注入用户会话的规则 |
| `src/tools/` | opencode 工具定义 |
| `src/services/` | 注册、门禁、审查、配置和解析服务 |
| `src/schemas/` | 资产常量和输入 schema |

## 文档入口

| 入口 | 内容 |
| --- | --- |
| [docs/usage-guide.md](docs/usage-guide.md) | 用户手册、经典用法、能力说明、代理、工具、产物路径 |
| [docs/builtin-config.md](docs/builtin-config.md) | MCP、`ae.jsonc`、模型场景路由和覆盖规则 |
| [docs/INSTALL.md](docs/INSTALL.md) | 安装或更新、卸载代理执行说明 |
| [docs/development.md](docs/development.md) | 本仓库开发规范、架构和测试 |
| `/ae-help` | 当前运行时权威帮助 |