@tc-bbu/skill-manager

BBU AI 平台技能管理 CLI 工具。支持在多种 AI Agent 平台上搜索、安装和管理技能。

支持平台

| 平台 | 项目目录 | 全局目录 | |------|----------|----------| | Cursor | .cursor/skills/ | ~/.cursor/skills/ | | Windsurf | .windsurf/skills/ | ~/.codeium/windsurf/skills/ | | OpenClaw | skills/ | ~/.openclaw/skills/ | | Claude Code | .claude/skills/ | ~/.claude/skills/ | | Trae | .trae/skills/ | ~/.trae/skills/ |

快速开始

通过 npx 直接使用（推荐）

无需全局安装，直接运行：

npx @tc-bbu/skill-manager install <skill-name> --code <exchange-code>

全局安装

npm install -g @tc-bbu/skill-manager

认证

首次使用需要提供兑换码（Exchange Code）完成认证。兑换码可在 BBU 平台的技能详情页或个人设置页获取。

# 方式一：安装时同时认证（推荐）
npx @tc-bbu/skill-manager install my-skill --code bbu_ex_xxxxxx

# 方式二：先认证再安装
npx @tc-bbu/skill-manager auth login --code bbu_ex_xxxxxx
npx @tc-bbu/skill-manager install my-skill

认证成功后，API Token 会保存到 ~/.bbu/credentials.json，后续操作无需再次认证。

命令

install <name> — 安装技能

skill-manager install <name> [options]

Options:
  --code <code>          兑换码（首次安装时提供）
  --platform <platform>  指定平台 (cursor/windsurf/openclaw/claude/trae)
  --scope <scope>        安装范围 (project/global)，默认 project
  --type <type>          资源类型，默认 skill

示例：

# 安装到当前项目
npx @tc-bbu/skill-manager install my-skill

# 安装到全局
npx @tc-bbu/skill-manager install my-skill --scope global

# 指定平台
npx @tc-bbu/skill-manager install my-skill --platform windsurf

search <query> — 搜索技能

skill-manager search <query> [--type <type>]

info <name> — 查看技能详情

skill-manager info <name> [--type <type>]

list — 列出已安装技能

skill-manager list [--platform <platform>] [--scope <scope>]

update [name] — 更新技能

# 更新指定技能
skill-manager update my-skill

# 更新所有已安装技能
skill-manager update

auth login — 认证

skill-manager auth login --code <exchange-code>

auth status — 查看认证状态

skill-manager auth status

全局选项

--server <url>   指定 BBU 平台地址（默认使用已保存的地址）
--version        显示版本号
--help           显示帮助信息

自动平台检测

CLI 会按以下优先级自动检测当前平台：

1. 环境变量（如 CURSOR_SESSION_ID、WINDSURF_SESSION_ID）
2. 项目目录标识文件（如 .cursor/、.windsurf/）
3. 默认使用 Cursor

也可通过 --platform 参数手动指定。

系统要求

• Node.js >= 18.0.0
• 支持 Windows、macOS、Linux

License

MIT