ai-skills

v1.0.0

Published

3 months ago

企业级 Agent Skill 仓库 CLI 工具

0High
0Medium
0Low

zlevainpm

agent-skills cli cursor claude vscode

AI Skill CLI

企业级 Agent Skill 仓库 CLI 工具

从企业 Git 仓库安装和管理 Agent Skills，支持 Cursor、VS Code、Claude Code 等多种编程工具。

功能特性

✅ 多工具支持 - 支持 Cursor、VS Code、Claude Code、Codex、Antigravity
✅ 自动检测 - 自动检测系统中已安装的编程工具
✅ 灵活安装 - 支持项目级和用户级安装路径
✅ 格式验证 - 内置技能格式验证器，确保技能符合规范
✅ 多种输出 - 支持表格、JSON、简洁文本三种输出格式
✅ 交互式模式 - 提供友好的交互式界面选择技能和工具
✅ 智能搜索 - 支持按名称、描述、标签搜索技能
✅ 批量操作 - 支持批量安装、更新、验证技能
✅ 脚本友好 - JSON 输出格式便于脚本和 CI/CD 集成
✅ 标准兼容 - 符合 Agent Skills 标准和业界 CLI 最佳实践

快速安装

# 使用 npm
npm install -g ai-skills

# 或使用 pnpm
pnpm add -g ai-skills

# 或使用 yarn
yarn global add ai-skills

快速开始

1. 配置仓库

# 设置企业 Git 仓库地址
ai-skills config set-registry https://github.com/levai/ai-skills

# 或使用本地目录
ai-skills config set-local /path/to/local/skills

2. 检测工具

# 检测系统中已安装的编程工具
ai-skills tools

3. 浏览技能

# 列出所有可用技能（表格格式）
ai-skills ls

# 搜索技能
ai-skills search react

# 查看技能详情
ai-skills show react-best-practices

4. 安装技能

# 安装到所有检测到的工具（推荐）
ai-skills install react-best-practices

# 安装到指定工具
ai-skills install react-best-practices --ai cursor

# 交互式安装（选择技能和工具）
ai-skills install -i

5. 管理技能

# 查看已安装的技能
ai-skills ls --installed

# 更新技能
ai-skills update react-best-practices

# 更新所有技能
ai-skills update --all

# 卸载技能
ai-skills rm react-best-practices

命令概览

| 命令 | 功能 | 示例 | |------|------|------| | config | 配置管理 | ai-skills config set-registry <url> | | install | 安装技能 | ai-skills install <skill-name> | | ls | 列出技能 | ai-skills ls --installed | | search | 搜索技能 | ai-skills search <keyword> | | show | 查看详情 | ai-skills show <skill-name> | | update | 更新技能 | ai-skills update --all | | rm | 卸载技能 | ai-skills rm <skill-name> | | check | 验证格式 | ai-skills check <skill-path> | | tools | 检测工具 | ai-skills tools |

使用场景

项目级安装

在项目目录中安装技能，便于版本控制和团队协作：

cd /path/to/my-project
ai-skills install react-best-practices
# 安装到 .cursor/skills/ 或 .vscode/skills/

用户级安装

安装到用户主目录，所有项目共享：

ai-skills install react-best-practices
# 安装到 ~/.cursor/skills/ 或 ~/.vscode/skills/

批量管理

# 安装所有技能
ai-skills install --all

# 更新所有技能
ai-skills update --all

# 验证所有技能
ai-skills check --all

脚本化使用

# JSON 格式输出，便于脚本处理
ai-skills ls --json | jq '.skills[].name'
ai-skills tools --json | jq '.tools[] | select(.name == "cursor")'

输出格式

表格格式（默认）

ai-skills ls

┌──────────────────────────────────────────────────────────────────────────────┐
│ Skill                                                                        │
├──────────────────────────────────────────────────────────────────────────────┤
│ react-best-practices                                                         │
│ React and Next.js performance optimization                                  │
├──────────────────────────────────────────────────────────────────────────────┤
│ code-review                                                                  │
│ Code review guidelines                                                       │
└──────────────────────────────────────────────────────────────────────────────┘

注意：表格是单列格式，技能名称（青色加粗）和描述（普通文本）在同一列中，用换行分隔。

JSON 格式

ai-skills ls --json

{
  "skills": [
    {
      "name": "react-best-practices",
      "description": "React and Next.js performance optimization"
    }
  ]
}

简洁格式

ai-skills ls --format simple

react-best-practices - React and Next.js performance optimization
code-review - Code review guidelines

系统要求

Node.js: >= 16.0.0
npm/pnpm/yarn: >= 7.0.0 / >= 6.0.0 / >= 1.22.0
Git: 用于从 Git 仓库安装技能

文档

完整文档请查看 docs 目录：

使用指南 ⭐ - 完整使用文档，包含所有命令详解、使用场景、最佳实践和故障排除
架构分析 - 项目架构和设计分析
格式规范 - Skill 格式规范
标准参考 - Agent Skills 标准参考
设计理念 - 架构设计说明

支持的工具

Cursor - Cursor IDE
Claude Desktop - Claude Desktop
Visual Studio Code - VS Code
Codex - Codex
Antigravity - Antigravity

开发

# 克隆仓库
git clone https://github.com/levai/ai-skills-cli.git
cd ai-skills-cli

# 安装依赖
npm install

# 构建
npm run build

# 运行测试
npm test

# 运行 E2E 测试
npm run test:e2e

# 查看测试覆盖率
npm run test:coverage

贡献

欢迎贡献！请查看 CONTRIBUTING.md 了解详细信息。

License

MIT