guanyang /open-agent-hub

A lightweight, zero-dependency CLI tool to manage and activate capabilities for AI coding assistants (such as Claude Code, Cursor, Trae, etc.).

★ 1,004⑂ 164👁 9⑃ 11● 3▤ 11
TypeScriptMITCreated 2026-01-13
下载:Release v3.0.1Release-3.0.1 ↓3.0.12026-06-24
+1
日增长
1,004
stars
164
forks
9
watchers
11
prs
3
issues
11
releases

README

open-agent-hub

English | 简体中文

一个面向 AI 编码助手(如 Claude Code、Cursor、Trae 等)的本地能力管理中心。通过一个轻量、零依赖的本地 CLI 工具,您可以一键将本仓库的模块化技能 (Skills)、专家角色 (Agents) 与快捷指令 (Commands) 链接并激活到各种 AI 助手的项目工作区或系统全局配置中。

---

 📂 目录结构


.
├── agents/              专家 Agent 系统提示词目录 (agent-.md)
├── commands/            Agent 运行时的 Slash Commands 目录 (.md)
├── docs/                技术规范与使用指南 (Agent, Command, Skill 指南)
├── scripts/             CLI 核心管理脚本 (hub.js)
├── skills/              模块化能力技能库目录 (83+ 技能)
├── spec/                Agent 能力标准与技术规范定义目录
├── template/            新增能力组件(Skill/Agent/Command)开发模板
├── AGENTS.md            LLM 编码行为规范指导 (项目级)
├── CLAUDE.md            Claude 编码行为规范指导 (项目级)
├── GEMINI.md            Gemini 编码行为规范指导 (项目级)
├── CHANGELOG.md         项目版本更新日志
├── CONTRIBUTING.md      社区贡献与代码提交指南
├── LICENSE              MIT 开源授权协议
├── SECURITY.md          安全策略与缺陷反馈机制说明
├── package.json         CLI 工具 npm 全局链接与发布配置
├── skills_index.json    动态扫描后生成的技能元数据全局索引
├── skills_sources.json  oah sync 同步指令依赖的上游技能数据源配置
├── README.md            英文主文档
└── README.zh-CN.md      中文主文档

(注:AGENTS.md、CLAUDE.md、GEMINI.md 是项目级 LLM 编码行为规范指导文件,其设计源于 andrej-karpathy-skills)

---

 📖 技术规范与开发指南

为了保持根目录文档的高聚焦度与专业性,各项能力的具体设计规范与细节已被整理至 docs/ 目录下统一管理:

   🧩 Skill 技能指南 (英文):模块化技能的设计标准、Frontmatter 触发词规则以及 83 个内置技能的完整目录。
   🤖 Agent 角色指南 (英文):Orchestrator(协调者)、Evaluator(评估者)、Optimizer(优化者)的角色定义、对接契约与反馈循环机制。
   🛠 Command 指令指南 (英文):Agent 运行时 Slash Commands(如 /commit、/review、/test-tdd)的设计规范与执行流。

---

 🔌 兼容性

open-agent-hub 采用标准的 Markdown 格式与 YAML Frontmatter 元数据。CLI 工具会动态将组件(Skills、Agents、Commands)链接到 AI 编码助手对应项目或全局配置路径下的子目录(如 /skills/、/agents/、/commands/)中:

| 助手名称 | 类型 | 兼容性 | 项目路径 (工作区) | 全局路径 (系统级) |
| :--- | :--- | :--- | :--- | :--- |
| Claude Code | CLI | ✅ 完整 | .claude/ | ~/.claude/ |
| Antigravity | IDE | ✅ 完整 | .agents/ | ~/.gemini/antigravity/ |
| Gemini CLI | CLI | ✅ 完整 | .gemini/ | ~/.gemini/ |
| Codex | CLI | ✅ 完整 | .codex/ | ~/.codex/ |
| Cursor | IDE | ✅ 完整 | .cursor/ | ~/.cursor/ |
| Trae | IDE | ✅ 完整 | .trae/ | ~/.trae/ |
| OpenCode | CLI | ✅ 完整 | .opencode/ | ~/.config/opencode/ |
| Kiro | CLI/Agent | ✅ 完整 | .kiro/ | ~/.kiro/ |

 [!TIP]
 CLI 工具 (oah) 会在这些路径下自动映射相应的子目录,例如:技能映射至 /skills/,专家角色映射至 /agents/,快捷命令映射至 /commands/。此外,仓库还原生提供了 Claude Code (.claude-plugin/)、Codex (.codex-plugin/) 与 Cursor (.cursor-plugin/) 的官方插件配置。

---

 🚀 快速开始

你可以直接使用 Vercel 官方标准的 skills CLI 工具安装本仓库的技能,也可以通过克隆仓库并使用内置的零依赖管理工具 (oah) 来一键管理 Skills、Agents 和 Slash Commands。

 方式一:使用 Vercel 的 skills CLI 快速安装 (最简便)

如果你仅需要使用本仓库的模块化技能 (Skills),且正在使用与之兼容的 AI 助手(如 Claude Code、Cursor 等),你可以直接使用 Vercel 官方的 skills 命令行工具从本仓库进行拉取,无需克隆整套代码:

bash
 安装本仓库中所有的技能到项目中
npx skills@latest add guanyang/open-agent-hub

 仅安装某个特定技能 (例如 remotion 技能)
npx skills@latest add guanyang/open-agent-hub --skill remotion


 方式二:克隆并使用内置的 CLI 工具 (oah)

如果你需要动态管理本仓库的 Skills(技能)、Agents(角色)和 Slash Commands(快捷指令)(例如通过本地软链接激活),或者需要从上游同步更新技能源,你可以克隆本仓库并使用 oah 工具:

 1. 克隆仓库
首先将本仓库克隆到本地(建议放在一个固定位置以便全局引用):
bash
git clone https://github.com/guanyang/open-agent-h

Top issues

Latest release

Release v3.0.1 v3.0.1 2026-06-24
Commits in this release:

- feat: add automated GitHub release workflow and helper script for tagging and deployment (af3910b)
- chore(sync): auto-sync skills from upstream sources [skip ci] (c1ea853)
- chore(sync): auto-sync skills from upstream sources [skip ci] (215504d)
- chore(sync): auto-sync skills from upstream sources [skip ci] (335ee67)
- chore(sync): auto-sync skills from upstream sources [skip ci] (8531387)
- chore(sync): auto-sync skills from upstream sources [skip ci] (67313f2)
- chore(sync): auto-sync skills from upstream sources [skip ci] (0146e67)
- chore(sync): auto-sync skil

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON