20 个 AI 编程超能力,让你AI 工具真正会干活superpowers-zh 详细教程
在日常开发中,直接让AI工具生成代码往往会导致格式错误、边界情况缺失或大数据量下的内存溢出(OOM)等问题。这主要是因为AI掌握了语法,却缺乏工程化的工作方法论。Superpowers-zh 作为一个包含156k+ stars的开源项目的中文社区版,提供了20个经过实战验证的“Skills”(技能)。它不局限于教导AI框架用法,而是重点传授如何进行需求分析、测试驱动开发(TDD)、系统化调试及代码审查等完整工作流。目前该项目支持 Claude Code、Cursor、Copilot 等16种主流AI编程工具,旨在帮助开发者解决AI生成代码不可控的痛点。
01核心差异:从执行指令到工程化协作
| 维度 | 未安装 Superpowers-zh | 已安装 Superpowers-zh |
|---|---|---|
| 用户指令 | "给用户模块加个批量导出功能" | "给用户模块加个批量导出功能" |
| AI行为 | 直接写代码,未考虑分页,导致大数据量 OOM | 先询问:导出格式?数据量级?是否需要异步处理?给出2-3个方案,确认后动手 |
| 最终结果 | 反复修改,浪费开发时间 | 方案清晰,一次到位,质量可控 |
安装前后AI工作模式对比
Superpowers-zh 涵盖了软件开发的完整生命周期,其核心能力可归纳为五大类,包含14个汉化版Skills和6个针对中国开发者原创的Skills。这些技能共同构成了一个严格的工程化体系,其中包含三条不可逾越的“铁律”:设计先行(未批准设计前不写代码)、测试先行(未写失败测试前不写生产代码)、证据先行(声称完成前必须验证并给出证据)。
02技能矩阵:覆盖全生命周期的20个方法论
五大技能分类体系
需求与设计
强调动手前的深度思考,确保方案可行性。
- 头脑风暴:需求分析 → 方案对比 → 设计规格文档。
- 编写计划:将规格拆解为可执行步骤(每步2-5分钟),禁止占位符。
编码与实现
规范编码过程,引入并行与分支管理策略。
- 执行计划:逐步实施,每3个任务进行一次审查。
- 测试驱动开发 (TDD):遵循红-绿-重构循环,无失败测试不写代码。
- 子Agent驱动:派遣独立Agent执行任务,进行双重审查。
- Git Worktree:使用Worktree隔离特性开发。
质量保障
通过系统化手段确保代码与系统的稳定性。
- 系统化调试:根因定位 → 模式分析 → 假设验证 → 实施修复。
- 代码审查:派遣Agent检查提交质量,按优先级处理反馈。
- 完成前验证:跑测试、Lint及构建,禁用“应该没问题”等模糊措辞。
中国特色原创
适配国内团队文化与工具链,优化协作体验。
- 中文代码审查:平衡技术严谨与团队和谐,使用建议而非命令。
- 中文Git工作流:适配Gitee/Coding等平台,支持多种工作流模式。
- 中文技术文档:规范中文排版与中英混排规则。
- 中文提交规范:Type用英文,Scope和Subject用中文。
- MCP构建:提供MCP服务器构建方法论。
- 工作流执行器:在工具内直接运行多角色YAML工作流。
03安装指南与工具适配
Superpowers-zh 提供了灵活的安装方式以适应不同的开发环境。脚本会自动检测项目中使用的AI工具(通过.claude/、.cursor/等目录判断),并将Skills安装到正确位置。
- 方式一:npx 安装(推荐)
在项目根目录下执行npx superpowers-zh,脚本会自动完成环境检测与安装。 - 方式二:手动安装
克隆仓库后,将 skills 目录复制到对应工具的配置目录中(如 .claude/skills/ 或 .cursor/skills/)。 - 方式三:配置文件引用
在 CLAUDE.md 或 GEMINI.md 中按需引用特定 Skill 文件,实现轻量化加载。
| 工具名称 | 类型 | Skills 目录 |
|---|---|---|
| Claude Code / Copilot CLI | CLI | .claude/skills/ |
| Cursor / Windsurf / VS Code | IDE | .cursor/skills/ / .windsurf/skills/ / .github/superpowers/ |
| Hermes / Gemini / Codex | CLI | .hermes/skills/ / .gemini/skills/ / .codex/skills/ |
| OpenClaw / DeerFlow | Framework / CLI | skills/ / skills/custom/ |
部分主流工具安装位置对照
04实战应用:标准开发工作流
在实际应用中,Superpowers-zh 定义了一套从需求到上线的闭环工作流。当用户提出需求时,AI不再直接编写代码,而是按照以下逻辑链路执行:
- NaN年1日
- NaN年2日
- NaN年3日
- 查看全部进展
当前文章无评论,是时候发表评论了