skill-manager 的目标是成为 AIDE skill 管理领域最好用、最可信的开源工具:先把本机 skill / MCP 看清楚,再帮助用户推荐、治理、归档和复盘。
v0.1.x 重点是把核心闭环打稳:
- 扫描 Claude Code / Codex / Pi 的 skill 与 MCP(Pi 无 MCP 配置层)
- 分类、搜索、推荐、知识图谱
- 重复检测、使用审计、风险报告
- skill 生命周期治理:来源、更新、回滚、锁定、策略、profile、质量评测
- 会话日志统计与安全清理计划
- HTML 总览报告
- 匿名导出、MCP schema 开销估算
- 零第三方依赖与 macOS / Windows CI 验证
- README/docs 中英文入口、Issue 模板、Discussions、Release
| 优先级 | 方向 | 价值 | 状态 |
|---|---|---|---|
| P0 | 推荐准确率提升 | 让“我要做某件事该用哪个 skill”成为默认入口 | 进行中 |
| P1 | HTML 总览报告 | 一次导出本机 skill 健康报告,适合分享和留档 | 已完成 |
| P1 | 图谱布局优化 | 大量 skill 时更清楚地查看套件、平台、流程关系 | 进行中 |
| P1 | 匿名导出 | 对外分享扫描和报告时隐藏本机路径、配置位置与 MCP 命令 | 已完成 |
| P1 | 安装体验 | 在 npm 发布前,让 git clone 安装更稳、更易懂 | 已完成一版 |
| P1 | skill 生命周期治理 | 让 skill 从引入、更新到回滚和复盘形成闭环 | 已完成一版 |
| P1 | 英文文档与 CLI 国际化 | GitHub 默认入口服务全球用户,同时保留中文文档;CLI 主链路与详细 docs 已支持英文 | 已完成 |
| P2 | 更多 AIDE 适配器 | 支持 Cursor、Gemini CLI 等更多工具 | 已完成保守目录扫描一版 |
| P2 | MCP token 估算 | 逐 server 估算 tool schema 常驻开销 | 已完成静态估算一版 |
- 已完成:建立 40 条中英文匿名回归样本,输出 Top 1、Top 3、MRR 和已知错误率
- 已完成:将推荐准确率门槛接入自动测试,防止排序规则静默退步
- 已完成:增强中英文任务意图、非相邻动作词和转换方向识别,减少反向或无关候选
- 已完成:从
skm audit中学习个人偏好,但不让高频无关 skill 混入 - 已完成:优化
--advisor codex|claude的候选压缩和失败回退提示 - 下一步:继续扩展内置基准场景,覆盖更多文件格式、平台动作和复合工作流
- 已完成:README 中英文入口、英文详细 docs、
--lang/SKM_LANG、help、参数校验、doctor、scan、status、risks、report、list、search、recommend、ask、outdated、sources、state、install/update/rollback、lock/policy/profile/eval/history、graph、dupes、audit、sessions、disable/enable、安装脚本 - 下一步:继续打磨英文措辞、分类名国际化和跨端文案一致性
- 约束:不引入第三方依赖;JSON 字段名保持稳定;中文文档继续保留
- 已完成:大规模节点轻量碰撞避让、缩放、适配视图
- 已完成:增加更多关系:上下游、共享输入输出格式、同平台不同动作、强替代/弱替代
- 已完成:增加图谱摘要:最密集套件、重复核心、平台生态、潜在工作流
- 已完成:HTML 图谱增加高信号节点上限,搜索时临时放开上限,降低大图初始密度
- 已完成:HTML 总览报告,把图谱、风险和推荐入口放在同一页
- 已完成:Claude Code / Codex / Pi skill 扫描与会话使用审计;Claude Code / Codex skill 与 MCP 扫描
- 已完成:Cursor / Gemini 常见 skill 目录与 MCP 配置扫描,不读取敏感缓存,不启动外部工具
- 已完成:
scan/audit静态安全审计,覆盖 skill 文本、目录元数据与 MCP 非 env 配置字段 - 已完成:MCP schema 常驻上下文静态估算,用于风险提示和 HTML 报告
- 下一步:在公开稳定的日志格式出现后,扩展 Cursor / Gemini 真实使用审计
- 下一步:在不读取密钥、不启动危险进程的前提下探索更准确的 MCP schema 实测
适合社区讨论的方向:
- 安装与扫描体验
- 推荐、图谱、审计、报告等功能设计
- 新 AIDE 工具适配思路
- MCP 上下文治理与安全边界
入口:
- Discussions:https://github.com/GrubbyLee/skill-manager/discussions
- 晒 scan 结果:#2
- Issues:https://github.com/GrubbyLee/skill-manager/issues