Superpowers Lite

简体中文 | English

Keep the engineering discipline. Remove the workflow ceremony.

Superpowers Lite 是一个面向 Codex 与 GPT-5.6 工作流的精简兼容版开发插件。它保留需求澄清、计划、调试、TDD（测试驱动开发）和完成前验证等核心方法，同时减少原版在当前工具接口下容易产生的强制流程、重复路由和无效工具调用。

这是基于 Jesse Vincent 的 Superpowers 进行改造的非官方、独立维护版本，不隶属于原项目，也不代表原作者背书。

为什么做这个版本

原版 Superpowers 强调高度结构化的软件开发流程，这对大型、复杂任务很有价值。但在 Codex 的 GPT-5.6 工作流中，部分规则会与模型原生的任务规划、工具编排和上下文判断重叠；某些流程还假设固定的 subagent 参数、Git worktree、提交、评审或分支收尾链条始终可用。

Superpowers Lite 的目标不是宣称全面替代原版，而是提供一个更适合当前 Codex 工具接口的兼容分支：保留工程纪律，让流程强度随任务风险变化。

这些精简与兼容性调整，是在核对 OpenAI 的 GPT-5.6 官方提示指南，以及新版 ChatGPT Codex 的技能路由、插件、代码评审和任务执行机制后做出的。

针对 GPT-5.6 工作流的改进

改进	Superpowers Lite 的处理方式	实际收益
工具参数兼容	以当前会话暴露的 tool schema 为准；缺少 model、reasoning_effort 等参数时直接省略，继承默认设置或在当前 agent 内执行	避免因旧接口假设产生参数错误和重复重试
精确路由	Codex 直接按各 skill 的描述匹配；using-superpowers 仅作为显式导航入口	减少母路由重复加载和流程循环
单一流程控制	每个阶段只由一个 process skill 主导，其他 skill 提供局部约束	降低规则叠加、优先级冲突和上下文占用
比例化流程	小型、低风险、可逆任务允许直接检查、修改、验证；复杂任务再升级到完整规划	简单任务更快，复杂任务仍保留控制点
有意义的 TDD	可执行行为且存在合适测试入口时采用 Red-Green-Refactor；文档、提示词、配置和无有效测试入口的小改动使用针对性验证	避免为了形式而新增无价值测试或依赖
状态化验证	相关代码、测试、配置、依赖或环境未变化时，已有证据保持有效；变化后只重跑受影响验证	减少机械重复测试，同时维持完成声明的证据链
可选高级编排	不强制 subagent、worktree、commit、code review 或 branch-finishing 流程	尊重用户授权与当前任务边界，降低外部副作用

以本仓库基于的 Superpowers 6.1.1 为比较基线，原版包含 14 个 SKILL.md、约 18,516 个英文词；Lite 保留 7 个核心 skill、约 1,335 个英文词，文本规模减少约 93%。这个数字表示规则与上下文更精简，不等同于功能覆盖率或质量评分。

包含的 skills

• using-superpowers：仅在显式调用时帮助选择主要工作流
• brainstorming：在产品行为或架构尚未明确时澄清目标与方案
• writing-plans：为多步骤工作编写轻量、可验证的实施计划
• systematic-debugging：先建立证据和根因，再修改
• test-driven-development：在适用时执行 Red-Green-Refactor
• receiving-code-review：先核实评审意见，再决定接受、调整、拒绝或请求决策
• verification-before-completion：用最新、相关的证据支持完成声明

安装

当前版本可通过 Codex 本地个人 marketplace 安装。插件安装适用于 ChatGPT 桌面版中的 Codex/Work mode 和 Codex CLI；IDE extension 当前不能直接安装 插件，如有需要可单独安装其中的 skills。参见 OpenAI 插件文档。

1. 克隆到个人插件目录：

   git clone https://github.com/Isadorah01/superpowers-lite ~/.codex/plugins/superpowers-lite

2. 创建 ~/.agents/plugins/marketplace.json。若文件已有其他插件，只把 superpowers-lite 条目合并进现有 plugins 数组，不要覆盖原内容。

   {
     "name": "personal",
     "interface": {
       "displayName": "Personal"
     },
     "plugins": [
       {
         "name": "superpowers-lite",
         "source": {
           "source": "local",
           "path": "./.codex/plugins/superpowers-lite"
         },
         "policy": {
           "installation": "AVAILABLE",
           "authentication": "ON_INSTALL"
         },
         "category": "Developer Tools"
       }
     ]
   }

3. 安装插件：

   codex plugin add superpowers-lite@personal

4. 新建 Codex 任务，让新 skill 在干净上下文中加载。

使用原则

• 只在任务确实需要时启用对应 skill。
• 当前会话的工具 schema 是接口事实来源。
• 不把小改动强行升级为大型工程流程。
• 不因流程模板自动获得提交、推送、部署或删除权限。
• 完成声明必须对应最新且相关的验证证据。

上游来源与许可证

本项目派生自 obra/superpowers，比较和改造基线为 6.1.1。上游作者为 Jesse Vincent，原项目采用 MIT License。

本仓库保留上游版权声明和 MIT License，详见 LICENSE。“Superpowers Lite” 是独立维护的兼容分支；如需原版的完整工作流、subagent 编排、worktree 和代码评审链条，请使用上游项目。

状态

当前版本为 0.2.0，优先服务个人 Codex 工作流。公开发布的重点是透明记录差异、便于审阅和复用；后续变更应继续保持小范围、可验证和向后可理解。