John Qiu
712063071c
skills/ → skills-dev(9), skills-req(10), skills-ops(4), skills-integration(8), skills-biz(4), skills-workflow(7) generate-marketplace.py 改为自动扫描所有 skills-* 目录。 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
316 lines
6.9 KiB
Markdown
316 lines
6.9 KiB
Markdown
---
|
||
name: skill-manager
|
||
description: 自我进化 Skills 管理器。通过自然语言安装、升级、卸载、回滚技能。
|
||
---
|
||
|
||
# Skill Manager - 技能管理器
|
||
|
||
基于 Git 的 Claude Code 技能管理系统，支持自然语言操作。
|
||
|
||
---
|
||
|
||
## 命令列表
|
||
|
||
| 命令 | 功能 | 示例 |
|
||
|------|------|------|
|
||
| `/skill list` | 列出已安装技能 | `/skill list` |
|
||
| `/skill install <repo>` | 安装新技能 | `/skill install https://github.com/org/skill-name` |
|
||
| `/skill upgrade [name]` | 升级技能 | `/skill upgrade coolbuy-paas` |
|
||
| `/skill uninstall <name>` | 卸载技能 | `/skill uninstall dev-test` |
|
||
| `/skill rollback <name> <ver>` | 回滚版本 | `/skill rollback coolbuy-paas v1.1.0` |
|
||
| `/skill info <name>` | 查看技能详情 | `/skill info coolbuy-paas` |
|
||
| `/skill enable <name>` | 启用技能 | `/skill enable ops-tools` |
|
||
| `/skill disable <name>` | 禁用技能 | `/skill disable ops-tools` |
|
||
| `/skill check` | 检查更新 | `/skill check` |
|
||
|
||
---
|
||
|
||
## 自然语言支持
|
||
|
||
支持中英文自然语言指令：
|
||
|
||
| 自然语言 | 解析为 |
|
||
|----------|--------|
|
||
| "升级 coolbuy-paas" | `/skill upgrade coolbuy-paas` |
|
||
| "更新所有技能" | `/skill upgrade` |
|
||
| "安装技能 https://..." | `/skill install https://...` |
|
||
| "卸载 dev-test 技能" | `/skill uninstall dev-test` |
|
||
| "列出所有技能" | `/skill list` |
|
||
| "回滚到 v1.1.0" | `/skill rollback <name> v1.1.0` |
|
||
| "xxx 是什么版本" | `/skill info xxx` |
|
||
|
||
---
|
||
|
||
## 命令处理指南
|
||
|
||
### `/skill list`
|
||
|
||
**列出所有已安装技能**
|
||
|
||
执行步骤：
|
||
1. 读取 `~/.claude/skills/registry.yaml`
|
||
2. 遍历所有技能目录
|
||
3. 读取每个技能的 `skill.yaml` 获取版本信息
|
||
4. 按名称排序显示
|
||
|
||
输出格式：
|
||
```
|
||
已安装技能 (N个):
|
||
|
||
| 名称 | 版本 | 状态 | 最后更新 |
|
||
|------|------|------|----------|
|
||
| skill-name | v1.0.0 | active | 2026-01-20 |
|
||
```
|
||
|
||
---
|
||
|
||
### `/skill install <repo>`
|
||
|
||
**从 Git 仓库安装新技能**
|
||
|
||
执行步骤：
|
||
1. 验证仓库地址格式（HTTPS 或 SSH）
|
||
2. 从 URL 提取技能名称
|
||
3. 检查是否已安装（如已安装，提示使用 upgrade）
|
||
4. 执行 `git clone` 到 `~/.claude/skills/repos/<name>/`
|
||
5. 验证 `skill.yaml` 存在且格式正确
|
||
6. 检查并安装依赖技能
|
||
7. 更新 `registry.yaml`
|
||
8. 创建符号链接或复制到 `~/.claude/skills/<name>/`
|
||
9. 执行 `post_install` 钩子
|
||
10. 显示安装结果
|
||
|
||
示例：
|
||
```bash
|
||
# HTTPS
|
||
/skill install https://github.com/org/skill-coolbuy-paas.git
|
||
|
||
# SSH
|
||
/skill install git@github.com:org/skill-coolbuy-paas.git
|
||
```
|
||
|
||
---
|
||
|
||
### `/skill upgrade [name]`
|
||
|
||
**升级指定技能或全部技能**
|
||
|
||
执行步骤：
|
||
1. 如果指定 name，升级单个技能；否则升级全部
|
||
2. 读取 `registry.yaml` 获取仓库路径
|
||
3. 进入仓库目录执行 `git fetch origin`
|
||
4. 比较本地和远程版本
|
||
5. 如有更新：
|
||
- 执行 `git pull origin main`
|
||
- 读取新版本号
|
||
- 更新 `registry.yaml`
|
||
- 执行 `post_update` 钩子
|
||
- 同步文件到 `~/.claude/skills/<name>/`
|
||
6. 显示更新结果
|
||
|
||
---
|
||
|
||
### `/skill uninstall <name>`
|
||
|
||
**卸载已安装的技能**
|
||
|
||
执行步骤：
|
||
1. 验证技能存在
|
||
2. 检查是否有其他技能依赖此技能
|
||
3. 如有依赖，显示警告并询问确认
|
||
4. 执行 `post_uninstall` 钩子
|
||
5. 删除仓库目录 `~/.claude/skills/repos/<name>/`
|
||
6. 删除技能目录 `~/.claude/skills/<name>/`
|
||
7. 从 `registry.yaml` 移除记录
|
||
8. 显示卸载结果
|
||
|
||
---
|
||
|
||
### `/skill rollback <name> <version>`
|
||
|
||
**回滚技能到指定版本**
|
||
|
||
执行步骤：
|
||
1. 验证技能存在
|
||
2. 进入仓库目录
|
||
3. 验证目标版本存在（`git tag` 或 commit hash）
|
||
4. 显示版本差异和警告
|
||
5. 询问用户确认
|
||
6. 执行 `git checkout <version>`
|
||
7. 更新 `registry.yaml` 中的版本号
|
||
8. 同步文件
|
||
9. 执行 `post_update` 钩子
|
||
10. 显示回滚结果
|
||
|
||
---
|
||
|
||
### `/skill info <name>`
|
||
|
||
**查看技能详细信息**
|
||
|
||
执行步骤：
|
||
1. 读取 `skill.yaml`
|
||
2. 读取 git 仓库信息（当前分支、最新 commit）
|
||
3. 显示详细信息
|
||
|
||
输出格式：
|
||
```
|
||
技能: coolbuy-paas
|
||
版本: v1.2.0
|
||
描述: 酷采3.0 SaaS 租户端开发与测试
|
||
作者: your-team
|
||
状态: active
|
||
|
||
仓库: git@github.com:org/skill-coolbuy-paas.git
|
||
分支: main
|
||
Commit: abc1234 (2026-01-20)
|
||
|
||
依赖:
|
||
- dev-coding
|
||
- ops-tools
|
||
|
||
触发关键词:
|
||
- coolbuy-paas
|
||
- 酷采
|
||
- 商品管理
|
||
```
|
||
|
||
---
|
||
|
||
### `/skill check`
|
||
|
||
**检查所有技能是否有更新**
|
||
|
||
执行步骤：
|
||
1. 遍历所有已安装技能
|
||
2. 对每个技能执行 `git fetch origin`
|
||
3. 比较本地和远程 HEAD
|
||
4. 显示有更新的技能列表
|
||
|
||
输出格式：
|
||
```
|
||
检查技能更新...
|
||
|
||
有更新的技能 (2个):
|
||
- coolbuy-paas: v1.1.0 → v1.2.0
|
||
- req: v4.4.0 → v4.5.0
|
||
|
||
执行 `/skill upgrade` 升级所有技能
|
||
```
|
||
|
||
---
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
~/.claude/
|
||
├── skills/
|
||
│ ├── registry.yaml # 技能注册表
|
||
│ ├── repos/ # Git 仓库存储目录
|
||
│ │ ├── coolbuy-paas/
|
||
│ │ │ ├── .git/
|
||
│ │ │ ├── skill.yaml
|
||
│ │ │ └── SKILL.md
|
||
│ │ └── ...
|
||
│ ├── coolbuy-paas/ # 技能目录（符号链接或复制）
|
||
│ │ └── SKILL.md
|
||
│ ├── skill-manager/ # 本技能
|
||
│ │ ├── skill.yaml
|
||
│ │ ├── SKILL.md
|
||
│ │ └── scripts/
|
||
│ └── ...
|
||
└── settings.json
|
||
```
|
||
|
||
---
|
||
|
||
## Registry 结构
|
||
|
||
`~/.claude/skills/registry.yaml`:
|
||
|
||
```yaml
|
||
version: 1
|
||
updated_at: 2026-01-26T12:00:00Z
|
||
|
||
config:
|
||
auto_update_check: true
|
||
default_branch: main
|
||
|
||
skills:
|
||
coolbuy-paas:
|
||
repo: git@github.com:org/skill-coolbuy-paas.git
|
||
local_path: ~/.claude/skills/repos/coolbuy-paas
|
||
version: 1.2.0
|
||
installed_at: 2026-01-15T10:00:00Z
|
||
last_updated: 2026-01-20T10:30:00Z
|
||
status: active
|
||
```
|
||
|
||
---
|
||
|
||
## skill.yaml 规范
|
||
|
||
```yaml
|
||
# 必填
|
||
name: skill-name # hyphen-case, ≤64字符
|
||
version: 1.0.0 # 语义化版本
|
||
description: 技能描述 # ≤1024字符
|
||
|
||
# 可选
|
||
author: author-name
|
||
license: MIT
|
||
|
||
triggers:
|
||
keywords: [关键词列表]
|
||
commands: [/command]
|
||
file_patterns: ["**/pattern/**"]
|
||
|
||
prompt_file: SKILL.md
|
||
|
||
dependencies:
|
||
- other-skill
|
||
|
||
mcp_servers:
|
||
- server-name
|
||
|
||
hooks:
|
||
post_install: [命令列表]
|
||
post_update: [命令列表]
|
||
post_uninstall: [命令列表]
|
||
|
||
allowed_tools:
|
||
- Bash
|
||
- Read
|
||
|
||
metadata:
|
||
category: category
|
||
tags: [tag1, tag2]
|
||
```
|
||
|
||
---
|
||
|
||
## 脚本工具
|
||
|
||
### scripts/validate.sh
|
||
|
||
验证 skill.yaml 格式：
|
||
```bash
|
||
~/.claude/skills/skill-manager/scripts/validate.sh <skill-directory>
|
||
```
|
||
|
||
### scripts/sync.sh
|
||
|
||
同步技能文件：
|
||
```bash
|
||
~/.claude/skills/skill-manager/scripts/sync.sh <skill-name>
|
||
```
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
1. **私有仓库**: 需要配置 SSH key 或 Personal Access Token
|
||
2. **依赖循环**: 安装前会检测循环依赖
|
||
3. **版本兼容**: 支持语义化版本和 Git commit hash
|
||
4. **钩子安全**: 钩子脚本在执行前会显示内容供用户确认
|