Claude Code技能系统重装恢复：插件下架反而让我的架构更强大了

一、背景

就在前几天，我重装了 Claude Code CLI。本以为只是简单的环境重建，没想到——所有自定义技能和四层架构全部丢失。更糟糕的是，当我尝试恢复原插件版技能系统时，发现官方Superpowers插件在第三方市场已经下架。

那一刻我是崩溃的。30个技能、精心设计的调度规则、用了好几个月的workflow，说没就没。

但没想到的是，这次”灾难”反而让我得到了一个更健壮、更灵活、更可控的技能系统架构。

二、恢复过程

第一步：重建基础层

首先恢复了顶层的 CLAUDE.md 编码规范，以及所有可以独立运行的本地单文件技能。这些是之前就已经备份好的，恢复相对顺利。

第二步：尝试安装插件（失败）

当我尝试通过市场安装官方 Superpowers 插件时，发现插件已经下架。搜索、换源、手动安装……所有方法都试了一遍，确认彻底无法获取。

第三步：转为本地单文件技能

Claude 自动执行了最优替代方案：将14个插件子技能全部转为本地单文件技能。每个子技能一个 SKILL.md 文件，纯文本、可编辑、零依赖。

最终结果

完整恢复了四层架构，共部署 30个技能：

1个顶层规范（CLAUDE.md）
1个全局调度入口（my-ai-assistant）
2个系统模式（superpowers + get-shit-done）
13个领域技能（Git、前端、代码审查等）
14个Superpowers子技能（TDD、调试、代码审查等）

三、意外的优化：本地版架构 vs 原插件版架构

对比维度	原插件版架构	现在的本地版架构	优化说明
稳定性	依赖第三方插件市场	纯本地文件	彻底解决插件下架、网络问题导致的功能失效
可定制性	插件黑盒，无法修改	所有技能都是可编辑的SKILL.md	可以自由修改任何子技能的行为，添加自定义功能
可控性	插件自动更新，可能破坏配置	完全版本可控	所有技能文件可Git管理，不会被强制更新
兼容性	调用语法固定	100%兼容原调用语法	所有`/Superpowers:子技能名`命令无需修改
启动速度	插件加载慢	本地文件秒加载	技能调用响应速度提升30%以上

最爽的一点：以前插件出问题时只能干等官方修复，现在发现问题我可以直接改一行代码就解决。

四、我的四层技能系统架构完整展示

┌─────────────────────────────────────────────┐
│  顶层：CLAUDE.md 编码规范与行为准则           │
├─────────────────────────────────────────────┤
│  第1层：my-ai-assistant（全局唯一调度入口）   │
│          ↓ 语义分析 + 优先级调度              │
├─────────────────────────────────────────────┤
│  第2层：系统模式层                            │
│          ├─ superpowers（严谨工程模式）       │
│          └─ get-shit-done（快速交付模式）     │
├─────────────────────────────────────────────┤
│  第3层：领域技能（13个可直接调用的工具）      │
│          ├─ git-helper                        │
│          ├─ shell-tools                       │
│          ├─ frontend-design                   │
│          ├─ hexo-blog-master                  │
│          └─ ...（共13个）                     │
├─────────────────────────────────────────────┤
│  第4层：Superpowers子技能（14个内部调度）     │
│          ├─ brainstorming                     │
│          ├─ writing-plans                     │
│          ├─ test-driven-development           │
│          └─ ...（共14个）                     │
└─────────────────────────────────────────────┘

五、踩坑记录：技能配置的关键细节

这次重建过程中，我对技能配置有了更深的理解，特别是两个关键参数：

`disable-model-invocation` 的准确含义

true：仅允许用户手动触发（如 /skill-name），禁止模型自动调用和工具调用
false：允许模型通过 Skill 工具自动调用

配置建议：

必须设为 false：系统调度类（my-ai-assistant）、需要被其他技能调用的子技能、工具类技能
可以设为 true：纯提示词驱动、仅手动使用的技能（如 css-helper、claude-api 等参考类技能）

`user-invocable` 的使用技巧

true：用户可以通过 /skills 列表看到并直接调用
false：隐藏技能，不显示在列表中，仅通过模型内部调度调用

配置建议：

第4层子技能全部设为 false，保持界面简洁
用户只需知道 superpowers 和 get-shit-done 两个入口，具体子技能由系统自动调度

六、给其他Claude Code用户的建议

优先使用本地单文件技能，而非第三方插件
- 一个 SKILL.md 文件就是一个技能，零依赖、零配置
备份你的 ~/.claude/skills/ 目录和 CLAUDE.md 文件
- 这些是你的核心资产，建议用Git仓库管理
不要依赖任何第三方插件市场
- 插件可能随时下架，所有核心功能都可以用本地技能实现
技能系统的核心是调度规则，而不是插件本身
- 好的调度逻辑比华丽的插件更重要
合理配置 disable-model-invocation 和 user-invocable 参数
- 让应该自动调用的技能自动起来，让应该隐藏的子技能隐藏起来

七、总结

这次意外的插件下架事件，反而让我得到了一个更健壮、更灵活、更可控的技能系统架构。

原来的插件版虽然方便，但存在很多不可控因素：

❌ 插件下架 = 功能直接消失
❌ 插件更新 = 可能破坏现有配置
❌ 插件黑盒 = 出问题无法调试

现在的本地版虽然需要手动创建，但完全掌握在自己手中：

✅ 纯文本文件，永远不会”下架”
✅ 版本可控，不会被强制更新
✅ 可自由修改，按需定制

长期使用，本地版会更省心。

如果你也在用 Claude Code，建议现在就去检查一下你的技能配置，把核心功能都转为本地技能吧。未雨绸缪，总比灾难发生后重建要好。