Superpowers 国产化指南：让 AI 编程从"瞎猜"变"工程化"

氧烷
0 阅读5分钟

Superpowers 国产化指南：让 AI 编程从"瞎猜"变"工程化"

一、为什么你的 AI 编程总是翻车？

让 AI 帮你写功能，它二话不说直接开干，结果做出来的东西根本不是你想要的——相信很多人都经历过。

典型场景：

你：给用户模块加个批量导出功能
AI：好的，我来实现...（直接开始写代码）
    export async function exportUsers() { ... }
你：等等，格式不对，没分页，大数据量会 OOM...

装了 Superpowers-zh 后：

你：给用户模块加个批量导出功能
AI：在开始实现之前，我需要了解几个关键问题：
    1. 导出格式是 CSV 还是 Excel？
    2. 预计数据量多大？需要异步处理吗？
    3. 有权限要求吗？
    → 给出 2-3 个方案，确认后再动手

二、Superpowers 核心：三阶段工作流

Superpowers 把软件开发拆解成三个关键阶段，每个阶段都有严格的"硬门"（Hard Gate），不通过不能进入下一步。

阶段 1：Brainstorming（头脑风暴）—— 想清楚再动手

核心规则：

  • ❌ 禁止写任何代码
  • ❌ 禁止创建任何文件
  • ✅ 必须通过问答理解需求
  • ✅ 必须提出 2-3 个方案并给出推荐
  • ✅ 必须分章节呈现设计并获得批准

示例：

你：我想做个待办事项应用
AI：正确做法
好的，在开始之前我想先了解几个问题：
1. 核心用户是谁？（个人/团队/客户）
2. 需要哪些核心功能？（CRUD/提醒/标签/协作）
3. 技术栈有偏好？（Web/移动端/桌面）
我们一个一个来，先回答第一个问题吧。

"Simple projects are where unexamined assumptions cause the most wasted work."

越是简单的项目，越容易因为未经验证的假设而浪费时间。

阶段 2：TDD（测试驱动开发）—— 红绿重构循环

铁律：

NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
没有先写失败的测试，就不允许写生产代码

RED-GREEN-REFACTOR 循环：

  1. RED（红）：写一个失败的测试，描述"应该发生什么"
  2. GREEN（绿）：写最少的代码让测试通过，不要过度设计
  3. REFACTOR（重构）：保持测试绿色，优化代码质量

"If you didn't watch the test fail, you don't know if it tests the right thing."

如果你没看着测试失败，你就不知道它是否测试了正确的东西。

阶段 3：Subagent-Driven Development（子代理驱动开发）—— 让 AI 自主工作

核心机制：

  1. 任务分解：把计划拆成 2-5 分钟能完成的小任务
  2. 子代理执行：每个任务派发给一个"新鲜"的子代理
  3. 两阶段审查：第一阶段审查是否符合设计规范，第二阶段审查代码质量

为什么有效？

  • 每个子代理有隔离的上下文，不会被污染
  • 专业分工：实现的只管实现，审查的只管审查
  • 强制审查：不通过就不能继续

三、国产化推荐

Superpowers 中文版（superpowers-zh）

GitHub：github.com/jnMetaCode/…

完整汉化 + 6 个中国原创 skills，支持 14 款 AI 编程工具。

类型数量说明
翻译 Skills14 个头脑风暴、TDD、执行计划、代码审查等
中国特色 Skills6 个中文代码审查、中文 Git 工作流、中文技术文档、中文提交规范、MCP 服务器构建、工作流执行器
支持的工具

OpenClaw / Claude Code / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / Qwen Code / Antigravity

安装方式

方式一：npm 一键安装（推荐）

cd /your/project
npx superpowers-zh

程序会自动检测项目使用的工具，将 20 个 skills 安装到正确位置。

方式二：手动安装

针对不同工具，复制 skills 到对应目录：

# Trae
cp -r superpowers-zh/skills /your/project/.trae/rules

# Qwen Code（通义灵码）
cp -r superpowers-zh/skills /your/project/.qwen/skills

# Claude Code
cp -r superpowers-zh/skills /your/project/.claude/skills

# Cursor
cp -r superpowers-zh/skills /your/project/.cursor/skills
如何导入 Trae
  1. 访问 superpowers-zh，下载或克隆项目
  2. 在终端运行 npx superpowers-zh，或手动复制 skills 目录到 .trae/rules
  3. 重启 Trae，skills 自动加载

推荐理由：Superpowers 最大的价值在于把"成熟的软件工程实践"转化为 AI 能理解和执行的强制流程。国产版本新增了中文代码审查、中文 Git 工作流、中文提交规范等国内团队急需的 skills。

其他推荐 Skills

1. Everything

全项目文件搜索与导航利器，支持：

  • 秒级全文检索
  • 正则表达式支持
  • 文件类型过滤
  • 快速跳转到定义处

适用场景：大型项目快速定位代码，无需手动查找文件。

2. GSD（Git Smart Diff）

智能 Git 操作助手，支持：

  • 智能暂存（Smart Staging）
  • 自动生成规范的 Commit Message
  • 分支状态可视化
  • 冲突智能解析

适用场景：规范 Git 提交流程，提升团队协作效率。

四、立刻上手的 3 个技巧

技巧 1：5 分钟设计会议

"给我 3 个实现方案，分别说明：优点、缺点、适用场景、你的推荐"

技巧 2：测试契约

"写任何功能前，我们先写测试。如果测试不能先失败，就不允许写实现代码。"

技巧 3：审查清单

"请用这个清单审查你的代码：
□ 是否符合设计文档？
□ 有没有未使用的代码？
□ 测试覆盖率多少？
□ 有没有边界情况没测试？
□ 命名是否清晰？
□ 有没有更简单的实现方式？"

五、结语

Superpowers 不是万能的，但它代表了一个核心理念：

  • 先思考，再行动
  • 用流程保证质量，而不是依赖自觉
  • 让审查成为习惯，而不是负担

AI 编程不是要取代程序员，而是要放大程序员的能力。当你看到 AI 能自主工作 2 小时不翻车，当你不再为 AI 写的代码擦屁股时——这套方法，真香。

avatar
文章
阅读
粉丝