技能管理器

> 智能技能发现与管理 - 让AI助手找到并使用最合适的技能

快速使用

命令行使用

智能体触发方式

密钥安全（发布前强制校验）

publish、publish-all 会在上传前自动扫描技能目录，发现硬编码凭证即中止发布。

检测规则覆盖：

命中后输出已打码的片段（只保留前 4 位与后 2 位），不会二次泄漏：

$ python skill_manager.py scan-secrets --path ../my-push-plus

============================================================
  密钥泄漏扫描：my-push-plus
============================================================

✗ 发现 4 处疑似硬编码凭证：

  1. [硬编码凭证赋值] SKILL.md:34
     PUSH********7"
  ...

✗ 错误：共发现 4 处疑似密钥泄漏

正确的凭证处理方式（三选一）：

1. 环境变量：token = os.environ.get("PUSHPLUS_TOKEN")
2. 首次使用时交互输入，保存到 ~/.<skill>_token.json
3. 文档中只留占位符：TOKEN = "your-token-here"

确属误报时可加 --allow-secrets 强制发布（不推荐）。

批量发布

# 预检全部（不上传）
python skill_manager.py publish-all --dry-run

# 批量发布并自动递增修订号
python skill_manager.py publish-all --bump patch --changelog "文档优化与缺陷修复"

流程：逐个技能 → 校验 slug/version/displayName → 密钥扫描 → 版本号递增 → 上传。
任一技能缺字段或含凭证会被跳过，其余继续，最后汇总成功/失败/跳过清单。

实际运行示例

示例1：搜索技能

$ python skill_manager.py search --keyword "壁纸"

  正在搜索 skillhub.cn: 壁纸
  找到 26 个相关技能

============================================================
  搜索 '壁纸' 的结果
============================================================

  ○ 1. 电脑壁纸 必应壁纸 一键切换 定时切换 [在线]
     壁纸切换工具 - 一键切换必应每日壁纸、随机壁纸、动漫壁纸、风景壁纸...
     v1.0.1 | user_5d10d7f7 | design-media
     下载: 30 · 评分: 20067

  ○ 2. ai-wallpaper-skill [在线]
     一个能够根据用户提示词生成 AI 图片并自动将其设置为桌面壁纸的能力模块...
     v1.0.1 | user_60def63c | design-media
     下载: 139 · 评分: 10311

  ...

============================================================
  共 26 个技能
============================================================

示例2：列出本地技能

$ python skill_manager.py list

============================================================
  本地已安装技能
============================================================

  ✓ 1. create-your-skill [本地]
     创建新技能、修改和改进现有技能，并衡量技能性能...
     v1.0.0

  ✓ 2. skills-loader [本地]
     智能技能管理器 - 自动检测本地技能、从skillhub.cn发现新技能...
     v2.1.0

============================================================
  共 6 个技能
============================================================

示例3：检查更新（v2.1 带版本比较）

$ python skill_manager.py check-update

  正在检查本地技能...

  检查: create-your-skill（本地 v1.0.0）
  ✓ create-your-skill 可更新: v1.0.0 → v1.0.1

  检查: skills-loader（本地 v2.1.0）
    skills-loader 已是最新（本地 v2.1.0 >= 线上 v1.0.5）

  检查: wallpaper-switcher（本地 v1.1.0）
    wallpaper-switcher 已是最新（本地 v1.1.0 >= 线上 v1.0.2）

  共发现 1 个可更新的技能（2 个已是最新）

──────────────────────────────────────────────────
  可更新的技能
──────────────────────────────────────────────────

  [1] create-your-skill  (v1.0.0 → v1.0.1)
      创建新技能、修改和改进现有技能，并衡量技能性能...
      下载 0 · 评分 0

──────────────────────────────────────────────────
  更新单个: python skill_manager.py update --keyword <技能名>
  更新全部: python skill_manager.py update-all
──────────────────────────────────────────────────

示例4：查看 CLI 状态与登录身份

$ python skill_manager.py cli-status

============================================================
  SkillHub CLI 状态
============================================================

✓ CLI 可用
  类型: Python 版 (官方)
  路径: C:\Users\g1587\.skillhub\skills_store_cli.py
  版本: skillhub 2026.6.22
  登录状态: 已登录

$ python skill_manager.py whoami

userId : 551907
handle : user_5d10d7f7
role   : user

示例5：发布技能到 skillhub.cn

# 第一步：登录（Token 在 skillhub.cn 个人中心获取）
$ python skill_manager.py login --token skh_xxx
✓ 登录成功!

# 第二步：发布预检（不上传，校验 SKILL.md 字段）
$ python skill_manager.py publish --path ./fund-analyzer-plus --dry-run
  预检: g:\代码\pycharm\ai\skills\fund-analyzer-plus
✓ 预检成功!
  Dry-run passed. 3 files, 128 KB

# 第三步：正式发布（version 会自动递增校验）
$ python skill_manager.py publish --path ./fund-analyzer-plus --changelog "修复净值API失效，新增股票分析"
  发布: g:\代码\pycharm\ai\skills\fund-analyzer-plus
✓ 发布成功!
  Published fund-analyzer-plus v1.1.0

发布前提：SKILL.md 需包含以下字段

---
name: "my-skill"
slug: "my-skill"          # 必填，与线上技能对应，目录名保持一致
version: "1.1.0"           # 必填，需大于线上版本
displayName: "技能显示名"   # 必填
summary: "一句话简介"        # 建议
description: "触发条件描述"
---

常见问题

网络问题

安装问题

登录与发布问题

使用建议

1. 首次使用：先运行 list 查看本地已安装的技能
2. 搜索技能：使用 search --keyword "关键词" 查找
3. 安装技能：找到技能后使用 install --keyword "技能名" 安装
4. 检查更新：定期运行 check-update 查看是否有更新
5. 批量更新：使用 update-all 一键更新所有本地技能
6. 发布技能：login → doctor 体检 → publish --dry-run 预检 → publish --bump patch 正式发布
7. 批量发布：publish-all --bump patch --changelog "..."
8. 发布前必做：密钥写进环境变量或配置文件，绝不写进 SKILL.md / 脚本

安装流程

1. 检查是否已安装 SkillHub CLI
   ↓
2. 未安装 → 自动执行安装脚本
   已安装 → 跳过
   ↓
3. 执行 skillhub install <skill-name>
   ↓
4. 安装完成

发布流程

1. cli-status 确认 CLI 可用（auth/publish 需 Python 版）
   ↓
2. login --token skh_xxx 登录（凭据保存到 ~/.skillhub/）
   ↓
3. publish --path <技能目录> --dry-run 预检
   ├─ 失败 → 按提示补齐 slug/version/displayName
   ↓
4. publish --path <技能目录> --changelog "更新说明" 正式发布
   ↓
5. 到 skillhub.cn 查看已发布技能

双 CLI 说明

程序自动检测并屏蔽两者差异，无需手动选择。

注意事项

1. 需要网络连接访问 SkillHub API 和下载技能
2. 安装技能需要执行 curl 命令，请确保有网络权限
3. 技能安装到当前 Agent 的 skills 目录
4. 更新技能会覆盖本地版本
5. 网络不好时可能需要多次重试
6. 发布技能前务必确认 slug 与线上已发布技能一致、目录名与 slug 相同
7. Token 等敏感信息不要写入 SKILL.md 或代码，登录后凭据存于本地 ~/.skillhub/
8. 遇到问题请先查看上方「常见问题」表格