Skill Manager

Skill Manager | 技能管理器

专门用于管理 Claude Code skills 的元工具。

核心功能

目录结构

~/my-claude-skills/               # Git 仓库（单一数据源）
├── skill-name/                   # 每个 skill 目录
│   ├── SKILL.md
│   ├── references/
│   ├── scripts/
│   └── assets/
├── packages/                     # 大包/技能集目录
│   └── package-name/
│       └── README.md
├── registry.json                 # 技能注册表（分类/状态/安装日期）
├── docs/                         # 管理文档
└── README.md

~/.claude/skills/                 # Claude 加载目录（全部为 Junction）
└── skill-name -> my-claude-skills/skill-name  # Windows Junction

D:\my tool\skills log\            # 日志与备份目录
├── backups\                      # 备份目录（独立于 Git）
│   └── YYYYMMDD-skill-name-vX.Y\
├── skills修改日志.md
└── skills迭代计划.md

架构说明: ~/.claude/skills/ 下所有目录均为 Junction，指向 ~/my-claude-skills/ Git 仓库。编辑任何 skill 文件会直接修改 Git 仓库中的文件。

Registry: registry.json 记录技能元数据（分类、试用状态、安装日期），由 skill-manager 统一管理，不影响 Claude 加载 skill。

执行协议（必读）

Claude 在被调用此 Skill 时，必须遵循以下流程：

1. 根据用户意图匹配「核心功能」表中的功能编号
2. 使用 Read 工具读取对应的 references/functions/*.md 文件（表中第 4 列的链接路径）
3. 按该文件中的详细步骤逐步执行，产出对应结果
4. 下方「执行要点」仅为快速参考摘要，不替代详细步骤文件——如果只看摘要就回复，功能不完整

关键：Skill 加载 ≠ 执行完成。加载只是把指令放入上下文，Claude 必须主动 Read 资源层文件并执行。

执行要点

功能 1: 列出技能

读取 ~/.claude/skills/ 目录，检查每个 skill 的 SKILL.md、YAML frontmatter、子目录，按来源分类（官方/社区/自建）输出表格。

功能 2: 评估技能

基于 5 个维度评估: YAML Frontmatter、渐进式披露、Token 效率（< 150 行）、自动发现（"Use when..."）、输出格式。输出评估报告和改进建议。

功能 3: 优化技能

完整工作流: 评估 -> 备份 -> 优化 -> 验证 -> 记录。自动项无需确认（格式修复），半自动项需确认（Token 拆分、Description 增强、本地化定制）。

功能 4: 备份技能

1. 从 SKILL.md YAML frontmatter 提取版本号（version: vX.Y）
2. 创建备份目录: backups/YYYYMMDD-skill-name-vX.Y/
3. 复制 SKILL.md + references/ + scripts/ + assets/
4. 记录到 skills修改日志.md

版本号提取: 优先从 frontmatter version 字段读取，其次从更新日志匹配 vX.Y，均无则自动分配 1.0.0 并写入 frontmatter。

功能 5: 回退技能

1. 列出该 skill 所有备份，显示版本号供选择
2. 回退前自动备份当前版本（-pre-rollback 后缀）
3. 从选定备份恢复，记录日志

功能 6: 记录日志

读取 D:\my tool\skills log\skills修改日志.md，追加修改记录（类型、内容、验证结果、回退方法）。

功能 7: 自动 Git 提交

支持手动触发或配置自动提交。配置 config.json 中 git.autoCommit: true 后，修改操作完成后自动执行 git commit/push。

Push 后自动更新 README: 默认开启（autoUpdateReadme: true），push 完成后自动扫描所有 skills，更新 README.md 中的 skills 表格。

功能 8: 批量备份

一键备份所有已安装 skills，支持增量检测（跳过无变更技能），生成汇总报告。

功能 9: 批量评估

批量评估所有 skills 的 5 个维度质量，生成评分汇总和改进建议，支持导出报告。

功能 10: 版本 Diff 对比

对比同一 skill 的两个备份版本或当前版本与历史备份，输出结构化差异报告。

功能 11-14: Registry 管理

统一管理 registry.json 技能注册表，实现试用追踪和分类管理。

功能 11: 注册技能

• 将新安装 skill 添加到 registry.json
• 自动提取分类、版本、描述
• 默认状态为 trial，记录安装日期
• 支持指定所属包（如 critical-debater）

功能 12: 转正技能

• 将 skill 状态从 trial 改为 formal
• 更新 registry.json 并自动 git commit
• README 下次 push 后自动更新显示

功能 13: 删除技能

• 从 registry.json 移除条目
• 可选删除 Git 仓库中的 skill 目录
• 自动清理 Junction 链接

功能 14: 查看试用期

• 列出所有 trial 状态技能
• 显示试用天数（安装日期至今）
• 提示建议操作（转正/删除）

三层渐进式披露原则

Skill 应遵循的核心结构:

元信息层（始终加载）    -> YAML frontmatter: name + description
    ↓ 触发时加载
指令层（按需加载）      -> SKILL.md body: 执行步骤（< 150 行）
    ↓ 任务需要时加载
资源层（条件加载）      -> references/ + scripts/ + assets/

评估和优化时以此为标准。

注意事项

1. Junction 架构: ~/.claude/skills/ 下应为 Junction 指向 Git 仓库，修改即写入 Git 仓库
   • ⚠️ 关键: 如果 skill 是实际目录（非 Junction），会导致版本漂移（本地 vs GitHub 不一致）
   • 备份/修改前自动检查 Junction 状态，发现断裂会提示修复
2. 备份策略: 备份到 skills log\backups\（独立于 Git），每次修改前自动备份
3. Git 提交:
   • 手动模式：备份/回退/优化完成后提醒用户执行 git commit/push
   • 自动模式：配置 config.json 中 git.autoCommit: true 后自动提交
4. 批量操作: 批量备份/评估时单个 skill 失败不影响其他 skill
5. 日志格式: 严格按照模板格式记录，便于后续追溯
6. 路径处理: Windows 路径使用双反斜杠 \\ 或正斜杠 /
7. 迭代计划: 详见 D:\my tool\skills log\skills迭代计划.md