Superpowers Multi-AI：面向多种编码代理的提示工程框架

RectangleStory/Superpowers_Multi_AI

别再「vibe coding」（译注：vibe coding 由 Andrej Karpathy 提出，指完全凭直觉和感觉、让 AI 直接生成代码而不深入思考的编程方式）了，也别再把 AI 拖进那种胡言乱语、死循环不断的混乱状态。

Superpowers AI 是一个生产级、模块化、纪律严明的框架（framework），目标只有一个，把原生的大语言模型（vanilla LLMs，比如 Claude Code、Cursor、GitHub Copilot）改造成有条理、懂上下文的资深工程师。它会注入确定性的行为关卡（deterministic behavioral gates），逼着 AI 在动手写生产代码之前先规划、隔离、再系统化地调试。

快速上手与下载

立即获取完整的独立生产包，里面有自动化的 GUI/CLI 启动器和预先配置好的核心技能模块（skill modules）。

📥 下载 SUPERPOWERS.ZIP

安装说明

1. 解压并移动，把 Superpowers.zip 解压到当前开发项目的根目录下。
2. 执行启动器，在项目环境里运行 run_launcher.exe。
3. 选择配置文件，从交互式菜单里挑一个目标 AI IDE/CLI 环境。
- Option 1 对应 Cursor 编辑器，会生成 .cursorrules。
- Option 2 对应 Claude Code CLI / 通用 AI，会生成 .ai-skills.md。
4. 部署，原生可执行程序会自动把 skills/ 文件夹下的所有模块化技能聚合成一份统一的系统提示矩阵（system prompt matrix）。下一次交互时，AI 智能体（agent）就能立刻读取这个状态。

系统架构与工作流管道

这个框架用一套结构化的软件开发生命周期（Software Development Life Cycle，SDLC）管道，替换掉了标准的对话式接口。AI 智能体不再直接吐出未经校验的代码片段，必须穿过一道道严格的质量校验关卡。

[ 用户提示 / 功能需求 ]
        │
        ▼
┌──────────────────────────────┐
│   01_brainstorming.md        │ -> 关卡 1：架构冻结（GATE 1: Architecture Freeze）
│   （苏格拉底式对话与提问）     │            必须获得用户明确批准
└──────────────┬───────────────┘
               │ 已批准
               ▼
┌──────────────────────────────┐
│   02_writing_plans.md        │ -> 关卡 2：微型 Jira 清单（GATE 2: Micro-Jira Checklist）
│   （原子化步骤与测试）         │            线性任务承诺
└──────────────┬───────────────┘
               │ 逐步骤获得批准
               ▼
┌──────────────────────────────┐
│   03_subagents.md            │ -> 上下文隔离（CONTEXT ISOLATION）
│   （沙箱化子智能体生成）       │            避免 token 膨胀造成的死循环
└──────────────┬───────────────┘
               │ 构建失败 / 测试回归
               ▼
┌──────────────────────────────┐
│   04_debugging.md            │ -> 根因分析（ROOT CAUSE ANALYSIS）
│   （严格的四阶段协议）         │            禁止猜测式补丁

核心技能模块深入剖析

skills/ 目录下的每一个模块，都用绝对化、高度命令式的散文风格写成，专门为当下最先进的大语言模型做了优化。

综合规格矩阵

模块 01（01_brainstorming.md）

- 目标角色，首席软件架构师（Principal Software Architect）
- 核心系统约束，严格的架构冻结（STRICT ARCHITECTURAL FREEZE）。在用户回答 3–5 个结构性边界问题之前，绝对禁止生成原始代码。

模块 02（02_writing_plans.md）

- 目标角色，敏捷技术负责人 / Scrum Master
- 核心系统约束，线性执行关卡（LINEAR EXECUTION GATE）。强制要求制定严格的逐步清单（checklist），包含精确的文件路径、明确的修改内容以及准确的验证命令。

模块 03（03_subagents.md）

- 目标角色，主编排节点（Main Orchestration Node）
- 核心系统约束，上下文窗口污染控制（CONTEXT WINDOW POISON CONTROL）。为繁重的代码修改任务生成隔离的、单一用途的子智能体（sub-agents），维持高 token 纯度。

模块 04（04_debugging.md）

- 目标角色，资深 QA 自动化专家
- 核心系统约束，反猜测禁令（ANTI-GUESSWORK INTERDICTION）。禁止大面积替换代码。强制执行四步流程，定位（Localization）→ 假设（Hypothesis）→ 外科手术式修复（Surgical Fix）→ 测试验证（Test Validation）。

提取后的目录结构

解压 Superpowers.zip 之后，本地项目结构长这样。

your-project-workspace/
│
├── run_launcher.exe         # 用于目标配置文件的原生自动化启动器
├── README.md                # 详尽的开发者文档（即本文件）
│
└── skills/                  # 模块化行为技能仓库
    ├── 01_brainstorming.md  # 架构发现阶段与查询参数
    ├── 02_writing_plans.md  # 细粒度原子化步骤规划与验证映射
    ├── 03_subagents.md      # 工作节点的生命周期编排与沙箱化
    └── 04_debugging.md      # 事后分析与根因调查

生态目标映射

Superpowers AI 通过把自己改造成各生态的标准结构化配置，原生扩展到了最主流的几个智能体编程层。

- Cursor 编辑器，生成项目级 .cursorrules 配置文件，强制 Composer 与 Chat 功能进入结构化执行模式。
- Claude Code CLI，通过自动化的 .ai-skills.md / CLAUDE.md 元数据注入规则映射到系统配置中。
- GitHub Copilot Workspace，直接注入 .github/copilot-instructions.md 配置节点。
- 本地运行环境（Ollama / Open WebUI），提供可直接在自定义 Modelfile 中解析的原始系统提示矩阵。

常见问题解答（FAQ）

问：为什么我的 AI 拒绝立即写代码？答：这正是设计初衷。01_brainstorming 模块会在你明确底层结构性约束之前，有意阻塞代码生成。这能消掉后续 90% 的架构重写。

问：我能不能临时绕过框架规则？答：可以。如果你需要快速、直接的答案或脚本，不想走正式流程校验，就在提示里任意位置敲上全局覆写系统关键词，FORCE_RAW_MODE。

问：run_launcher.exe 需要联网吗？答：完全不需要。run_launcher.exe 是一个轻量级、已编译的独立工具，在本地运行，专门用来拼接配置 schema。它不会联网，也不会向你的环境之外传输任何遥测数据。

许可证

本项目基于 BSD 3-Clause 许可证（BSD 3-Clause License）授权，详情见下文。

以源代码和二进制形式进行再分发（无论是否修改）都是允许的，但必须满足以下条件。

- 以源代码形式再分发时，必须保留上述版权声明、本条件列表以及以下免责声明。
- 以二进制形式再分发时，必须在随分发提供的文档和/或其他材料中复制上述版权声明、本条件列表以及以下免责声明。
- 未经特定的事先书面许可，版权持有者的名称以及贡献者的名称不得用于为基于本软件衍生的产品背书或进行推广。

本软件由版权持有者和贡献者按「原样」（AS IS）提供，明示或暗示的任何保证（包括但不限于对适销性和特定用途适用性的暗示保证）均被免责。在任何情况下，无论基于何种责任理论（合同、严格责任还是侵权行为，包括疏忽等），版权持有者或贡献者均不对因使用本软件而产生的任何直接、间接、附带、特殊、惩戒性或后果性损害（包括但不限于采购替代商品或服务、使用数据或利润的损失、业务中断）承担责任，即使已被告知此类损害的可能性。