skills-smart-manager

用途

Skills Smart Manager 是一个元技能，用于管理 Claude Code 会话中所有技能的整个生命周期。其核心原则是：技能应仅在真正需要时加载。过时或无关的技能会浪费宝贵的上下文 token、拖慢响应时间，并可能产生冲突。该技能充当技能生态的编排器，在会话过程中监控、分析并优化所有已激活技能。

主要能力

• 上下文膨胀预防：检测并卸载超过 15 轮未调用的技能。
• 依赖管理：确保前置技能处于激活状态。
• 智能推荐：根据项目文件推荐技能（例如检测到 Cargo.toml 则推荐 Rust 技能）。
• 健康检查：验证 MCP 服务器与 API 端点是否响应。
• 垃圾回收：清理其他技能生成的临时文件。
• 冲突检测：识别相互矛盾的技能（例如格式化规则冲突的格式化器）。
• 会话记忆：按仓库归档最优技能配置。

使用方式

自动触发

• 上下文窗口超过 60% 且已加载至少 3 个技能。
• 用户切换项目领域（例如“设计做完了，来写代码”）。
• 会话感觉缓慢或无响应。
• 出现速率限制警告。

手动调用

• 命令：/skills-smart-manager
• 或提及以下短语：
  • “optimize my skills”
  • “clean up loaded skills”
  • “why is this session slow?”
  • “manage my context”
  • “skill health check”

操作步骤

1. 分析当前会话状态：运行 python3 scripts/analyze_context.py --action scan，获取活跃技能、最后调用轮次、预估 token 占用、上下文百分比、检测到的项目类型等。
2. 评估技能相关性，应用垃圾回收标准：
   • 陈旧性：超过 15 个用户/助手交互轮次未调用。
   • 领域不匹配：项目文件变化导致技能不再相关（例如 figma-handoff 活跃但工作目录无 .fig 文件；rust-best-practices 活跃但 Cargo.toml 被删除；docker-compose 技能活跃但 docker-compose.yml 被移除）。
   • 冲突：技能与更高优先级的活跃技能矛盾（常见冲突见 references/conflict-rules.md，如多个格式化器技能、规则不兼容的多个 linter 技能、多个测试框架技能）。
3. 生成建议报告，列出卸载/保留建议、检测到的项目类型、缺失的推荐技能、潜在节省的 token 总量，并询问是否应用。
4. 若用户批准，执行优化：
   • 卸载单个技能：python3 scripts/analyze_context.py --action unload --skill diagnose
   • 批量卸载：python3 scripts/analyze_context.py --action unload --skills diagnose,token-optimization
5. 归档会话记忆（可选）：运行 python3 scripts/analyze_context.py --action archive，在项目根目录生成 .skill-memory.json，记录仓库、项目类型、推荐技能、避免技能、最后更新时间。下次在该仓库会话时将自动预加载最优技能。
6. 健康检查（可选主动模式）：运行 python3 scripts/analyze_context.py --action health-check，检查 MCP 服务器可达性、所需 API 密钥是否设置、CLI 工具是否安装、技能引用的文件路径是否存在。

适用场景

• 会话变慢：发现大量未调用的重型文档技能占用 token，建议卸载以降低上下文占用、改善响应延迟。
• 项目领域切换：从设计切换到 Rust 后端时，卸载不再相关的设计技能，加载 Rust 相关技能。
• 冲突检测：代码格式化不一致时，检测到多个格式化技能规则重叠，保留高优先级技能并卸载冲突技能。

限制与注意事项

• 该技能依赖 Python 3.7+、Bash，以及访问 .claude/ 目录读取技能元数据的权限；可选依赖 jq 和 Git。
• 自动后台模式（在 .claude/settings.json 中配置 on-context-threshold 钩子）可能在未提示的情况下卸载仍需要的技能，需谨慎使用。
• 陈旧性阈值（15 轮）可能对某些工作流过于激进，可通过 --staleness-threshold 调整。
• 冲突检测可能出现误报，需编辑 references/conflict-rules.md 调整规则。
• 推荐的技能可能不存在于当前技能集合中，建议仅为建议，可忽略或从社区安装。
• 垃圾回收仅删除匹配已知临时模式的文件，不会删除用户文件。
• 该技能与其他技能集成良好（如 token-optimization、rescue-tokens、setup-matt-pocock-skills），已知无冲突技能。
• 许可证为 MIT，属于 valorisa/Claude-Skills 集合。