{"_id":"@aithe/skills-cli","_rev":"3-e84771d6b15f69656e690efdba11cf9c","name":"@aithe/skills-cli","dist-tags":{"latest":"1.0.0"},"versions":{"0.1.0-beta":{"name":"@aithe/skills-cli","version":"0.1.0-beta","keywords":["cli","skills","ai-agent"],"license":"MIT","_id":"@aithe/skills-cli@0.1.0-beta","maintainers":[{"name":"duanyunyong","email":"szduanyy@189.cn"},{"name":"hiu_yan_chong","email":"sysu_se_zxx@163.com"}],"bin":{"sk":"bin/sk.js"},"dist":{"shasum":"1b4a3cd0c3eaaf5ade9a6cef349b5a05e9a23ac8","tarball":"https://registry.npmjs.org/@aithe/skills-cli/-/skills-cli-0.1.0-beta.tgz","fileCount":5,"integrity":"sha512-V3vMV8rY+dMBOYv0V8cZXSo8ugS9id8gwky3+J7UORKNwfu2kc2itOq2U6ZnLlaXBgCpNN6i+4sjLtENq2XBuQ==","signatures":[{"sig":"MEQCIG0wgY8Fy1tk+avf2P/MnLBi0HefkTKy6zT00KjfP5PNAiBOTAXyDh+MAbn0XVnq1VRMjIQBBnD/YMYpgF+Hh2O8hA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":74495},"main":"src/index.js","engines":{"node":">=18.0.0"},"gitHead":"edf1062b178d24f583a8c7f0e0872b96e156199c","scripts":{"test":"node --test test/sk.test.js","start":"node bin/sk.js"},"_npmUser":{"name":"hiu_yan_chong","email":"sysu_se_zxx@163.com"},"_npmVersion":"10.9.4","description":"AI Agent 技能管理工具 - 创建、上传、安装和分发技能，基于 Git 仓库存储分发技能（支持研发云）","directories":{},"_nodeVersion":"22.21.1","dependencies":{"yaml":"^2.3.0","axios":"^1.6.0","commander":"^11.0.0","simple-git":"^3.22.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/skills-cli_0.1.0-beta_1780025319907_0.6921322861060937","host":"s3://npm-registry-packages-npm-production"}},"0.1.1-beta":{"name":"@aithe/skills-cli","version":"0.1.1-beta","keywords":["cli","skills","ai-agent"],"license":"MIT","_id":"@aithe/skills-cli@0.1.1-beta","maintainers":[{"name":"duanyunyong","email":"szduanyy@189.cn"},{"name":"hiu_yan_chong","email":"sysu_se_zxx@163.com"}],"bin":{"sk":"bin/sk.js"},"dist":{"shasum":"a5978df207c6555d32730becf15978fb724862d1","tarball":"https://registry.npmjs.org/@aithe/skills-cli/-/skills-cli-0.1.1-beta.tgz","fileCount":5,"integrity":"sha512-xNWAyKpsasGPYaqLkEQGShYRqy02PGy2uDqSf4fcjjS7q00DA3M1/SUZbCFBk6Q0yy5eRsfksB19zifHexitnw==","signatures":[{"sig":"MEUCIQCbnexn5WkPWQURZXH1rhxlvLcFQVDGFdBAGG3t6oNCNwIgUoAXmjYs6xzdYP+HRfd1xscquKFIoBGC9dB1SSfpcgo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":73947},"main":"src/index.js","engines":{"node":">=18.0.0"},"gitHead":"edf1062b178d24f583a8c7f0e0872b96e156199c","scripts":{"test":"node --test test/sk.test.js","start":"node bin/sk.js"},"_npmUser":{"name":"hiu_yan_chong","email":"sysu_se_zxx@163.com"},"_npmVersion":"10.9.4","description":"AI Agent 技能管理工具 - 创建、上传、安装和分发技能，基于 Git 仓库存储分发技能（支持研发云）","directories":{},"_nodeVersion":"22.21.1","dependencies":{"yaml":"^2.3.0","axios":"^1.6.0","commander":"^11.0.0","simple-git":"^3.22.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/skills-cli_0.1.1-beta_1780040925360_0.2616299526652808","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@aithe/skills-cli","version":"1.0.0","description":"AI Agent 技能管理工具 - 创建、上传、安装和分发技能，基于 Git 仓库存储分发技能（支持研发云）","main":"src/index.js","bin":{"sk":"bin/sk.js"},"scripts":{"test":"node --test test/sk.test.js","start":"node bin/sk.js"},"keywords":["cli","skills","ai-agent"],"license":"MIT","dependencies":{"commander":"^11.0.0","axios":"^1.6.0","simple-git":"^3.22.0","yaml":"^2.3.0"},"engines":{"node":">=18.0.0"},"_id":"@aithe/skills-cli@1.0.0","gitHead":"e11e97f861ecca0f5055c81f176014c325e5100a","_nodeVersion":"22.21.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-dnLEt6QKN2038BNSEDDekcDgIZDVbvvuR8raEHlvhsq0Jv11WSC8Whox3Np/q9Vl2cpfWMAXqRfFi7FKYzXsGQ==","shasum":"02a457ed076de2e9542786118cd062e53377da1e","tarball":"https://registry.npmjs.org/@aithe/skills-cli/-/skills-cli-1.0.0.tgz","fileCount":5,"unpackedSize":76090,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDw3IawZuEzqtbx7RZTvbY3Zv3gLbP+4/3RiLic/mmzfgIgS7eOBiOzHz9aYSguKGqtM1sDMXWmDlhk+JJLSC+U5iE="}]},"_npmUser":{"name":"hiu_yan_chong","email":"sysu_se_zxx@163.com"},"directories":{},"maintainers":[{"name":"duanyunyong","email":"szduanyy@189.cn"},{"name":"hiu_yan_chong","email":"sysu_se_zxx@163.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/skills-cli_1.0.0_1780044191186_0.9691859461007368"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-29T03:28:39.732Z","modified":"2026-05-29T08:43:11.465Z","0.1.0-beta":"2026-05-29T03:28:40.044Z","0.1.1-beta":"2026-05-29T07:48:45.506Z","1.0.0":"2026-05-29T08:43:11.338Z"},"license":"MIT","keywords":["cli","skills","ai-agent"],"description":"AI Agent 技能管理工具 - 创建、上传、安装和分发技能，基于 Git 仓库存储分发技能（支持研发云）","maintainers":[{"name":"duanyunyong","email":"szduanyy@189.cn"},{"name":"hiu_yan_chong","email":"sysu_se_zxx@163.com"}],"readme":"# @aithe/skills-cli\n\nAI Agent 技能管理工具 - 创建、上传、安装和分发技能，基于 Git 仓库存储分发技能（支持研发云）。\n\n---\n\n## 一、快速开始\n\n### 1.1 安装验证\n\n```bash\n# 方式一：npm 安装（推荐）\nnpm install -g @aithe/skills-cli\n\n# 方式二：指定版本安装\nnpm install -g @aithe/skills-cli@1.0.0\n\n# 验证安装是否成功。如果报找不到 sk 命令，尝试下常见问题1的方案\nsk --version\n\n# 帮助命令\nsk --help          # 查看主命令帮助\nsk -h              # 同上（短参数）\nsk install --help  # 查看 install 命令帮助\nsk install -h      # 同上\n```\n\n### 1.2 常用指令组合\n\n完整开发流程：\n\n```bash\n# 1. 开发技能\nsk init my-skill          # 初始化技能\n# 编辑 .skills/my-skill/SKILL.md\nsk validate               # 验证技能格式\n\n# 2. 在 my-skill 目录下发布技能到远程仓库\nsk publish git@github.com:your-name/your-skills-repo.git\n\n# 3. 其他人添加市场并安装\nsk market add git@github.com:your-name/your-skills-repo.git  # 添加市场\nsk search my-skill        # 搜索技能\nsk install my-skill       # 安装技能\n\n# 4. 升级技能\nsk update                 # 更新所有技能\nsk update my-skill        # 更新指定技能\n```\n\n指定目录示例：\n\n```bash\n# 发布指定目录下的技能\nsk publish git@github.com:user/repo.git --dir ./my-skills\n\n# 安装仓库中所有技能到指定目录\nsk install git@github.com:user/repo.git --target ~/my-skills\n\n# 从市场安装指定技能到指定目录\nsk install skill-name --target ~/my-skills\n\n# 安装指定仓库的指定技能到指定目录\nsk install git@github.com:user/repo.git --skill skill-name --target ./custom-dir\n```\n\n---\n\n## 二、指令总结\n\n| 分类 | 命令 | 说明 |\n|------|------|------|\n| **开发** | `sk init <name>` | 初始化新技能 |\n| | `sk validate [path]` | 验证技能格式 |\n| **发布** | `sk publish <repo-url>` | 发布技能到远程仓库 |\n| | `sk publish <repo-url> --dir <dir>` | 发布指定目录的技能 |\n| | `sk publish <repo-url> --dir <dir> --name <name>` | 组合发布多个 skill |\n| **安装** | `sk install <skill\\|repo>` | 安装技能 |\n| | `sk update [skill-name]` | 更新技能 |\n| | `sk uninstall <skill-name>` | 卸载技能 |\n| | `sk list` | 列出已安装的技能 |\n| **锁定** | `sk pin <skill-name> [version]` | 锁定技能版本 |\n| **市场** | `sk market add <source>` | 添加市场 |\n| | `sk market list` | 列出市场 |\n| | `sk market enable <name>` | 启用市场 |\n| | `sk market disable <name>` | 禁用市场 |\n| | `sk market remove <name>` | 移除市场 |\n| **搜索** | `sk search [query]` | 搜索技能 |\n| **配置** | `sk config list` | 查看配置 |\n| | `sk config get <key>` | 获取配置值 |\n| | `sk config set <key> <value>` | 设置配置值 |\n| | `sk config reset` | 重置配置 |\n| **诊断** | `sk doctor` | 诊断系统状态 |\n\n---\n\n## 三、指令详解\n\n### 3.1 技能开发\n\n#### 3.1.1 `sk init <name>`\n\n在当前目录初始化一个新技能。\n\n```bash\n# 在当前目录创建技能\nsk init code-reviewer\n\n# 在指定目录创建技能\nsk init code-reviewer --dir /path/to/dir\n```\n\n#### 3.1.2 `sk validate [path]`\n\n验证技能格式是否正确。\n\n```bash\n# 验证本地技能\nsk validate ./my-skill\n\n# 验证远程仓库中的技能\nsk validate https://github.com/user/repo.git --skill skill-name\n```\n\n### 3.2 技能发布\n\n#### 3.2.1 `sk publish <repo-url>`\n\n发布技能到远程仓库，自动更新 marketplace.json。\n\n```bash\n# 在当前目录推送\nsk publish git@github.com:user/my-skills.git\n\n# 指定自定义目录\nsk publish git@github.com:user/my-skills.git --dir ./my-skills\n\n# 组合发布：将目录下多个 skill 打包为一个 plugin\n# 目录结构: ./test-combo/test1/SKILL.md, ./test-combo/test2/SKILL.md\nsk publish git@github.com:user/my-skills.git --dir ./test-combo --name test-combo\n# 生成: { \"name\": \"test-combo\", \"skills\": [\"test-combo/test1\", \"test-combo/test2\"] }\n\n# 指定技能来源仓库（仅记录，不实际使用）\nsk publish git@github.com:user/my-skills.git --source https://github.com/user/other-repo.git\n\n# 指定远程仓库中 marketplace.json 所在目录\nsk publish git@github.com:user/my-skills.git --marketplace-dir .claude-plugin\n```\n\n### 3.3 技能安装\n\n#### 3.3.1 `sk install [<skill-name>|<repo-url>]`\n\n从远程仓库或已配置的市场安装技能。\n\n```bash\n# 从已配置的市场安装技能（自动搜索所有市场）\nsk install helloworld\n\n# 使用 skill@marketplace 格式从指定市场安装\nsk install document-skills@anthropic-agent-skills\n\n# 从远程仓库安装所有技能\nsk install git@github.com:user/skills-repo.git\n\n# 从远程仓库安装指定技能\nsk install git@github.com:user/skills-repo.git --skill my-skill\n\n# 安装特定版本\nsk install git@github.com:user/skills-repo.git --version v1.0.0\n\n# 安装到指定目录\nsk install git@github.com:user/skills-repo.git --target ~/my-skills\n```\n\n**参数说明：**\n- 第一个参数可以是技能名称、skill@marketplace 格式或仓库地址\n- 如果参数包含 `://` 或以 `git@` 开头，则视为仓库地址\n- 如果包含 `@`（如 `skill@marketplace`），从指定市场安装\n- 否则视为技能名称，从所有已配置的 marketplaces 中搜索安装\n- 支持的 marketplace 格式：`.skills-market/`, `.claude-plugin/`, 根目录\n- 支持的 source 格式：字符串(`\"./\"`)、对象(`{url/ref}`)、Anthropic(`{github:{repo/ref}}`)\n\n#### 3.3.2 `sk update [skill-name]`\n\n检查并更新已安装的技能到最新版本。如果没有可用更新，则跳过该技能。\n\n```bash\n# 更新所有技能（有更新才更新，没更新跳过）\nsk update\n\n# 更新指定技能\nsk update my-skill\n\n# 强制更新（忽略锁定）\nsk update --force\n```\n\n#### 3.3.3 `sk uninstall <skill-name>`\n\n卸载技能。\n\n```bash\nsk uninstall my-skill\n```\n\n#### 3.3.4 `sk list`\n\n列出已安装的技能。\n\n```bash\nsk list\n```\n\n### 3.4 技能管理\n\n#### 3.4.1 `sk pin <skill-name> [version]`\n\n锁定技能版本。\n\n```bash\n# 锁定到当前版本\nsk pin my-skill\n\n# 锁定到指定版本\nsk pin my-skill v1.0.0\n\n# 解除锁定\nsk pin my-skill --unpin\n```\n\n### 3.5 市场管理\n\n#### 3.5.1 `sk market add <source>`\n\n添加技能市场。支持两种 marketplace 目录格式：\n- `.skills-market/marketplace.json` (sk 格式)\n- `.claude-plugin/marketplace.json` (Anthropic Claude 格式)\n\n```bash\n# 添加自定义市场\nsk market add git@github.com:user/marketplace.git\n\n# 添加 Anthropic 官方技能市场\nsk market add https://github.com/anthropics/skills\n```\n\n#### 3.5.2 `sk market list`\n\n列出已添加的市场。\n\n```bash\nsk market list\n```\n\n#### 3.5.3 `sk market enable <name>`\n\n启用市场。\n\n```bash\nsk market enable marketplace-name\n```\n\n#### 3.5.4 `sk market disable <name>`\n\n禁用市场。禁用后搜索和安装将跳过该市场。\n\n```bash\nsk market disable marketplace-name\n```\n\n#### 3.5.5 `sk market remove <name>`\n\n移除市场。\n\n```bash\nsk market remove marketplace-name\n```\n\n### 3.6 搜索\n\n#### 3.6.1 `sk search [query]`\n\n在市场中搜索技能。\n\n```bash\n# 搜索技能\nsk search \"代码生成\"\n\n# 按标签搜索\nsk search --tag 开发\n\n# 在指定市场搜索\nsk search --marketplace my-market skill-name\n```\n\n### 3.7 配置管理\n\n#### 3.7.1 `sk config list`\n\n查看所有配置。\n\n```bash\nsk config list\n```\n\n#### 3.7.2 `sk config get <key>`\n\n获取配置值。\n\n```bash\nsk config get skills.downloadSkillDir\nsk config get network.timeout\n```\n\n#### 3.7.3 `sk config set <key> <value>`\n\n设置配置值。\n\n```bash\nsk config set skills.downloadSkillDir \"/path/to/skills\"\nsk config set network.timeout 60\nsk config set autoUpdate.enabled false\n```\n\n#### 3.7.4 `sk config reset`\n\n重置为默认配置。\n\n```bash\nsk config reset\n```\n\n### 3.8 诊断\n\n#### 3.8.1 `sk doctor`\n\n诊断技能系统状态。\n\n```bash\nsk doctor\n```\n\n---\n\n## 四、常见问题\n\n### Q1: 安装后找不到 sk 命令？\n\n如果安装后找不到 `sk` 命令，可能需要将 npm 全局 bin 目录添加到 PATH：\n\n#### Windows (PowerShell)\n\n```powershell\n# 查看 npm 全局路径\nnpm config get prefix\n\n# 假设输出 C:\\Users\\你的用户名\\AppData\\Roaming\\npm\n# 将以下路径添加到 PATH：\n# C:\\Users\\你的用户名\\AppData\\Roaming\\npm\n\n# 临时生效（当前终端有效）\n$env:PATH = \"$env:PATH;C:\\Users\\你的用户名\\AppData\\Roaming\\npm\"\n\n# 永久生效（系统属性 -> 高级 -> 环境变量 -> 用户变量 -> Path）\n```\n\n#### Windows (CMD / Git Bash)\n\n```cmd\nREM 查看 npm 全局路径\nnpm config get prefix\n\nREM 添加到 PATH（假设输出 C:\\Users\\xxx\\AppData\\Roaming\\npm）\nsetx PATH \"%PATH%;C:\\Users\\你的用户名\\AppData\\Roaming\\npm\"\n```\n\n#### macOS / Linux (bash)\n\n```bash\n# 查看 npm 全局路径\nnpm config get prefix\n\n# 添加到 PATH\necho 'export PATH=\"$PATH:$(npm config get prefix)/bin\"' >> ~/.bashrc\nsource ~/.bashrc\n\n# 或 zsh\necho 'export PATH=\"$PATH:$(npm config get prefix)/bin\"' >> ~/.zshrc\nsource ~/.zshrc\n```\n\n### Q2: 如何修改技能安装默认目录？\n\n```bash\nsk config set skills.downloadSkillDir \"~/my-custom-path\"\n```\n\n### Q3: 如何使用内部 Git 仓库？\n\n```bash\nsk install git@git.internal.com:user/repo.git\n```\n\n### Q4: 如何查看已安装的技能？\n\n```bash\nsk list\n```\n\n### Q5: 如何更新所有技能？\n\n```bash\nsk update\n```\n\n","readmeFilename":"README.md"}