什么值得买App下载 App ›
连续签到专享现金活动

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安装到正确位置。
  1. 方式一:npx 安装(推荐)
    在项目根目录下执行 npx superpowers-zh,脚本会自动完成环境检测与安装。
  2. 方式二:手动安装
    克隆仓库后,将 skills 目录复制到对应工具的配置目录中(如 .claude/skills/ 或 .cursor/skills/)。
  3. 方式三:配置文件引用
    在 CLAUDE.md 或 GEMINI.md 中按需引用特定 Skill 文件,实现轻量化加载。
工具名称类型Skills 目录
Claude Code / Copilot CLICLI.claude/skills/
Cursor / Windsurf / VS CodeIDE.cursor/skills/ / .windsurf/skills/ / .github/superpowers/
Hermes / Gemini / CodexCLI.hermes/skills/ / .gemini/skills/ / .codex/skills/
OpenClaw / DeerFlowFramework / CLIskills/ / skills/custom/

部分主流工具安装位置对照

04实战应用:标准开发工作流
在实际应用中,Superpowers-zh 定义了一套从需求到上线的闭环工作流。当用户提出需求时,AI不再直接编写代码,而是按照以下逻辑链路执行:
  • NaN年1日
  • NaN年2日
  • NaN年3日
  • 查看全部进展

评论

评论区空态插画

当前文章无评论,是时候发表评论了