pipexerp/ai-proj-helper
6
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity
Files
712063071cff0fcf0aba517bc5a384c69d5e098e
ai-proj-helper/skills-workflow/skill-manager-plugin/skills/SKILL.md
John Qiu 712063071c refactor: 通用技能按类别拆分为独立目录 
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>
2026-03-14 11:31:58 +10:30

6.9 KiB
Raw Blame History

name, description
name description
skill-manager 自我进化 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. 显示安装结果

示例：

# 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:

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 规范

# 必填
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 格式：

~/.claude/skills/skill-manager/scripts/validate.sh <skill-directory>

scripts/sync.sh

同步技能文件：

~/.claude/skills/skill-manager/scripts/sync.sh <skill-name>

注意事项

  1. 私有仓库: 需要配置 SSH key 或 Personal Access Token
  2. 依赖循环: 安装前会检测循环依赖
  3. 版本兼容: 支持语义化版本和 Git commit hash
  4. 钩子安全: 钩子脚本在执行前会显示内容供用户确认
Reference in New Issue View Git Blame Copy Permalink