CLI open-agent-hub 零依赖管理AI编程助手能力的命令行工具

在 Claude Code、Cursor、Trae 这类 AI 编程助手普及之后，团队里最常见的抱怨不是模型不够强，而是“同事那个好用的 skill 我怎么装不上”。这些能力本质上是存放在不同隐藏目录里的 Markdown 文件：Claude Code 在 ~/.claude，Cursor 在 .cursor/rules，Trae 又在 ~/.config/trae。换一台机器、换一个项目，就得手工翻目录、复制文件、改路径，稍有疏忽就出现“能搜到但点不开”的死链接。

更麻烦的是版本。一个 React 性能审查 skill 可能每周都在更新，手动维护意味着你永远在用三个月前的旧版本。open-agent-hub 的思路是把这些散落的能力收拢到一个仓库，再用一个零依赖的命令行工具统一管理——安装、启用、状态检查、跨源同步，全部一行命令解决。

open-agent-hub 本身是一个 TypeScript 写的轻量 CLI（名为 oah），内置 83 个以上的 skill、agent 与 command 模板，覆盖 UI/UX 设计、全栈规划、工作流编排等场景，并且兼容 Vercel 的 skills CLI 生态，可以直接用 npx 一键拉取。

项目基本信息

一、项目介绍

open-agent-hub 把自己定位为“AI 编程助手的能力中枢”。它不绑定某一家模型或某一种客户端，而是把 skill（能力单元）、agent（专家系统提示）、command（斜杠命令）三类资产模块化，集中在一个仓库里维护。仓库结构清晰：skills/ 存放具体能力，agents/ 存放专家提示，commands/ 存放运行时命令，docs/ 与 spec/ 提供技术规范，template/ 则给出新建能力的脚手架。

对使用者来说，它解决的是“分发与同步”问题：你不再需要记住每个 skill 放在哪个目录，oah 会动态扫描当前项目工作区与全局配置，告诉你哪些能力已链接、哪些失效，并一键启用。

二、核心优势

1. 零依赖：CLI 本体不依赖重型运行时，clone 后 npm link 即可用，或用 npx 免安装调用。
2. 跨客户端：同一套 skill 可同时供给 Claude Code、Cursor、Trae，避免重复维护。
3. 集中同步：oah sync 能把多个来源一次性拉平到最新，告别手动更新。
4. 可视化状态：oah status 直接输出链接健康度，死链一眼可见。
5. 生态兼容：支持 Vercel skills CLI 的 add 协议，可当作任意 skills 仓库的上游。

三、适用场景

• 团队内部统一 AI 编程规范：把最佳实践打包成 skill，新成员一行命令接入。
• 个人多设备同步：笔记本、台式机、服务器共用同一份能力清单。
• 开源能力分发：作者把 skill 发布到 GitHub，用户 npx 即可安装。
• 全栈与设计协作：内置 UI/UX、规划类 skill，适合产品与工程混合团队。

四、安装教程

方式一，使用 Vercel skills CLI 免安装添加（最简单）：

# 添加本仓库全部 skill
npx skills@latest add guanyang/open-agent-hub

# 仅添加某个具体 skill，例如 remotion
npx skills@latest add guanyang/open-agent-hub --skill remotion

方式二，克隆后用内置 CLI：

git clone https://github.com/guanyang/open-agent-hub.git ~/open-agent-hub
cd ~/open-agent-hub
npm link

常见问题：若 npm link 后 oah 命令找不到，通常是 ~/.local/bin 不在 PATH。执行 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc（macOS 默认 zsh，Linux 用 ~/.bashrc）即可。

五、使用示例

启用一组能力并打印状态：

# 列出所有扫描到的 Skills、Agents、Commands
oah list

# 检查当前项目工作区的链接状态
oah status

# 启用某个具体组件（如 canvas 设计能力）
oah enable canvas-design

# 启用当前项目下全部组件
oah enable

# 同步所有已配置来源到最新
oah sync

真实输出示例（oah status 片段）：

[OK]   canvas-design     linked  ~/.claude/skills/canvas-design
[OK]   react-planning    linked  ./.cursor/rules/react-planning
[WARN] legacy-tool       broken  link target missing

这说明两个能力已正确链接，一个旧能力因目标缺失而失效，正好对应前面提到的“死链”痛点。

六、常见问题

Q：oah 和 npx skills add 有什么区别？
A：npx 方式把能力复制到客户端目录，oah 方式则保留中心仓库并通过符号链接管理，更适合多来源同步。

Q：支持 Windows 吗？
A：CLI 本身跨平台，Windows 下用 Git Bash 或 PowerShell 运行 oah 命令即可，能力与 macOS/Linux 一致。

Q：能只同步某个来源吗？
A：可以，oah sync anthropics-skills 只更新指定来源，避免全量拉取。

七、总结

open-agent-hub 用一个轻量 CLI 把“AI 编程助手能力”这件本来混乱的事标准化了：集中存放、动态扫描、一键启用、跨源同步。对于在多个客户端、多台设备之间切换的开发者，它几乎是必装的基础设施。仓库目前以 MIT 协议开源，社区仍在快速扩充 skill 数量，值得长期关注。