1. 从superpowers这个热词说起它到底在解决什么问题第一次看到superpowers这个词是在几个开发者社群里反复被提及。乍一看像是某个超级英雄主题的插件实际上它指向的是一套围绕 AI 编程助手构建的技能框架agentic skills framework。简单说它的核心思路是把软件开发过程中那些重复出现的、有固定套路的任务抽象成一个个可复用的技能skills然后让 AI 编程助手在合适的时机自动调用这些技能而不是每次都靠你手打一大段提示词去描述。这件事为什么值得聊因为现在用 Claude Code、Codex CLI 这类命令行 AI 编程工具的人越来越多但绝大多数人的用法还停留在我问一句、它答一句的阶段。你每次让它写测试、做代码审查、生成提交信息都得重新描述一遍需求效率其实并不高。superpowers 想做的就是把这层描述需求的工作固化下来变成一套结构化的方法论。它适合谁我觉得有三类人特别值得关注一是每天用 AI 助手写代码、但觉得来回沟通成本高的开发者二是团队里想把 AI 使用规范统一起来的技术负责人三是刚接触 Claude Code 或 Codex CLI想直接站在一个成熟方法论上手的初学者。这篇文章我会把 superpowers 的定位、它和 Claude Code / Codex CLI 的关系、技能怎么引入、实际使用中的坑以及围绕这些工具安装配置的常见问题尽量讲透。需要先说明一点superpowers 本身不是一个独立的软件它更像是一套约定和技能集合依附在 Claude Code、Codex CLI 这类支持技能调用的 agent 框架上运行。所以理解它必须先把宿主工具搞清楚。2. 拆解 superpowers 的底层逻辑技能框架为什么比提示词更靠谱2.1 提示词工程的瓶颈在哪里大部分人用 AI 编程助手的方式本质上是一次性提示词。你打开终端输入一句帮我给这个函数写单元测试AI 生成一段代码你看一眼不满意再补一句边界条件也要覆盖。这个过程有两个明显问题。第一个问题是不可复用。你今天写的这段提示词明天换个项目、换个语言基本要重写。提示词的质量高度依赖你当时的表达状态状态好就写得好状态差就写得含糊AI 的输出质量跟着波动。第二个问题是上下文丢失。AI 助手在单次对话里能记住你说过的话但一旦开启新会话之前积累的那些我们团队习惯用 pytest 而不是 unittest提交信息要遵循 Conventional Commits之类的约定全部归零。你得重新交代一遍。superpowers 这类技能框架的价值就是针对这两个问题给出结构化的解法。它把怎么做某件事的知识从你的临时提示词里抽出来变成一份份独立的、可版本管理的技能文件。2.2 技能skill的本质是一份可执行的约定一个 skill 通常包含几个要素触发条件什么情况下该用这个技能、执行步骤具体怎么做、输入输出约定需要什么参数、产出什么结果、以及注意事项容易踩的坑。这四样东西组合起来其实就是一份给 AI 看的操作手册。打个比方。提示词像是你临时给新员工口头交代任务说得好不好全看你当天状态而 skill 像是公司里写好的 SOP 文档新员工来了直接照着做标准统一不会因为谁交代就变样。AI 助手在有了 skill 之后遇到对应场景就会去读这份 SOP然后按步骤执行。这里有个关键点很多人会误解skill 不是让 AI 更聪明而是让 AI 更稳定。它不提升模型本身的能力上限但能大幅降低输出质量的方差。对于工程场景来说稳定性往往比偶尔的惊艳更重要。2.3 superpowers 与宿主工具的分工理解 superpowers要分清它和 Claude Code、Codex CLI 的层次关系。Claude Code 和 Codex CLI 是宿主负责提供 AI 能力、终端交互、文件读写这些底层功能superpowers 是运行在宿主上的技能层负责定义遇到某类任务该怎么做。这个分层很重要因为它决定了你的使用方式。你不需要改 Claude Code 的源码也不需要动 Codex CLI 的配置核心你只需要把技能文件放到宿主能识别的位置宿主在运行时就会去加载它们。这也是为什么 superpowers 能同时适配多个宿主工具——只要宿主支持技能加载机制技能层就能复用。提示不同宿主对技能的加载路径和格式要求不完全一样引入技能前务必先确认你用的宿主版本支持哪种技能格式否则文件放对了位置也不会被识别。3. 把 superpowers 跑起来Claude Code 与 Codex CLI 的安装与技能引入3.1 先装宿主Claude Code 的安装路径梳理技能框架要跑宿主得先装好。Claude Code 的安装方式在不同系统上差异不小我按平台分开说。在 macOS 和 Linux含 Ubuntu上最省事的方式是通过包管理器安装。以 Ubuntu 为例先确认 Node.js 环境到位然后用 npm 全局安装对应的 CLI 包。安装完成后在终端输入命令验证版本能正常打印版本号就说明装好了。macOS 用户如果习惯用 Homebrew也可以走 brew 的安装路径效果一样。Windows 用户要特别注意一个高频报错由于与64位版本的 Windows 不兼容。这个问题通常出现在你下载了错误的安装包架构或者系统缺少必要的运行库。解决办法是确认你的系统确实是 64 位然后下载对应架构的安装包如果还是不行检查一下是否装了较新版本的 Visual C 运行库。还有一个很多人卡住的点your organization has disabled claude subscription access for claude code。这个提示的意思是当前账号所属的组织关闭了 Claude Code 的订阅访问权限。遇到这个要么换一个个人账号要么联系组织管理员确认权限设置。这不是安装问题是账号权限问题别在安装步骤上反复折腾。另外还有一类报错是网络层面的比如执行 CLI 命令时出现internetopenurl() failed之类的错误。这类问题基本指向网络连通性检查你的网络环境是否能正常访问所需服务即可。3.2 Codex CLI 的安装与常用命令Codex CLI 是另一个常被拿来和 Claude Code 对比的宿主工具。它的安装同样依赖 Node.js 环境通过 npm 全局安装后即可在终端调用。装好之后有几个命令值得先记住。/compact用于压缩当前会话的上下文当对话太长、token 消耗过快时很有用/model用来切换当前使用的模型/resume用于恢复之前的会话。这三个命令是日常高频操作建议一开始就熟悉。如果你后来想卸载 Codex CLI直接用 npm 的卸载命令即可注意清理一下全局配置目录里残留的配置文件否则重装时可能读到旧配置导致行为异常。3.3 技能引入的通用思路技能引入这件事不同宿主的操作细节不同但底层逻辑是一致的把技能文件放到宿主约定的目录然后让宿主在启动或运行时加载它们。具体到操作一般分三步。第一步确认宿主的技能目录位置这个通常在官方文档里有说明或者在宿主的配置文件中能找到线索。第二步把 superpowers 提供的技能文件按宿主要求的格式放进去注意目录结构要和宿主的加载规则匹配放错层级会导致加载失败。第三步重启宿主或触发一次重新加载然后在实际任务中验证技能是否被正确调用。验证的方法很简单给宿主一个明确对应某个技能的任务观察它的执行过程是否符合技能定义的步骤。如果它还是按通用方式回答说明技能没被加载回去检查路径和格式。注意技能文件放进去不等于立刻生效很多宿主需要重启会话才会重新扫描技能目录。改完文件先重启再判断有没有生效能省掉大量无效排查。4. 让 superpowers 真正好用的几个关键配置4.1 在 VS Code 里把 Claude Code 用顺手很多人不习惯纯终端操作更愿意在 VS Code 里用 Claude Code。这就需要装对应的 VS Code 插件。装完之后插件的配置项里通常有几个关键字段需要理解一个是模型选择一个是工作目录还有一个是权限相关的设置。工作目录这个字段特别容易被忽略。如果你不设置插件可能默认用 VS Code 当前打开的文件夹但如果你是多根工作区行为就可能不符合预期。建议显式指定工作目录避免 AI 在错误的目录里读写文件。权限设置决定了 AI 能不能直接执行终端命令。Claude Code 有一个能力是直接执行终端命令这在自动化场景下很方便但也意味着风险。我的建议是在可信项目里可以放开在涉及敏感操作的项目里收紧让它每次执行前先征求确认。4.2 接入第三方模型与本地模型Claude Code 默认走官方模型但很多人想接入第三方 API 或者本地模型来降低成本、提升隐私性。这里涉及两个方向。第一个方向是接入第三方 API。市面上有一些工具比如常被提到的 cc switch 这类切换工具可以帮助你在不同模型提供方之间切换比如接入 DeepSeek、Qwen、GLM 等模型。使用这类工具的核心是配置好 API 端点和密钥然后让 Claude Code 指向这个端点。配置时要注意模型名称的映射关系不同提供方对同一个模型的命名可能不一样填错了会直接报模型不存在。第二个方向是接入本地模型比如通过 LM Studio 跑本地模型然后让 Claude Code 调用。这个方案的好处是数据不出本地适合对隐私敏感的场景。配置的关键是让 Claude Code 知道本地服务的地址和端口以及本地模型对外暴露的接口格式是否和 Claude Code 期望的一致。如果格式不匹配中间可能需要一层适配。提示接入第三方或本地模型后部分依赖官方模型特性的功能可能表现不一致比如某些技能调用、长上下文处理。切换模型后建议先跑几个基础任务验证稳定性再投入正式使用。4.3 关于登录与账号的那些疑问经常有人问Claude Code 能不能不登录、直接用其他模型答案取决于宿主的设计。有些宿主允许你在不登录官方账号的情况下通过配置第三方端点来使用但部分功能会受限。注册账号和不注册账号的区别主要体现在可用功能范围、配额、以及是否能使用官方的一些高级能力上。还有一个常见提示是claude code might not be available in your country。遇到这个说明当前地区不在官方支持范围内。这种情况下走第三方模型接入或者本地模型方案往往是更实际的选择。5. 实战中踩过的坑与排查链路5.1 技能不生效的完整排查过程我遇到过最典型的问题是技能文件明明放进去了但 AI 助手完全不按技能定义的步骤走。这个问题的排查我走过一遍完整链路分享出来供参考。第一步确认文件位置。我先去宿主的配置里找技能目录的定义发现我放的位置和它实际扫描的目录差了一层。这是最常见的原因——你以为的目录和宿主认为的目录不是同一个。第二步确认文件格式。位置对了之后还是不生效我打开技能文件检查格式发现缩进和字段名有细微出入。技能文件对格式通常比较敏感一个字段名拼错就可能导致整个文件被跳过。第三步确认加载时机。改完格式后我直接在当前会话里测试还是不行。重启宿主后技能立刻生效了。这说明宿主是在启动时扫描技能目录的运行中修改不会热加载。第四步确认触发条件。技能生效后我发现有些任务它不调用对应技能。检查后发现是技能的触发条件写得太窄只匹配了特定关键词。把触发条件放宽后覆盖场景就正常了。这个链路里前两步是配置问题第三步是机制问题第四步是设计问题。排查时按这个顺序走基本能定位到绝大多数技能不生效的情况。5.2 模型切换后的行为漂移接入第三方模型后我观察到一些行为漂移。同一个技能在官方模型下执行得很规范换到某个第三方模型后步骤就开始跳。原因在于不同模型对指令的遵循程度不一样有些模型对结构化指令的理解能力弱一些。应对办法有两个。一是针对弱一些的模型把技能步骤写得更细、更明确减少它自由发挥的空间。二是给关键技能加上输出校验让它执行完自检一遍不符合就重来。这两个办法我都试过第二个效果更稳但会增加一些 token 消耗。5.3 上下文压缩带来的技能丢失用/compact压缩上下文之后我遇到过一次技能失忆的情况压缩前 AI 还在按技能步骤走压缩后突然回到通用模式。原因是压缩过程可能把技能相关的上下文一起压掉了。解决办法是在压缩后重新触发一次技能或者把关键技能的核心约定放在一个不容易被压缩掉的位置比如项目的常驻配置文件里。后者更省心一次配置长期有效。6. 围绕 superpowers 的常见问题快查把高频问题整理成一张表方便对照排查。问题现象可能原因处理方向技能文件放了但不生效目录不对 / 格式错误 / 未重启核对目录、检查格式、重启宿主提示组织禁用了订阅访问账号权限受限换个人账号或联系管理员安装报 64 位不兼容安装包架构错误 / 缺运行库换正确架构包、装运行库执行命令报网络错误网络连通性问题检查网络环境切换模型后技能行为异常模型指令遵循能力差异细化技能步骤、加输出校验压缩上下文后技能失效技能上下文被压缩重新触发或放入常驻配置本地模型调用失败接口格式不匹配检查端点、端口、接口格式这张表覆盖了我实际遇到和社群反馈里出现频率最高的几类问题。遇到新问题先往这几类上靠能快速缩小排查范围。7. 我对这套方法论的真实体会用了一段时间 superpowers 这类技能框架之后我最大的感受是它改变的不是 AI 的能力而是我和 AI 协作的方式。以前我像个提示词打字员每次都要重新组织语言现在我更像一个流程设计者把精力花在把技能定义清楚上剩下的交给框架去执行。有几个经验我觉得值得分享。第一技能不要一上来就写一大堆先从你最高频、最重复的那一两个任务开始写好了用顺了再扩展。第二技能文件要当代码一样管理纳入版本控制改了什么、为什么改都留痕否则过段时间你自己都忘了当初为什么那么写。第三别指望技能能覆盖所有场景它的价值在于覆盖高频场景低频的、一次性的任务直接用提示词反而更快。还有一点关于工具选择Claude Code 和 Codex CLI 各有侧重没必要非此即彼。我自己的做法是两个都装根据任务类型切换。技能层如果能做到跨宿主复用那切换成本就很低这也是技能框架相比绑定单一工具的优势所在。最后说个容易被忽略的细节技能框架的收益是随使用频率累积的。用得越久、技能库越丰富边际收益越高。所以如果你只是偶尔用一次 AI 助手可能感受不到它的价值但如果你是每天都要和 AI 协作写代码的人早点把这套方法论搭起来长期看是划算的。 
长河君 · 2026/10/31 12:02:00 · 阅读 1.2k superpowers技能框架：Claude Code与Codex CLI的AI编程助手技能化实践
1. 从superpowers这个热词说起它到底在解决什么问题第一次看到superpowers这个词是在几个开发者社群里反复被提及。乍一看像是某个超级英雄主题的插件实际上它指向的是一套围绕 AI 编程助手构建的技能框架agentic skills framework。简单说它的核心思路是把软件开发过程中那些重复出现的、有固定套路的任务抽象成一个个可复用的技能skills然后让 AI 编程助手在合适的时机自动调用这些技能而不是每次都靠你手打一大段提示词去描述。这件事为什么值得聊因为现在用 Claude Code、Codex CLI 这类命令行 AI 编程工具的人越来越多但绝大多数人的用法还停留在我问一句、它答一句的阶段。你每次让它写测试、做代码审查、生成提交信息都得重新描述一遍需求效率其实并不高。superpowers 想做的就是把这层描述需求的工作固化下来变成一套结构化的方法论。它适合谁我觉得有三类人特别值得关注一是每天用 AI 助手写代码、但觉得来回沟通成本高的开发者二是团队里想把 AI 使用规范统一起来的技术负责人三是刚接触 Claude Code 或 Codex CLI想直接站在一个成熟方法论上手的初学者。这篇文章我会把 superpowers 的定位、它和 Claude Code / Codex CLI 的关系、技能怎么引入、实际使用中的坑以及围绕这些工具安装配置的常见问题尽量讲透。需要先说明一点superpowers 本身不是一个独立的软件它更像是一套约定和技能集合依附在 Claude Code、Codex CLI 这类支持技能调用的 agent 框架上运行。所以理解它必须先把宿主工具搞清楚。2. 拆解 superpowers 的底层逻辑技能框架为什么比提示词更靠谱2.1 提示词工程的瓶颈在哪里大部分人用 AI 编程助手的方式本质上是一次性提示词。你打开终端输入一句帮我给这个函数写单元测试AI 生成一段代码你看一眼不满意再补一句边界条件也要覆盖。这个过程有两个明显问题。第一个问题是不可复用。你今天写的这段提示词明天换个项目、换个语言基本要重写。提示词的质量高度依赖你当时的表达状态状态好就写得好状态差就写得含糊AI 的输出质量跟着波动。第二个问题是上下文丢失。AI 助手在单次对话里能记住你说过的话但一旦开启新会话之前积累的那些我们团队习惯用 pytest 而不是 unittest提交信息要遵循 Conventional Commits之类的约定全部归零。你得重新交代一遍。superpowers 这类技能框架的价值就是针对这两个问题给出结构化的解法。它把怎么做某件事的知识从你的临时提示词里抽出来变成一份份独立的、可版本管理的技能文件。2.2 技能skill的本质是一份可执行的约定一个 skill 通常包含几个要素触发条件什么情况下该用这个技能、执行步骤具体怎么做、输入输出约定需要什么参数、产出什么结果、以及注意事项容易踩的坑。这四样东西组合起来其实就是一份给 AI 看的操作手册。打个比方。提示词像是你临时给新员工口头交代任务说得好不好全看你当天状态而 skill 像是公司里写好的 SOP 文档新员工来了直接照着做标准统一不会因为谁交代就变样。AI 助手在有了 skill 之后遇到对应场景就会去读这份 SOP然后按步骤执行。这里有个关键点很多人会误解skill 不是让 AI 更聪明而是让 AI 更稳定。它不提升模型本身的能力上限但能大幅降低输出质量的方差。对于工程场景来说稳定性往往比偶尔的惊艳更重要。2.3 superpowers 与宿主工具的分工理解 superpowers要分清它和 Claude Code、Codex CLI 的层次关系。Claude Code 和 Codex CLI 是宿主负责提供 AI 能力、终端交互、文件读写这些底层功能superpowers 是运行在宿主上的技能层负责定义遇到某类任务该怎么做。这个分层很重要因为它决定了你的使用方式。你不需要改 Claude Code 的源码也不需要动 Codex CLI 的配置核心你只需要把技能文件放到宿主能识别的位置宿主在运行时就会去加载它们。这也是为什么 superpowers 能同时适配多个宿主工具——只要宿主支持技能加载机制技能层就能复用。提示不同宿主对技能的加载路径和格式要求不完全一样引入技能前务必先确认你用的宿主版本支持哪种技能格式否则文件放对了位置也不会被识别。3. 把 superpowers 跑起来Claude Code 与 Codex CLI 的安装与技能引入3.1 先装宿主Claude Code 的安装路径梳理技能框架要跑宿主得先装好。Claude Code 的安装方式在不同系统上差异不小我按平台分开说。在 macOS 和 Linux含 Ubuntu上最省事的方式是通过包管理器安装。以 Ubuntu 为例先确认 Node.js 环境到位然后用 npm 全局安装对应的 CLI 包。安装完成后在终端输入命令验证版本能正常打印版本号就说明装好了。macOS 用户如果习惯用 Homebrew也可以走 brew 的安装路径效果一样。Windows 用户要特别注意一个高频报错由于与64位版本的 Windows 不兼容。这个问题通常出现在你下载了错误的安装包架构或者系统缺少必要的运行库。解决办法是确认你的系统确实是 64 位然后下载对应架构的安装包如果还是不行检查一下是否装了较新版本的 Visual C 运行库。还有一个很多人卡住的点your organization has disabled claude subscription access for claude code。这个提示的意思是当前账号所属的组织关闭了 Claude Code 的订阅访问权限。遇到这个要么换一个个人账号要么联系组织管理员确认权限设置。这不是安装问题是账号权限问题别在安装步骤上反复折腾。另外还有一类报错是网络层面的比如执行 CLI 命令时出现internetopenurl() failed之类的错误。这类问题基本指向网络连通性检查你的网络环境是否能正常访问所需服务即可。3.2 Codex CLI 的安装与常用命令Codex CLI 是另一个常被拿来和 Claude Code 对比的宿主工具。它的安装同样依赖 Node.js 环境通过 npm 全局安装后即可在终端调用。装好之后有几个命令值得先记住。/compact用于压缩当前会话的上下文当对话太长、token 消耗过快时很有用/model用来切换当前使用的模型/resume用于恢复之前的会话。这三个命令是日常高频操作建议一开始就熟悉。如果你后来想卸载 Codex CLI直接用 npm 的卸载命令即可注意清理一下全局配置目录里残留的配置文件否则重装时可能读到旧配置导致行为异常。3.3 技能引入的通用思路技能引入这件事不同宿主的操作细节不同但底层逻辑是一致的把技能文件放到宿主约定的目录然后让宿主在启动或运行时加载它们。具体到操作一般分三步。第一步确认宿主的技能目录位置这个通常在官方文档里有说明或者在宿主的配置文件中能找到线索。第二步把 superpowers 提供的技能文件按宿主要求的格式放进去注意目录结构要和宿主的加载规则匹配放错层级会导致加载失败。第三步重启宿主或触发一次重新加载然后在实际任务中验证技能是否被正确调用。验证的方法很简单给宿主一个明确对应某个技能的任务观察它的执行过程是否符合技能定义的步骤。如果它还是按通用方式回答说明技能没被加载回去检查路径和格式。注意技能文件放进去不等于立刻生效很多宿主需要重启会话才会重新扫描技能目录。改完文件先重启再判断有没有生效能省掉大量无效排查。4. 让 superpowers 真正好用的几个关键配置4.1 在 VS Code 里把 Claude Code 用顺手很多人不习惯纯终端操作更愿意在 VS Code 里用 Claude Code。这就需要装对应的 VS Code 插件。装完之后插件的配置项里通常有几个关键字段需要理解一个是模型选择一个是工作目录还有一个是权限相关的设置。工作目录这个字段特别容易被忽略。如果你不设置插件可能默认用 VS Code 当前打开的文件夹但如果你是多根工作区行为就可能不符合预期。建议显式指定工作目录避免 AI 在错误的目录里读写文件。权限设置决定了 AI 能不能直接执行终端命令。Claude Code 有一个能力是直接执行终端命令这在自动化场景下很方便但也意味着风险。我的建议是在可信项目里可以放开在涉及敏感操作的项目里收紧让它每次执行前先征求确认。4.2 接入第三方模型与本地模型Claude Code 默认走官方模型但很多人想接入第三方 API 或者本地模型来降低成本、提升隐私性。这里涉及两个方向。第一个方向是接入第三方 API。市面上有一些工具比如常被提到的 cc switch 这类切换工具可以帮助你在不同模型提供方之间切换比如接入 DeepSeek、Qwen、GLM 等模型。使用这类工具的核心是配置好 API 端点和密钥然后让 Claude Code 指向这个端点。配置时要注意模型名称的映射关系不同提供方对同一个模型的命名可能不一样填错了会直接报模型不存在。第二个方向是接入本地模型比如通过 LM Studio 跑本地模型然后让 Claude Code 调用。这个方案的好处是数据不出本地适合对隐私敏感的场景。配置的关键是让 Claude Code 知道本地服务的地址和端口以及本地模型对外暴露的接口格式是否和 Claude Code 期望的一致。如果格式不匹配中间可能需要一层适配。提示接入第三方或本地模型后部分依赖官方模型特性的功能可能表现不一致比如某些技能调用、长上下文处理。切换模型后建议先跑几个基础任务验证稳定性再投入正式使用。4.3 关于登录与账号的那些疑问经常有人问Claude Code 能不能不登录、直接用其他模型答案取决于宿主的设计。有些宿主允许你在不登录官方账号的情况下通过配置第三方端点来使用但部分功能会受限。注册账号和不注册账号的区别主要体现在可用功能范围、配额、以及是否能使用官方的一些高级能力上。还有一个常见提示是claude code might not be available in your country。遇到这个说明当前地区不在官方支持范围内。这种情况下走第三方模型接入或者本地模型方案往往是更实际的选择。5. 实战中踩过的坑与排查链路5.1 技能不生效的完整排查过程我遇到过最典型的问题是技能文件明明放进去了但 AI 助手完全不按技能定义的步骤走。这个问题的排查我走过一遍完整链路分享出来供参考。第一步确认文件位置。我先去宿主的配置里找技能目录的定义发现我放的位置和它实际扫描的目录差了一层。这是最常见的原因——你以为的目录和宿主认为的目录不是同一个。第二步确认文件格式。位置对了之后还是不生效我打开技能文件检查格式发现缩进和字段名有细微出入。技能文件对格式通常比较敏感一个字段名拼错就可能导致整个文件被跳过。第三步确认加载时机。改完格式后我直接在当前会话里测试还是不行。重启宿主后技能立刻生效了。这说明宿主是在启动时扫描技能目录的运行中修改不会热加载。第四步确认触发条件。技能生效后我发现有些任务它不调用对应技能。检查后发现是技能的触发条件写得太窄只匹配了特定关键词。把触发条件放宽后覆盖场景就正常了。这个链路里前两步是配置问题第三步是机制问题第四步是设计问题。排查时按这个顺序走基本能定位到绝大多数技能不生效的情况。5.2 模型切换后的行为漂移接入第三方模型后我观察到一些行为漂移。同一个技能在官方模型下执行得很规范换到某个第三方模型后步骤就开始跳。原因在于不同模型对指令的遵循程度不一样有些模型对结构化指令的理解能力弱一些。应对办法有两个。一是针对弱一些的模型把技能步骤写得更细、更明确减少它自由发挥的空间。二是给关键技能加上输出校验让它执行完自检一遍不符合就重来。这两个办法我都试过第二个效果更稳但会增加一些 token 消耗。5.3 上下文压缩带来的技能丢失用/compact压缩上下文之后我遇到过一次技能失忆的情况压缩前 AI 还在按技能步骤走压缩后突然回到通用模式。原因是压缩过程可能把技能相关的上下文一起压掉了。解决办法是在压缩后重新触发一次技能或者把关键技能的核心约定放在一个不容易被压缩掉的位置比如项目的常驻配置文件里。后者更省心一次配置长期有效。6. 围绕 superpowers 的常见问题快查把高频问题整理成一张表方便对照排查。问题现象可能原因处理方向技能文件放了但不生效目录不对 / 格式错误 / 未重启核对目录、检查格式、重启宿主提示组织禁用了订阅访问账号权限受限换个人账号或联系管理员安装报 64 位不兼容安装包架构错误 / 缺运行库换正确架构包、装运行库执行命令报网络错误网络连通性问题检查网络环境切换模型后技能行为异常模型指令遵循能力差异细化技能步骤、加输出校验压缩上下文后技能失效技能上下文被压缩重新触发或放入常驻配置本地模型调用失败接口格式不匹配检查端点、端口、接口格式这张表覆盖了我实际遇到和社群反馈里出现频率最高的几类问题。遇到新问题先往这几类上靠能快速缩小排查范围。7. 我对这套方法论的真实体会用了一段时间 superpowers 这类技能框架之后我最大的感受是它改变的不是 AI 的能力而是我和 AI 协作的方式。以前我像个提示词打字员每次都要重新组织语言现在我更像一个流程设计者把精力花在把技能定义清楚上剩下的交给框架去执行。有几个经验我觉得值得分享。第一技能不要一上来就写一大堆先从你最高频、最重复的那一两个任务开始写好了用顺了再扩展。第二技能文件要当代码一样管理纳入版本控制改了什么、为什么改都留痕否则过段时间你自己都忘了当初为什么那么写。第三别指望技能能覆盖所有场景它的价值在于覆盖高频场景低频的、一次性的任务直接用提示词反而更快。还有一点关于工具选择Claude Code 和 Codex CLI 各有侧重没必要非此即彼。我自己的做法是两个都装根据任务类型切换。技能层如果能做到跨宿主复用那切换成本就很低这也是技能框架相比绑定单一工具的优势所在。最后说个容易被忽略的细节技能框架的收益是随使用频率累积的。用得越久、技能库越丰富边际收益越高。所以如果你只是偶尔用一次 AI 助手可能感受不到它的价值但如果你是每天都要和 AI 协作写代码的人早点把这套方法论搭起来长期看是划算的。