1. 从一串热搜词说起superpowers到底指什么我最早看到 superpowers 这个词密集出现是在社群和搜索引擎的热榜里当时的第一反应是这又要冒出一个新框架或者新工具了点进去细看才发现这个标题背后其实藏着两条完全不同的技术线。一条是近期在 AI 编程助手圈子里被反复讨论的 Codex CLI 增强配置方案另一条则是加密货币自动交易领域里一个叫 WorBuddy 的实盘网格机器人。两边的使用者都在用“superpowers”这个词指代自己手里的那套东西结果关键词一碰撞就成了热词。先说 Codex 这一支。Codex 本身是 OpenAI 推出的命令行编程智能体你和它对话它就能直接在终端里读写项目文件、执行测试、提交代码。很多用过的人会说它能用但不聪明原因在于零基础状态下Codex 的默认行为偏向保守它不太会主动组织多步骤任务不懂你的编码规范也不会在改动完后自动跑一遍测试。于是有人就动手把一系列自定义指令、流程模板和工具函数打包进 Codex 的配置目录里让整个 Agent 的行为模式从被动回答问题变成主动拆解任务并推进完。这个打包的配置集合有人给它起的名字就叫 superpowers意思非常直白给 AI 编程助手装配一套超能力。另一条线来自币圈。WorBuddy 是一个实盘网格交易机器人它专门针对 BTC、ETH 这类主流币的高频震荡行情在币安等交易所的现货接口上执行自动化买卖。它的几位核心开发者都是早年手工做网格策略的老玩家后来把策略参数、仓位管理、移动止盈止损都固定成了一套默认配置让普通用户不用写代码也能跑起一个全天候在线的网格交易系统。在它的使用社区里“worbuddy 怎么用 superpowers”这个热搜词实际问的是如何配置它的高级策略模块但因为搜索关键词重叠就和我前面说的 Codex 配置方案混在了一个话题池里。把这两条线放到一起看你会发现superpowers作为标题其实特别贴切——它代表的是同一件事用一个可配置、可复用的能力层把基础工具变成真正能干活的系统。Codex 有了 superpowers就从一个只能聊天的终端助手变成一个能自己管理任务流的开发副手WorBuddy 有了 superpowers就从一个定时买卖脚本变成一个能应对极端行情的全天候交易员。这篇文章我会把这两套东西的做法和选择逻辑都讲透尤其对想用 AI 编程增强的人来说这可能是目前性价比最高的一条路径。2. Codex CLI 里的 superpowers从安装目录到可复用的本地能力2.1 先理解它的目录结构和技能包思路如果你已经安装过 Codex CLI那你一定见过它默认生成的配置文件在用户主目录下的.codex文件夹里通常会有一个config.toml和一个agents目录。superpowers 做的事情就是往这个体系里塞进一整套预编译好的行为模块。它不是一个独立程序更像是一组配置、一段初始提示词、多个可从项目内调用的说明文档以及配套的小型验证脚本。从公开的用法看它的核心设计理念可以归纳成一句话把 Agent 的开发流程显式化。默认的 Codex 接到你的问题后会直接找到相关文件然后开始改superpowers 则会先分析仓库现状找出测试框架建立一份任务清单再逐项推进。这套行为模式的差异并不是 Codex 产品内置的而是靠AGENTS.md这类项目说明文件、初始对话提示词和一组自定义能力函数共同塑造的。我试过之后的理解是superpowers 真正改变的是链路。就拿重构一个函数来说默认模式下你会看到 Codex 直接输出新代码而在 superpowers 模式下它会先读需求、定位所有调用点、列出受影响文件、写一个重构计划然后动手改代码改完还会自己跑一边测试确认。这个流程对应到人身上就是一个初级工程师和一个资深工程师的差别——前者直接上手改后者先画好边界再动工。2.2 安装步骤里最容易翻车的三个环节我见过不少人在安装 superpowers 时卡住仔细复盘下来几乎都死在这三件事上第一克隆仓库的位置不对。这类配置项目一般建议直接克隆进一个固定目录比如~/.superpowers或者项目仓库内指定的 vendor 目录。很多教程说可以直接克隆到任意位置这在技术上没错但一旦你新建了其他项目Codex 就找不到那份配置了。我个人建议是把它放在用户主目录下的独立文件夹里然后通过符号链接或环境变量方式供所有项目共用这样一劳永逸。第二初始化脚本执行失败后残留的.codex配置污染了新配置。项目里通常有一个scripts/install.sh或对应的安装脚本它会往~/.codex/config.toml里追加几行配置。如果中途发生网络错误脚本可能只写了一半配置导致后面 Codex 直接无法启动。我遇到过一位朋友反复安装却一直报配置解析失败最后是我让他把~/.codex整个备份后重新初始化这才恢复正常。如果你也卡在这一步先别急着删备份一下再动手。第三当前终端的 Codex 会话没有重启。这类配置项目多数是在 Agent 启动时加载的如果你改完配置后还在旧的终端会话里继续对话自然觉得安装完和没装一样。正确做法是退出终端、重新打开再执行codex命令加载新配置。这三步都不难难在没人跟你说顺序反了也会踩坑。如果你之前安装失败过可以按上面三条逐一对照检查。2.3 从目录到技能它给 Codex 增加了哪些实打实的能力从实际效果来看superpowers 在 Codex 上的主要增强点是让 Agent 具备任务拆解和执行闭环能力。具体表现有这几类任务拆解。面对给项目加一个用户注册功能这种需求普通模式下 Codex 会找出用户模型、路由和数据库文件然后并行改动superpowers 模式下它会先问清楚字段、校验规则、是否邮箱验证然后生成计划等你确认后再动工。这个交互习惯一开始可能让急性子很不适应但对于复杂项目改动能显著降低改错代码的概率。测试驱动。它会要求 Codex 在改动前先找到测试文件和测试命令并且在改完之后主动运行相关测试。对 Java、Python 这类工程化程度高的项目尤其有用。等于在 Agent 的执行链路上内置了一个质量门禁。代码审查。它会让 Codex 在完成后主动 review 一遍自己在当前会话中生成的代码检查是否存在类型问题、边界条件、命名不一致等情况。这个动作相当于让 AI 自己当了一次 reviewer减少很多低级错误的漏网。从实际工程角度看这些能力都不是什么黑科技关键在于把流程写成了提示词和规则让原本随机的 AI 行为变得可预期。所谓给 Agent 装超能力本质上是给 Agent 装了一套操作规范。3. 让 superpowers 在 Java 项目里跑起来配置要点与实操手册3.1 Java 场景下为什么更容易踩坑如果你打开搜索引擎把superpowers java作为关键词输入会看到大量关于在 Java 项目里使用 superpowers 工具包的提问。为什么 Java 场景特别容易被提及因为这类配置项目最初的示例多为 Python/JavaScript 项目Java 工程在模块路径、构建工具、测试框架上都更重Agent 默认能力往往不够用。举个例子一个 Maven 多模块项目Codex 默认情况下只知道在仓库根目录找pom.xml但它并不清楚应该对哪个模块执行mvn test。你要是拿不加配置的 Codex去改其中的一个模块它极有可能在根目录直接跑测试然后得到一堆模块路径错误。superpowers 在 Java 场景下的核心价值就是让 Agent 学会先读构建结构再决定操作对象。我实际测试下来最明显的变化是它会对 Maven 项目执行mvn -q dependency:tree之类命令来理解依赖关系而不是靠猜。这个动作看似简单实际效果却非常显著——依赖版本冲突、本地仓库缺包这些常见问题它能提前识别出来不再像以前那样改完代码后在测试阶段才报红。3.2 配置步骤从克隆仓库到跑通第一个增强会话这里给出一套我实际跑通的 Java 项目配置链路你可以直接照着做第一步把 superpowers 配置仓库克隆到本地固定目录。我放在~/workspace/superpowers然后用一个环境变量SUPERPOWERS_HOME指向它方便后续路径复用。第二步运行安装脚本。大多数这类项目都提供install.sh它会将核心配置写入你正在使用的 Agent 配置文件。如果你的项目仓库已经有自定义配置建议先备份因为安装脚本的合并策略不一定是追加可能是整段覆盖。第三步编辑~/.codex/config.toml确保在合适的位置引入 superpowers 的提示词目录。安装脚本一般会帮你做这件事但如果你使用的是 Codex 全新版本配置格式可能已经变化需要手动核对。第四步进入你的 Java 工程目录在工程根目录新建或改写AGENTS.md。这份文件是整个方案的关键在里面注明这是一个 Maven 多模块项目根 POM 负责聚合领域模块位于 xxx 路径测试应在模块目录下执行这类上下文信息。有了这份文件Agent 才能做出符合你工程背景的决策而不是拿着通用模板乱撞。第五步重启终端会话启动 Codex然后输入一条简单指令例如介绍一下本项目的模块结构。如果配置成功你会看到 Codex 先读取AGENTS.md、遍历 POM 文件再给你一份项目地图而不再只是把当前目录的文件列一遍。这套流程走完你相当于给 Codex 装上了 Java 项目的地图感。之后再让它改代码它的操作路径会明显更像一个熟悉项目的人。3.3 针对 Maven 多模块项目的自定义调节Java 生态里最典型的场景是 Maven 多模块聚合工程。这种结构下superpowers 的默认配置不一定完美契合你的目录组织我建议你根据自己的实际结构做三处微调调整一在AGENTS.md里写清楚模块依赖方向。比如核心模块不允许依赖启动器模块这种约束Agent 在后续改动时就会避免引入循环依赖。人写代码都会注意的事你不写清楚它可不会自觉规避。调整二指定测试命令的精确路径。如果某模块的测试必须在模块目录下执行就明明白白写上cd modules/xxx mvn test而不是让 Agent 自己去猜。默认配置下它可能会在根目录跑一次mvn test然后因为模块隔离而失败最后退回根 POM 执行-pl参数白白浪费时间。调整三利用 Java 的单元测试插件配置。比如在AGENTS.md里追加一句测试覆盖率低于 80% 时需要在报告中说明原因Agent 在处理新增代码时就会主动多写几个边界用例不会只用一个 happy path 糊弄你。这三条调整做完后你的 Java 工程才真正算得上是superpowers 优化过的开发环境。不是所有配置都必须完全照搬默认值适合你自己项目结构的配置才有意义。4. 另一个热门选择WorBuddy 这类网格工具的能力边界与选型4.1 它是什么、适合什么人说完 Codex 这条线我们把视角切回检索词里的 worbuddy 怎么用 superpowers。这里面的 WorBuddy是天眼量化团队的一款实盘网格策略机器人基于加密货币现货市场的震荡行情设计。官方介绍它的定位是AI 网格机器人也就是说它不是一个单纯的定时买卖脚本而是可以在行情波动中自适应调整网格间距和仓位雷达扫描所有交易对的高波动机会盘口实时算出 PB 和 spread 等超参数AI 升降网格防线并对冲市场尖锐波动。从能搜到的信息来看WorBuddy 有三个比较突出的特点第一是跨交易所对冲。它支持同时连接不同交易所账户多空双边下网对冲市场极端波动。如果单边网被打破会用现货网格单去套保对冲净风险被限制在一个很小的区间。第二是高频运行的稳定性。它把网格策略的交易逻辑和交易所 API 的交互协议封装好配好参数启动后理论上可以全天候跑。第三是多交易对覆盖。雷达扫描模式下它可以同时监听几十个交易对的行情只做符合条件的高波动机会不浪费资金在死盘上。它适合的是有加密货币现货持仓、愿意用交易量换震荡收益的用户。注意这里说的不是无风险套利也不是保本理财它仍然存在行情单边下跌时持仓浮亏的市场风险。4.2 安装与参数配置的关键步骤如果你确实想尝试这款工具网上能找到的操作路径大概是这样的第一步准备一个独立的币安或欧易等主流交易所账户并生成 API Key。这里必须提醒一句这类机器人需要读取行情、执行交易、查看持仓因此 API Key 会涉及交易权限。请务必只给交易和读取权限不要开启提现权限并且把 IP 白名单配置到你的运行环境比如你自己的云服务器 IP。很多用户安全意识不足把带提现权限的 Key 直接配置进工具等于把保险柜钥匙交给了别人。第二步下载并安装 WorBuddy 的客户端。它在 Windows、Linux 和 macOS 上都有发行版通常是解压即用。下载后先完整看一遍官方说明书把所有参数弄清楚不要一边运行一边查文档。第三步配置核心策略参数。WorBuddy 的 AI 网格参数里有几个比较高阶的选项网格数量决定你拆单的密度间距决定每根网格的触发节奏单网格下单量决定单仓规模止盈止损线决定异常行情下的强制退出位置。如果是新手建议先用官方提供的默认参数跑模拟盘或者小资金试运行等熟悉行为模式后再逐步调整。默认参数不一定最优但它一定最稳。第四步运行并持续观察。网格交易不是设完就不管前两周重点关注最大回撤幅度、成交频率、资金利用率、滑点影响。如果某两天行情突然拉涨导致单边破网你要能在日志里看到对应的事件记录并及时评估当前的网格防线是否还能承接住。4.3 网格交易和 Codex superpowers 的底层逻辑其实是相通的把 WorBuddy 和 Codex superpowers 放在一起看你会发现一件很有意思的事两者都在做把专业流程固化成可配置的默认值这件事。Codex 写代码时专业工程师会先看构建结构、再定计划、然后动手改、最后跑测试superpowers 把这个流程固化成了提示词和配置让 AI 默认按这个节奏执行。WorBuddy 做交易时专业操盘手会先算震荡区间、再布网格、设定止盈止损、持续监控风险WorBuddy 把这个流程固化成了 AI 网格策略模块让交易机器人默认按这套逻辑运行。它们共同点在于工具的价值不等于配置的复杂程度而在于把隐性知识显性化。你自己摸索出的那套先看哪里、再改什么、怎么验证的工作习惯如果能写进配置文件让工具默认执行省掉的就是每天重复的决策时间。所以我的建议是不管你是尝试给 Codex 装 superpowers还是准备在交易里用 WorBuddy都先去想想我到底希望它默认怎么做然后把这一步一步写下来。这一步做完工具就已经成功了一半。5. 安全红线与易错清单装完配置之后必须检查的事5.1 权限最小化是底线API Key 和 Agent 权限都适用这句话是对两条线同时说的。在 Codex 场景里superpowers 可能导致 Agent 主动执行更多命令包括修改文件、启动测试、安装依赖。你要检查运行环境的 Git 权限、网络代理设置、依赖源地址防止 Agent 被诱导执行了不该执行的命令。如果你在多人协作的仓库中使用更要确认AGENTS.md里没有夹带可疑的指令因为这类文件本质上就是一段新同事入职培训手册坏人可以把恶意指令写进去诱导 AI 执行。在 WorBuddy 场景里API Key 权限控制就是你的生死线。前面已经反复强调过只开交易和读取权限不开提现权限配置 IP 白名单不要把 Key 明文写进配置文件里直接提交到 GitHub。如果发现 Key 泄露第一时间去交易所后台删除不要抱有侥幸心理。我从实际项目里得到的经验是给 AI 工具、给交易机器人授权应该遵守同一个原则——给到刚好够用的权限而不是给到最大可用权限。你是在用工具不是在给它无限手套。5.2 备份和回滚没有这两个动作任何配置改动都是赌博在任何配置型项目里备份都是最容易被忽略、出事后最后悔的一步。安装 superpowers 前把~/.codex/config.toml备份成config.toml.bak调整 WorBuddy 参数前把当前的策略配置文件完整复制一份。回滚也必须有意识地做。比如你在 Codex 里试了一套新的 task 流程跑了几天发现反而降低了交互效率那就应该果断回滚到上一份配置别在同一份配置上反复修补。在交易里也是如此网格参数不是越调越细越好震荡行情下频繁改参数本身就是一种额外的交易成本。还有一个小习惯值得养成给每一个版本的配置写一条变更记录。不必写得多正式一句话就够比如2025-06-10调整 Java 项目里 Maven 测试命令路径或2025-06-12网格数量从 80 改为 60。三个月后你会发现这条记录比任何说明书都有用。5.3 合规提醒任何工具都是放大器不是印钞机这部分内容我只想提醒一句。WorBuddy 这类网格交易机器人在合规层面的性质取决于你所在的地区和具体行为。有些地方把加密货币现货交易视为合法行为有些地方有严格的金融监管要求这些都需要你自己去核实。我不是法律专业人员不能替你做判断但有一点是确定的工具放大了你的策略执行效率并没有消除市场风险和法律风险。我见过很多人把收益截图当成全部考量标准忽略了自己真正要承担的风险边界。无论你是给 Codex 增强能力还是给交易账户加自动策略都应该先想清楚我能承受的最坏结果是什么再决定要不要按下启动键。这不是劝退而是让你在使用工具前多一分清醒。6. 我的个人经验和一套可复用的启动检查单6.1 从零开始给 Codex 配 superpowers 的七日经验表如果你是第一次接触这类增强配置我建议你用七天时间走完这个过程而不是一个下午就全部装完。时间拉长一点你才有机会观察每一步的实际效果第一天完成安装和目录结构理解只运行一条简单的查询指令不进行任何实际代码改动确认配置加载没有报错。第二天在一个非核心项目里让增强后的 Codex 执行一个小任务比如给某个函数增加日志。观察它的计划先行和测试自动执行行为。第三天检查日志和AGENTS.md调整其中不适用于你项目的内容。重点看模块路径、构建命令和测试框架描述。第四天在一台备用分支或新分支上让增强后的 Codex 完成一次中等规模重构同步运行测试验证。第五天观察它在多文件改动场景下的任务拆解质量如果出现明显偏差根据错误类型调整提示词权重。第六天考虑加入自定义能力函数比如让它调取公司内部的代码规范文档再开始编码。第七天沉淀一份你自己项目的AGENTS.md模板以后每个新项目都能复用。这套节奏看起来慢实际上比装完当天就生产环境直接开跑要稳得多。我自己踩过一回坑第一天就把增强配置直接引入一个大型生产仓库结果 Codex 在AGENTS.md的引导下主动重构了一个不该动的基础模块虽然测试通过但引发了其它模块的编译失败最终多花了三个小时回滚。教训非常深刻。6.2 最后再给你一张冷启动检查清单不管你是用 Codex 还是 WorBuddy启动一个带着 superpowers 的新环境之前花一分钟对照下面这个清单主目录下的配置文件是否已经备份Codex 的AGENTS.md是否针对当前项目改写而不是直接复制别的仓库Maven/Python/Node 项目的构建命令和测试命令是否在配置里有过显式确认所有涉及外部服务的 API Key 是否已做最小权限配置运行环境是否记录日志日志轮转是否打开回滚方案是否明确比如代码仓库的分支策略是否允许快速回退你是否已经想好这个配置最多跑多久不调整的观察期我在实际使用中发现大多数人出的问题都不是配置本身的问题而是因为装得太急、改动太大、没有观察期。把清单里任何一项做到位你的 superpowers 体验都会比别人顺一大截。说到底superpowers这个名字起得很诚实——它只是给一副基础骨架装上了更强的肌肉和反射弧能不能发挥出真本事最后还是取决于你怎么用。我的建议是把工具当成一个需要磨合的搭档而不是一个全能的保姆。它帮你省下的时间值得你用十分之一来维护它、理解它、约束它。