skill-manager

技能生命周期管理器

此技能可帮助你维护由 GitHub 包装的技能库，自动检测更新并协助重构流程。

核心功能

1. 审计：扫描本地技能文件夹，查找带有 github_url 元数据的技能。
2. 检查：通过 git ls-remote 查询 GitHub，对比本地提交哈希与最新远程 HEAD。
3. 报告：生成状态报告，指出哪些技能已“过时”或“最新”。
4. 更新工作流：为 Agent 提供结构化的技能升级流程。
5. 清单管理：列出所有本地技能，并提供删除功能。

用法

触发方式：/skill-manager check 或“扫描我的技能，检查是否有更新” 触发方式：/skill-manager list 或“列出我的技能” 触发方式：/skill-manager delete <skill_name> 或“删除技能 <skill_name>”

工作流 1：检查更新

1. 运行扫描器：Agent 运行 scripts/scan_and_check.py，分析所有技能。
2. 查看报告：脚本输出 JSON 摘要。Agent 将其展示给用户。
   • 示例：“发现 3 个过时技能：yt-dlp（落后 50 次提交）、ffmpeg-tool（落后 2 次提交）……”

工作流 2：更新技能

触发方式：“更新 [Skill Name]”（检查后）

1. 获取新上下文：Agent 从远程仓库获取新版 README。
2. 差异分析：
   • Agent 将新版 README 与旧版 SKILL.md 进行比较。
   • 找出新增功能、弃用的标志或用法变更。
3. 重构：
   • Agent 重写 SKILL.md，以反映新增功能。
   • Agent 更新 frontmatter 中的 github_hash。
   • Agent（可选）尝试在 CLI 参数发生变化时更新 wrapper.py。
4. 验证：运行快速验证（如果可用）。

脚本

• scripts/scan_and_check.py：核心脚本。扫描目录、解析 Frontmatter、获取远程标签并返回状态。
• scripts/update_helper.py：（可选）在更新前备份文件的辅助脚本。
• scripts/list_skills.py：列出所有已安装技能及其类型和版本。
• scripts/delete_skill.py：永久删除技能文件夹。

元数据要求

此管理器依赖 github-to-skills 元数据标准：

• github_url：信息来源。
• github_hash：状态依据。