pipexerp/ai-proj-helper
6
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity

refactor: 通用技能按类别拆分为独立目录

Browse Source 
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>
This commit is contained in:
John Qiu
2026-03-14 11:31:58 +10:30
parent ea266e9cce
commit 712063071c
170 changed files with 341 additions and 346 deletions
Download Patch File Download Diff File Expand all files Collapse all files

315
skills-workflow/skill-manager-plugin/skills/SKILL.md Normal file
View File

@@ -0,0 +1,315 @@
---
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. **钩子安全**: 钩子脚本在执行前会显示内容供用户确认