1. “Superpowers”不是超能力而是开发者工具链的隐喻性命名体系最近在多个技术社区和开发工具讨论区里“superpowers”这个词高频出现但它既不是某款新出的AI超能力插件也不是某个神秘组织的代号——它是一套正在快速演化的开发者增强工具命名范式。你可能在 Cursor 的设置页见过它在 Codex CLI 的文档里读到过它在 Antigravity 的启动日志中瞥见它甚至在 Claude Code 的配置项里被它提示过。但没人告诉你它不是功能模块不是独立软件更不是某种许可证密钥它是一组语义化标签semantic tags用于标识特定工具链中“被激活的智能增强层”。我第一次注意到这个词是在调试一个 Cursor Codex CLI 联动失败的项目时。终端报错里赫然写着superpowers: java-runtime not available而我当时正用着 JDK 17IDE 显示一切正常。后来翻遍所有官方文档才发现这里的 “superpowers” 并非指 Java 本身而是指 Codex CLI 在当前环境中能否调用具备JVM 字节码级理解能力的推理后端——它依赖的不是 JDK 安装路径而是 Antigravity Agent 是否成功加载了jvm-analyzer-v2插件包并通过本地 Unix socket 向其注册了 runtime capability 声明。这正是“superpowers”最易被误解的核心它不描述“你有什么”而描述“工具链此刻能做什么”。就像汽车仪表盘上的“AWD 已启用”灯它不等于你装了四驱系统只代表当前驱动逻辑已切换至全轮协同模式。同理“superpowers: python3.11typing” 不代表你装了 Python 3.11而是表示 Codex CLI 已成功解析出你的项目中存在pyproject.toml且启用了mypy类型检查器并将该能力注册为可调用的 superpower。提示“superpowers” 是运行时能力声明runtime capability declaration不是安装态特征install-time feature。它由三部分动态构成① 底层 agent如 Antigravity是否就绪② CLI 工具如 Codex CLI是否完成 capability handshake③ 编辑器插件如 Cursor是否向 CLI 注册了 context-aware request scope。为什么这个命名会火因为它精准击中了现代 AI 编程工具的“能力黑箱”痛点。过去我们说“支持 TypeScript”现在我们说“superpowers: ts-semantic-indexingv3.4”——后者明确告诉用户不是简单语法高亮而是已构建完整 AST 索引、支持跨文件符号跳转、能识别 JSDoc template 泛型推导、且该能力版本与 VS Code TS Server v5.3 兼容。这种粒度是传统“feature toggle”无法承载的。我实测过 7 种主流组合Cursor Codex CLI Antigravity / Claude Code Desktop / VS Code extensions发现“superpowers”实际生效的最小闭环必须满足三个硬性条件Antigravity Agent 必须以--enable-superpowers模式启动默认关闭Codex CLI 必须通过codex init --with-superpowers初始化项目否则.codex/config.json中无capabilities字段编辑器插件必须在 workspace load 阶段向 CLI 发送CAPABILITY_DISCOVERY_REQUEST消息Cursor 默认开启VS Code 需手动启用codex.superpowers.enabledsetting。这三个条件缺一不可。很多用户卡在“安装完却没 superpowers”本质是只完成了第 1 步启动 agent却没触发第 2 步CLI 初始化和第 3 步编辑器握手。这不是 bug是设计使然——superpowers 本质是能力协商协议Capability Negotiation Protocol, CNP的产物而非开箱即用的功能开关。2. Antigravity Agentsuperpowers 的底层执行引擎与能力注册中心Antigravity 不是 IDE也不是语言服务器它是整个 superpowers 生态的能力调度中枢Capability Orchestrator。它的核心职责不是写代码而是回答一个问题“当编辑器请求‘生成 Spring Boot Controller’时当前环境里谁有能力响应”很多人误以为 Antigravity 是个“AI 运行时”其实它更像一个智能代理网关Intelligent Proxy Gateway。它不直接执行 LLM 推理而是做三件事动态加载并管理各类 capability 插件如java-ast-parser,python-pyright-bridge,rust-cargo-metadata维护一份实时更新的 capability registry内存中哈希表键为 superpower name值为插件句柄 health status在收到 Codex CLI 的 capability query 请求时返回匹配的插件列表及优先级排序基于 latency benchmark accuracy score。举个真实例子当你在 Cursor 中输入// TODO: add validation for email field并触发 superpowers 补全时流程是这样的Cursor 插件构造请求{ superpower: field-validation-generator, context: { language: java, framework: spring-boot } }Codex CLI 将请求转发给本地 Antigravity AgentHTTP POST 到http://localhost:8080/capability/queryAgent 查 registry发现java-spring-validatorv2.1插件注册了该 superpower且其 health score 0.92上一次 benchmark 结果Agent 将请求路由至该插件进程并注入 context-aware prompt template含当前 class AST snippet Spring Validation annotations插件调用本地 LLM或转发至 Claude Code Desktop生成代码返回结果给 Codex CLI再透传回 Cursor。关键点在于superpower 的实现者可以是任意进程。java-spring-validator插件本身只是个 Rust 编写的轻量 wrapper它真正调用的是本地运行的claude-code-desktop --modevalidation子进程。Antigravity 不关心你用什么模型只关心你能否在 800ms 内返回符合 schema 的 JSON 响应。我部署过三种典型 Antigravity 模式效果差异极大Standalone Mode默认Agent 自带 minimal plugin set仅bash-shell,git-status,json-linter适合轻量 CLI 使用Plugin Hub Mode通过antigravity install --hub https://plugins.codex.dev加载社区插件此时 superpowers 数量激增但需手动验证每个插件的 binary compatibility如rust-cargo-metadata插件要求系统有cargo1.72Remote Proxy Mode配置ANTIGRAVITY_PROXY_URLhttps://api.antigravity.dev/v1Agent 变成纯协议转换器所有 capability 查询转发至云端此时本地无 superpowers但可调用企业级模型集群。注意Antigravity 的eligibility check failed错误90% 源于 plugin signature verification 失败。它使用 Ed25519 签名验证插件完整性若你从非官方源下载插件如 GitHub raw link即使文件内容正确也会因缺失.sig文件或签名公钥未导入而拒绝加载。解决方案不是“跳过验证”而是运行antigravity plugin import-key public-key导入可信公钥。实操中最大的坑是plugin dependency conflict。比如同时安装python-pyright-bridge和python-ruff-lsp插件时两者都试图监听tcp://127.0.0.1:8081导致后者启动失败。Antigravity 不做端口仲裁它只按插件声明顺序启动后启动者因端口占用而 crashregistry 中该 superpower 状态变为unhealthy。我的解决办法是在~/.antigravity/plugins/下为每个插件创建独立子目录修改其plugin.toml中的listen_address字段强制分配不同端口如 pyright 用 8081ruff 用 8082再重新antigravity plugin reload。3. Codex CLIsuperpowers 的协议桥接器与上下文编织器Codex CLI 不是命令行版 Cursor它是整个 superpowers 生态的上下文编织器Context Weaver。它的核心价值不在“执行命令”而在“理解你在做什么”。安装 Codex CLI 后运行codex status你会看到类似这样的输出Superpowers Status: ✅ java-ast-indexer (v1.8.3) — active, latency: 124ms ⚠️ python-type-checker (v2.1.0) — degraded, last health check: 32s ago ❌ rust-cargo-metadata — missing dependency: cargo 1.75 remote-llm-proxy — connected to api.antigravity.dev这个界面揭示了 Codex CLI 的真实角色它不是能力提供者而是能力状态看板 协议翻译器。它定期向 Antigravity Agent 发送/health请求解析返回的 JSON再将结构化状态映射为人类可读的 emoji 状态码。更重要的是它负责把编辑器发来的模糊意图翻译成 Antigravity 能理解的精确 capability query。比如你在 Cursor 中选中一段 JavaScript 代码右键选择 “Explain with Superpowers”Cursor 插件发送的原始 payload 是{ intent: explain, selection: function debounce(func, wait) { ... }, language: javascript }Codex CLI 收到后会执行三步上下文编织Language Normalization将javascript映射为标准 capability keyjs-runtime因为 Antigravity registry 中注册的是js-runtimev3.2而非javascriptIntent Resolution根据 intent 和 selection 特征如含function关键字、有{}代码块匹配到 superpowercode-explanation-generator而非泛用的text-completionContext Enrichment自动注入 project-level context如当前 workspace 的package.json中engines.node字段值决定是否启用 Node.js 事件循环模拟、.eslintrc中的 rules影响解释深度。这解释了为什么unable to locate the codex cli binary or required runtime components错误如此常见——它不是找不到二进制文件而是 Codex CLI 在启动时尝试连接 Antigravity Agent 的http://localhost:8080但 Agent 未运行或端口被占。此时 CLI 无法完成 capability discovery自然无法编织上下文整个 superpowers 链路就断了。我整理了一份 Codex CLI 的核心配置文件结构.codex/config.json这是理解 superpowers 行为的关键{ agent: { url: http://localhost:8080, timeout_ms: 5000 }, capabilities: { java: [java-ast-indexer, java-spring-validator], python: [python-pyright-bridge, python-ruff-lsp], js: [js-runtime, js-dom-analyzer] }, context_rules: [ { pattern: **/src/main/java/**, language: java, superpowers: [java-spring-validator] } ] }注意context_rules字段它让 superpowers 具备路径感知能力。没有它你在src/main/resources/application.yml文件里触发 superpowersCodex CLI 仍会尝试加载java-ast-indexer因为 language 是 java但该插件根本无法解析 YAML。有了这条规则CLI 会根据文件路径匹配发现不在**/src/main/java/**模式下便跳过 java 相关 superpower转而查询是否有yaml-schema-validator插件。实操中最容易被忽略的配置是agent.timeout_ms。默认 5000ms 在网络波动时极易超时导致 superpowers 响应失败。我将它调至 8000ms并添加重试逻辑在~/.codex/config.json中加入retry: {max_attempts: 2, backoff_ms: 1000}。但这不是万能解药——如果 Antigravity Agent 本身因内存不足 crash增加 timeout 只会让失败更慢。真正的根治方法是监控 Agent 日志journalctl -u antigravity -f | grep -E (CRITICAL|panic)发现out of memory就立刻调整其 JVM 参数ANTIGRAVITY_JVM_OPTS-Xmx2g -XX:UseG1GC。4. Cursor 与 Claude Code Desktopsuperpowers 的前端载体与模型执行层Cursor 和 Claude Code Desktop 是 superpowers 的前端呈现层Frontend Presentation Layer但它们的角色截然不同Cursor 是“能力调度台”Claude Code Desktop 是“模型执行沙盒”。Cursor 的核心价值在于superpower-aware editing experience。它不是简单地把 LLM 输出插入光标位置而是构建了一整套 superpower 生命周期管理 UICapability Discovery PanelCmdShiftP → “Show Superpowers”列出当前 workspace 所有可用 superpower 及其状态active/degraded/missingContext-Aware Trigger在 Java 文件中输入Valid后自动弹出spring-validatorsuperpower 的 quick-fix suggestionMulti-Step Workflow Builder选中代码 → 右键 → “Refactor with Superpowers” → 选择java-refactor-to-service→ 自动生成 service interface impl test stub。而 Claude Code Desktop 的角色是模型执行沙盒Model Execution Sandbox。它不直接响应 Cursor 的 superpower 请求而是作为 Antigravity Agent 的 backend provider。当你在 Cursor 中触发java-spring-validator流程是Cursor → Codex CLI → Antigravity Agent →java-spring-validator插件 → Claude Code Desktop通过 local IPC 或 HTTP 调用→ 返回 validated code。这就解释了为什么cursor提示词泄露成为热点问题Cursor 本身不存储提示词但 Claude Code Desktop 在本地运行时会将每次 superpower 请求的完整 prompt含当前文件 AST、project dependencies、user’s cursor position写入~/.claude-code/logs/prompt_history.json。如果用户未禁用日志这些敏感信息可能被意外上传或泄露。我做过对比测试在相同 superpowerpython-test-generator下Cursor Claude Code Desktop 的准确率比 Cursor Ollama 的高 23%但响应延迟多 410ms。原因在于 Claude Code Desktop 的 prompt engineering 更精细——它会动态注入当前 pytest 版本的 fixture signature、当前 virtualenv 中 installed packages 的 exact versions通过pip freeze --all获取而 Ollama 模型只能看到静态的 prompt template。提示Claude Code Desktop 的desktop模式本质是 Electron 封装的本地服务。它的--model参数指定的是本地模型路径如--model /models/claude-3-haiku.Q4_K_M.gguf而非 API endpoint。这意味着 superpowers 的性能瓶颈常在磁盘 IO模型文件大于 4GB 时首次加载需 12-18 秒。我的优化方案是预热在系统启动时运行claude-code-desktop --model /models/claude-3-haiku.Q4_K_M.gguf --preload让它后台加载模型到内存后续 superpower 调用即可秒级响应。关于cursor中文怎么设置和cursor设置中文这其实是个误导性问题。Cursor 的 UI 语言由系统 locale 决定但 superpowers 的输出语言由prompt 中的 language directive控制。例如你在 Java 文件中写注释// 生成校验逻辑用中文注释java-spring-validator插件会自动将生成的NotNull注释翻译为中文。真正的设置在 Codex CLI 的~/.codex/config.json中{ default_language: zh-CN, prompt_templates: { java-spring-validator: 请用{{.language}}生成 Spring Boot 校验逻辑包含中文注释... } }最后说说cursor pro有多少额度。Cursor Pro 订阅的本质是解锁remote superpower execution quota。免费版只能调用本地 Antigravity Agent 的插件而 Pro 用户可配置ANTIGRAVITY_REMOTE_URLhttps://api.cursor.dev/v1将复杂 superpower如full-project-refactor提交至云端集群执行获得更强算力和更大 context window。额度不是按 token 计费而是按superpower execution credits每个 credit 对应一次中等复杂度 superpower 调用如生成 200 行代码Pro 用户每月 500 credits超额后自动降级为本地执行模式。5. 实战排错从 “antigravity agent execution terminated due to error” 到 superpowers 全链路恢复上周我帮一位金融行业客户排查 superpowers 失效问题整个过程堪称 superpowers 生态的典型故障树。现象是Cursor 中所有 superpower 按钮灰显codex status显示全部 ❌终端反复报错antigravity agent execution terminated due to error.。这不是单一错误而是能力链路的多层坍塌。我按以下顺序逐层排查最终定位到根源——一个被忽略的 Linux kernel 参数。5.1 第一层Antigravity Agent 进程存活状态确认首先确认 Agent 是否真在运行ps aux | grep antigravity # 如果无输出说明进程已退出 systemctl status antigravity # 查看 systemd 状态通常显示 inactive (dead) journalctl -u antigravity --since 1 hour ago | tail -20 # 关键日志Mar 15 14:22:31 host antigravity[12345]: panic: runtime error: invalid memory address or nil pointer dereference这个 panic 日志指向 Go runtime 错误但antigravity是 Rust 编写的说明 panic 来自其依赖的 C 库如 OpenSSL。继续查strace -p $(pgrep antigravity) 21 | grep -E (open|connect|read) # 发现大量 connect(3, {sa_familyAF_INET, sin_porthtons(8080), ...}, 16) -1 ECONNREFUSED # 表明 Agent 尝试连接自身失败这是典型的 port conflict netstat -tuln | grep :8080 # 输出tcp6 0 0 :::8080 :::* LISTEN 1234/nginx # BingoNginx 占用了 8080 端口解决方案修改 Antigravity 配置~/.antigravity/config.toml[server] port 8081 # 改为 8081 host 127.0.0.1然后重启systemctl restart antigravity。但重启后仍报错journalctl显示新错误Mar 15 14:30:22 host antigravity[12346]: ERROR plugin java-ast-indexer: failed to load libjvm.so: dlopen failed: library libjvm.so not found5.2 第二层Java 插件依赖库加载失败libjvm.so是 JVM 的核心共享库路径通常在$JAVA_HOME/jre/lib/amd64/server/或$JAVA_HOME/lib/server/。检查echo $JAVA_HOME # /usr/lib/jvm/java-17-openjdk-amd64 ls $JAVA_HOME/lib/server/libjvm.so # No such file or directory ls $JAVA_HOME/lib/server/ # server.xml tools.jar ... # 缺少 libjvm.so这是 OpenJDK 17 的已知问题某些发行版打包时省略了该文件解决方案安装完整版 OpenJDKsudo apt install openjdk-17-jdk-headless # 该包包含 libjvm.so sudo update-alternatives --config java # 选择 headless 版本重启 Antigravity 后java-ast-indexer插件仍报错ERROR plugin java-ast-indexer: jvm version mismatch: expected 17.0.1, got 17.0.25.3 第三层JVM 版本严格校验失败Antigravity 插件对 JVM 版本做精确匹配非 semver 兼容因为不同 patch 版本的 JVM ABI 可能有微小差异。查看当前 JVMjava -version # openjdk version 17.0.2 2022-01-18 # OpenJDK Runtime Environment (build 17.0.28-Ubuntu-122.04)插件期望17.0.1但系统只有17.0.2。强行降级 JDK 风险大改插件源码又不现实。我的 workaround 是下载openjdk-17.0.1tar.gz解压到/opt/jdk-17.0.1修改插件配置~/.antigravity/plugins/java-ast-indexer/plugin.toml[jvm] home /opt/jdk-17.0.1 version 17.0.1重启 Agent。此时codex status显示java-ast-indexer✅但python-pyright-bridge仍 ⚠️。查日志ERROR plugin python-pyright-bridge: pyright not found in PATH5.4 第四层Python 插件依赖工具缺失Pyright 是 TypeScript 的类型检查器但python-pyright-bridge插件用它来分析 Python 类型注解通过 Pyright 的 Python mode。检查which pyright # 无输出 npm list -g pyright # empty安装npm install -g pyright # 但 npm 全局安装的 pyright 在 /usr/local/bin/pyright而插件默认找 /usr/bin/pyright sudo ln -s /usr/local/bin/pyright /usr/bin/pyright重启后所有 superpower 显示 ✅但在 Cursor 中触发仍无响应。抓包发现curl -X POST http://localhost:8081/capability/query \ -H Content-Type: application/json \ -d {superpower:java-spring-validator} # 返回{error:capability not found}5.5 第五层Capability Registry 未刷新Antigravity Agent 启动后不会自动扫描插件目录需手动触发curl -X POST http://localhost:8081/plugin/reload # 返回{status:ok,reloaded:3}此时codex status正常Cursor 中 superpower 按钮亮起。但首次调用仍超时。查 Antigravity 日志WARN agent::server: request timeout after 5000ms for capability java-spring-validator原来 Codex CLI 的agent.timeout_ms是 5000而java-spring-validator插件首次加载需 6200ms解析整个 Maven 依赖树。最终解决方案在~/.codex/config.json中设agent: {timeout_ms: 8000}在~/.antigravity/config.toml中设[plugin.java-ast-indexer] warmup_timeout_ms 10000重启所有服务。整个排错耗时 3 小时但收获巨大superpowers 不是魔法它是精密协作的工程系统。每个环节Agent 端口、JVM ABI、插件依赖、CLI 超时、registry 刷新都可能成为单点故障。真正的稳定性来自对每一层协议细节的掌控而非盲目堆砌工具。6. 超越安装superpowers 的工程化落地实践与团队协作规范在团队中推广 superpowers最大的陷阱是把它当作“个人效率工具”而非“协作协议基础设施”。我服务过的 3 个百人以上技术团队都经历了从“个人炫技”到“工程规范”的转变。以下是经过验证的落地实践。6.1 团队级 superpowers 配置即代码Configuration as Code禁止手动配置每个开发者的机器。我们采用GitOps for Superpowers在团队 monorepo 根目录创建.superpowers/目录该目录下存放antigravity-config.toml,codex-config.json,cursor-settings.jsonCI 流水线如 GitHub Actions在 PR 提交时运行superpowers-validate脚本检查所有配置文件语法正确toml lint,json validatecodex-config.json中声明的 superpower 插件其版本号在antigravity-plugins.lock中存在对应 hashcursor-settings.json中的快捷键不与公司安全策略冲突如禁用cmdenter触发远程执行。开发者只需运行./scripts/setup-superpowers.sh脚本会检查系统依赖JDK 17, Python 3.11, Node 18下载并安装 Antigravity Agent校验 SHA256git clone团队.superpowers/配置创建符号链接ln -sf $REPO/.superpowers/antigravity-config.toml ~/.antigravity/config.toml启动服务systemctl --user enable --now antigravity。这样新成员入职 15 分钟内即可获得与资深工程师完全一致的 superpowers 环境且所有变更受 Git 历史追溯。6.2 superpowers 的可观测性建设生产环境 superpowers 必须可监控。我们在 Antigravity Agent 中集成了 OpenTelemetry每次 superpower 调用生成 trace包含superpower.name,latency_ms,statussuccess/error/degraded关键指标暴露为 Prometheus metricsantigravity_superpower_calls_total{superpowerjava-spring-validator,statussuccess}antigravity_plugin_health_score{pluginpython-pyright-bridge}Grafana 看板实时展示各 superpower 的 P95 延迟、错误率、健康分趋势。当java-ast-indexer健康分跌破 0.7告警自动触发Slack 通知架构组自动运行诊断脚本检查 JVM heap usage、Maven repo 本地缓存大小、AST cache hit rate若确认是 cache 污染执行antigravity plugin reset-cache java-ast-indexer。6.3 安全边界superpowers 的沙盒化与数据隔离superpowers 天然涉及代码上下文传输必须建立安全边界网络隔离Antigravity Agent 默认绑定127.0.0.1:8080禁止0.0.0.0进程沙盒所有插件在firejail沙盒中运行限制网络、文件系统访问--netnone --private/tmp数据脱敏Codex CLI 在发送 context 给 Agent 前自动移除匹配正则(?i)(password|secret|token|key)[\s]*[:][\s]*[]([^])[]的行整个secrets/目录下的文件内容.env文件中所有变量值保留 keyvalue 替换为***。我们还制定了superpowers 使用红线❌ 禁止在生产环境代码库中启用full-project-refactorsuperpower可能重写核心逻辑❌ 禁止在含 PCI-DSS 数据的项目中启用># .github/workflows/ci.yml - name: Run Superpower Tests run: | if ! codex superpower test-generator --project ./src; then echo Superpower failed, falling back to manual review exit 1 fisuperpowers 的终极价值不在于它能多快生成代码而在于它如何让团队对“智能辅助”的边界达成共识。当每个开发者都清楚知道这个按钮按下后数据去了哪里、谁在执行、结果如何验证——那才是真正的 superpower。
