tbox-skills

Agent Skills 的命令行管理工具，用于从注册中心发现、安装和管理可复用的 AI Agent 技能包。

背景

在构建 AI Agent 应用时，许多能力（如代码审查、测试生成等）可以被抽象为独立的"技能"进行复用。tbox-skills 提供了一个类似 npm 的包管理体验，让你可以方便地从技能注册中心获取和管理这些技能。

安装

npm install -g tbox-skills

使用方法

全局选项

tbox-skills --pre    # 使用预发环境的注册中心

安装技能

从注册中心下载并安装一个技能到本地：

tbox-skills add <skill-name>

可通过 -d 指定安装目录（默认为 ./skills）：

tbox-skills add code-review -d ./my-skills

更新技能

更新已安装的技能到注册中心的最新版本：

# 更新所有已安装的技能
tbox-skills update

# 更新指定的技能
tbox-skills update <skill-name> [skill-name2...]

支持的选项：

• -d, --dir <directory> — 技能安装目录（默认 ./skills）
• -c, --concurrency <number> — 最大并发更新数（默认 4）
• --dry-run — 仅显示将会更新的技能，不实际执行下载

# 预览将更新哪些技能
tbox-skills update --dry-run

# 以 2 个并发更新指定技能
tbox-skills update code-review test-generator -c 2

查看已安装的技能

tbox-skills list

移除技能

tbox-skills remove <skill-name>

搜索技能

tbox-skills find <query>

项目结构

src/
├── cli.ts              # CLI 入口
├── downloader.ts       # ZIP 下载与解压
├── utils.ts            # 工具函数（日志、路径）
├── commands/           # 命令实现
│   ├── add.ts          # 安装技能
│   ├── find.ts         # 搜索技能
│   ├── list.ts         # 列出已安装技能
│   ├── remove.ts       # 移除技能
│   └── update.ts       # 更新技能
└── registry/           # 注册中心客户端
    ├── types.ts        # 类型定义
    ├── index.ts        # 客户端工厂
    ├── tbox.ts         # Tbox 注册中心实现
    ├── agt.ts          # AGT 注册中心实现
    └── local.ts        # 本地注册中心实现

开发

# 安装依赖
npm install

# 开发模式（watch）
npm run dev

# 构建
npm run build

# 运行测试
npm test

# 格式化代码
npm run format

发布

# 登录，需要广知增加发布权限
npm login

# 发布
npm publish

License

MIT