# agent-academy

**Repository Path**: hongmaple/agent-academy

## Basic Information

- **Project Name**: agent-academy
- **Description**: Agent Academy 是一个开源的 AI Agent 训练知识库，致力于为 AI 助手（如 OpenClaw、Claude、ChatGPT 等）提供结构化的技能体系和知识资源。

就像人类需要在学校学习各种技能一样，AI Agent 也需要一个"学院"来获取知识、提升能力。Agent Academy 正是这样一个知识宝库，包含了软件开发、产品设计、数据分析、AI/ML 等 12 个领域
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 8
- **Forks**: 0
- **Created**: 2026-03-13
- **Last Updated**: 2026-03-15

## Categories & Tags

**Categories**: rag

**Tags**: None

## README

# 🎓 Agent Academy - AI Agent 训练学院

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Skills](https://img.shields.io/badge/skills-800+-green.svg)](skills/)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)

**[English Documentation](README_EN.md)** | **中文文档**

> **训练、培养、共享** - 一个用于训练和培养 AI Agent 的共享知识库

## 📖 项目简介

**Agent Academy** 是一个开源的 AI Agent 训练知识库，致力于为 AI 助手（如 OpenClaw、Claude、ChatGPT 等）提供结构化的技能体系和知识资源。

就像人类需要在学校学习各种技能一样，AI Agent 也需要一个"学院"来获取知识、提升能力。Agent Academy 正是这样一个知识宝库，包含了软件开发、产品设计、数据分析、AI/ML 等 12 个领域的 800+ 精选技能，以及完整的 MCP（Model Context Protocol）知识体系。

### 🎯 核心价值

| 价值 | 说明 |
|------|------|
| **训练** | 提供结构化的技能和知识，让 Agent 快速学习特定领域的能力 |
| **培养** | 持续的知识更新和最佳实践，帮助 Agent 不断成长进化 |
| **共享** | 开源社区协作，知识互通，让每个人都能贡献和受益 |

### 💡 使用场景

- **个人开发者**：为你的 AI 助手配置专业技能，提升工作效率
- **团队协作**：建立团队共享知识库，保持 AI 助手能力一致
- **企业用户**：私有部署，定制化训练企业专属 AI 助手
- **开源社区**：贡献技能，分享知识，共同建设 AI 生态

## ✨ 特性

- 📦 **800+ 精选技能** - 覆盖开发、设计、数据分析等 12 个领域
- 📚 **知识体系完整** - MCP、记忆系统、多 Agent 协作、浏览器自动化、工作区规范
- 🧠 **记忆增强方案** - 四层记忆架构，Token 消耗降低 90%
- 👥 **多 Agent 协作** - 团队组建模式，任务协调策略
- 🌐 **浏览器自动化** - Puppeteer/Playwright 完整指南
- 🏠 **工作区规范** - OpenClaw 身份定义、记忆管理、安全边界
- 🔄 **CI/CD 集成** - 自动化统计、验证、发布流程
- 🚀 **快速开始** - 一键安装，开箱即用
- 🤝 **社区驱动** - 开源协作，持续更新

## 📦 安装

### 支持的 AI 平台

Agent Academy 支持多种 AI Agent 框架：

| 平台 | 安装方式 | 说明 |
|------|---------|------|
| **OpenClaw** | 一键脚本 | 完整支持，推荐 |
| **Claude** | 手动安装 | 复制技能到 Claude 项目 |
| **ChatGPT** | 手动安装 | 作为知识库引用 |
| **Cursor** | 手动安装 | 作为项目上下文 |
| **其他** | 手动安装 | 通用知识库格式 |

### 方式一：OpenClaw 一键安装（推荐）

```bash
# Linux/macOS
curl -fsSL https://gitee.com/hongmaple/agent-academy/raw/master/scripts/install.sh | bash

# Windows (PowerShell)
Invoke-WebRequest -Uri "https://gitee.com/hongmaple/agent-academy/raw/master/scripts/install.ps1" -OutFile "install.ps1"; ./install.ps1
```

**安装内容包括**：
- ✅ Node.js 24 LTS
- ✅ OpenClaw 核心
- ✅ 800+ 技能库
- ✅ MCP 知识体系
- ✅ 记忆系统方案
- ✅ 多 Agent 协作
- ✅ 浏览器自动化指南
- ✅ 工作区规范模板
- ✅ 完整项目文档

### 方式二：通用安装（适用所有 AI 平台）

**步骤 1：克隆知识库**

```bash
git clone https://gitee.com/hongmaple/agent-academy.git
```

**步骤 2：根据你的 AI 平台配置**

<details>
<summary><b>Claude 项目配置</b></summary>

```bash
# 复制技能到 Claude 项目
mkdir -p ~/.claude/skills
cp -r agent-academy/skills/* ~/.claude/skills/

# 复制知识文档
mkdir -p ~/.claude/knowledge
cp -r agent-academy/knowledge/* ~/.claude/knowledge/

# 更新 Claude 配置
echo "Skills directory: ~/.claude/skills" >> ~/.claude/config.md
```
</details>

<details>
<summary><b>Cursor 项目配置</b></summary>

```bash
# 将知识库放在项目根目录
cd your-project
git clone https://gitee.com/hongmaple/agent-academy.git .agent-academy

# 在 .cursorrules 中引用
echo "知识库位置: .agent-academy/skills/" >> .cursorrules
echo "MCP 文档: .agent-academy/knowledge/mcp/" >> .cursorrules
```
</details>

<details>
<summary><b>ChatGPT / 其他平台</b></summary>

```bash
# 作为知识库使用
# 1. 将 skills/ 目录中的 SKILL.md 文件作为 prompt 输入
# 2. 将 knowledge/ 目录中的文档作为上下文引用
# 3. 选择性加载需要的技能和知识

# 例如：加载 MCP 知识
cat agent-academy/knowledge/mcp/mcp-quick-start.md
```
</details>

### 方式三：Agent 自动安装

让 AI Agent 自己安装技能库，只需告诉它：

```
请帮我安装 Agent Academy 知识库：
1. 克隆仓库：git clone https://gitee.com/hongmaple/agent-academy.git ~/.openclaw/knowledge/agent-academy
2. 复制技能：将 skills/ 目录复制到 ~/.openclaw/workspace/skills/
3. 复制知识：将 knowledge/ 目录复制到 ~/.openclaw/workspace/knowledge/
4. 复制模板：将 templates/ 目录复制到 ~/.openclaw/workspace/templates/
5. 复制文档：将 README.md、CONTRIBUTING.md、LICENSE 等复制到工作区
6. 配置使用：更新 AGENTS.md 或相关配置文件
```

### 方式四：选择性安装

```bash
# 只安装需要的技能分类
git clone --depth 1 https://gitee.com/hongmaple/agent-academy.git
cp -r agent-academy/skills/development ~/.agents/skills/      # 开发技能
cp -r agent-academy/skills/ai-ml ~/.agents/skills/            # AI/ML 技能
cp -r agent-academy/skills/integrations ~/.agents/skills/     # 集成技能

# 只安装 MCP 知识
cp -r agent-academy/knowledge/mcp ~/.agents/knowledge/
```

### 方式三：Fork 后定制

```bash
# 1. Fork 本仓库到你的账号

# 2. 克隆你 Fork 的仓库
git clone https://gitee.com/[你的用户名]/agent-academy.git

# 3. 添加上游仓库（保持同步）
git remote add upstream https://gitee.com/hongmaple/agent-academy.git

# 4. 定制你的技能库
# 添加、修改、删除技能...

# 5. 同步上游更新
git fetch upstream
git merge upstream/master
```

## 🚀 快速开始

1. **浏览技能**：查看 [技能索引](skills/README.md) 了解可用技能
2. **学习 MCP**：阅读 [MCP 知识库](knowledge/mcp/README.md) 掌握工具集成
3. **配置使用**：参考 [使用指南](docs/usage.md) 配置你的 AI 助手
4. **贡献技能**：参考 [贡献指南](CONTRIBUTING.md) 参与社区建设

## 📚 文档

| 文档 | 说明 |
|------|------|
| [技能索引](skills/README.md) | 800+ 技能完整列表和分类 |
| [MCP 快速入门](knowledge/mcp/mcp-quick-start.md) | 5 分钟上手 MCP 工具 |
| [MCP 最佳实践](knowledge/mcp/mcp-best-practices.md) | MCP 开发和使用指南 |
| [MCP 工具配置](knowledge/mcp/mcp-tools-configuration.md) | 20+ 工具配置手册 |
| [记忆系统](knowledge/memory-systems/README.md) | 四层记忆架构、QMD 搜索 |
| [多 Agent 协作](knowledge/multi-agent/README.md) | 团队组建、任务协调 |
| [浏览器自动化](knowledge/browser-automation/README.md) | Puppeteer、Playwright 指南 |
| [工作区规范](knowledge/workspace-standards/README.md) | OpenClaw 身份与记忆管理 |
| [贡献指南](CONTRIBUTING.md) | 如何参与项目贡献 |

## 📂 目录结构

```
agent-academy/
├── skills/              # 技能库（800+ 技能）
│   ├── pm-product/      # 产品与项目管理类（5个）
│   ├── development/     # 开发与编程类（21个）
│   ├── design/          # 设计与界面类（14个）
│   ├── documentation/   # 文档与写作类（5个）
│   ├── data-analysis/   # 数据分析类（8个）
│   ├── tool-development/# 工具开发类（16个）
│   ├── web-api/         # Web/API 开发类
│   ├── security-testing/# 安全与测试类（3个）
│   ├── ai-ml/           # AI/机器学习类（21个）
│   ├── frameworks/      # 框架与库类（4个）
│   ├── integrations/    # 集成类（28个）
│   └── others/          # 其他技能（29个）
├── knowledge/           # 知识库
│   ├── mcp/            # MCP 知识体系（8个文档）
│   ├── memory-systems/ # 记忆系统（四层架构、QMD搜索）
│   ├── multi-agent/    # 多Agent协作（团队模式、通信协议）
│   ├── browser-automation/ # 浏览器自动化（Puppeteer、Playwright）
│   └── workspace-standards/ # 工作区规范（SOUL、AGENTS、记忆管理）
├── templates/          # 模板文件
├── scripts/            # 自动化脚本
├── .github/            # CI/CD 配置
└── docs/               # 文档站点
```

## 🤝 贡献

我们欢迎所有形式的贡献！这是一个 **共建共享** 的知识库，每个人都可以参与。

### 贡献方式

| 方式 | 说明 | 难度 |
|------|------|------|
| 📝 **提交新技能** | 分享你的专业技能 | ⭐⭐ |
| 📚 **完善文档** | 改进现有文档或翻译 | ⭐ |
| 🐛 **报告 Bug** | 帮助我们发现和修复问题 | ⭐ |
| 💡 **提出建议** | 分享你的想法和需求 | ⭐ |
| 🔧 **改进代码** | 优化现有技能和脚本 | ⭐⭐⭐ |

### 📤 提交 PR 流程

#### 步骤 1：Fork 仓库

1. 访问 [Agent Academy](https://gitee.com/hongmaple/agent-academy)
2. 点击右上角 **Fork** 按钮
3. 选择你的账号作为目标空间

#### 步骤 2：克隆并创建分支

```bash
# 克隆你 Fork 的仓库
git clone https://gitee.com/[你的用户名]/agent-academy.git
cd agent-academy

# 创建功能分支
git checkout -b feature/your-skill-name
```

#### 步骤 3：添加或修改技能

```bash
# 创建技能目录
mkdir -p skills/[分类]/[技能名]

# 创建技能文件
touch skills/[分类]/[技能名]/SKILL.md
```

**技能模板**：

```markdown
# 技能名称

> 版本：1.0.0
> 更新时间：2026-03-13
> 分类：[分类名称]

## 📋 技能概述
[技能简介]

## 🎯 核心功能
- 功能 1
- 功能 2

## 🚀 使用方法
[使用说明]
```

#### 步骤 4：提交并推送

```bash
# 添加文件
git add .

# 提交（使用规范格式）
git commit -m "feat(skill): add [技能名] skill"

# 推送到你的仓库
git push origin feature/your-skill-name
```

#### 步骤 5：创建 Pull Request

1. 访问你 Fork 的仓库页面
2. 点击 **Pull Request** 按钮
3. 填写 PR 标题和描述
4. 提交 PR 等待审核

### 📋 PR 审核标准

| 检查项 | 要求 |
|--------|------|
| 提交消息 | 符合 Conventional Commits 格式 |
| 文件结构 | 遵循技能目录规范 |
| 文档完整 | 包含 SKILL.md，说明清晰 |
| 无敏感信息 | 不包含密钥、密码、私人数据 |
| 代码质量 | 无明显 Bug，注释完整 |

### 🔄 保持同步

```bash
# 添加上游仓库
git remote add upstream https://gitee.com/hongmaple/agent-academy.git

# 同步最新代码
git fetch upstream
git merge upstream/master

# 推送到你的仓库
git push origin master
```

### 🤖 让 Agent 帮你提交 PR

告诉你的 AI Agent：

```
请帮我向 Agent Academy 提交一个新技能：
1. 技能名称：xxx
2. 技能分类：development/ai-ml/integrations 等
3. 技能功能：xxx
4. 使用方法：xxx

按照 CONTRIBUTING.md 的流程帮我创建 PR
```

详见 [贡献指南](CONTRIBUTING.md)

## 📊 统计

| 指标 | 数量 |
|------|------|
| 技能总数 | 800+ |
| 分类数量 | 12 |
| MCP 文档 | 8 |
| CI/CD 工作流 | 4 |
| 代码行数 | 430,000+ |

## 🏢 关联项目

### 🍁 枫琳·人机协作平台

> 让 AI 与人类无缝协作，打造智能化的工作流程

**项目地址**：[https://gitee.com/hongmaple/mapleclaw](https://gitee.com/hongmaple/mapleclaw)

枫琳平台是一个创新的人机协作解决方案，将 Agent Academy 的技能体系应用于实际业务场景，实现：
- 🤖 智能任务分配与执行
- 📊 自动化工作流程
- 🔄 人机协同决策
- 📈 持续学习与优化

---

## 👥 作者

| 角色 | 信息 |
|------|------|
| **组织** | MapleClaw Team |
| **维护者** | 小琳、小猪、小熊 |
| **联系方式** | [Gitee Issues](https://gitee.com/hongmaple/agent-academy/issues) |

## 📄 许可证

[MIT License](LICENSE) - 可自由使用、修改和分发

---

<div align="center">

**⭐ 如果这个项目对你有帮助，请给一个 Star ⭐**

Made with ❤️ by [MapleClaw Team](https://gitee.com/hongmaple)

[🏠 主页](https://gitee.com/hongmaple/agent-academy) · [📖 文档](docs/) · [🐛 反馈](https://gitee.com/hongmaple/agent-academy/issues) · [🤝 贡献](CONTRIBUTING.md)

</div>