乐于分享
好东西不私藏

分享一个超好用的 AI 编程 skills 框架,让助手真正会干活

分享一个超好用的 AI 编程 skills 框架,让助手真正会干活

你好啊,我是枫哥~十年互联网程序员,懒癌患者,不定期分享效率工具,AI 编程,web 逆向等内容,期待与你进行交流

字数 1649,阅读大约需 9 分钟

最近 AI 编程工具越来越火,Claude Code、Cursor、Copilot 等等,用起来确实爽,敲几下键盘代码就出来了。

但用久了你会发现,AI 写代码挺厉害,但让它完整做个功能,就容易翻车

不是这里漏了异常处理,就是那里忘了输入验证。代码审查也是,问它有没有问题,它说写得不错,结果一上线全是 bug。

问题不在 AI 笨,而是缺少系统化的工作方法。

它不知道什么时候该思考、什么时候该动手、什么时候该验证。

今天给大家介绍一个 GitHub 超火的 AI 编程 skills 框架 — superpowers-zh

完整汉化 superpowers(99k+ ⭐)并且 新增 5 个中国原创 skills• 支持 Claude Code / Cursor / Codex / Kiro 等主流工具

简单说,它不是教 AI 写代码,而是教 AI 怎么干活。相当于给 AI 助手培训一套标准化的工作流程。

先看看痛点

你有没有遇到过这些情况:

让 AI 写个功能

superpowers-zh 是什么

简单说,它不是教 AI 写代码,而是教 AI 怎么干活

完整翻译了英文版的 14 个 skills,还新增了 5 个中国原创 skills:

类别
Skills
需求分析
头脑风暴、编写计划
开发实施
执行计划、测试驱动开发、子 Agent 驱动开发
质量保障
系统化调试、代码审查、完成前验证
版本管理
Git Worktree、完成开发分支
中国特色
中文代码审查、中文 Git 工作流、中文技术文档、中文提交规范、MCP 服务器构建

实际案例演示

案例一:用「头脑风暴」做需求分析

❌ 传统方式

你:帮我做个文件上传功能AI:好的,这是代码...(直接开写)

✅ 使用头脑风暴 Skill

你:/brainstorm 帮我做个文件上传功能AI(进入头脑风暴模式):1️⃣ 先明确需求边界   - 支持哪些文件格式?   - 文件大小限制?   - 存储位置(本地/云存储)?2️⃣ 识别潜在风险   - 文件类型校验(防止恶意上传)   - 文件名处理(防止路径遍历攻击)   - 并发上传处理3️⃣ 输出设计规格   - 接口定义   - 数据模型   - 异常处理策略

效果对比:传统方式可能直接写出有安全漏洞的代码;头脑风暴模式先想清楚再动手,避免后期返工。


案例二:用「系统化调试」定位 Bug

❌ 传统方式

你:这个接口返回 500 错误AI:我帮你加了个 try-catch结果:错误被吞掉了,问题还在

✅ 使用系统化调试 Skill

你:/systematic-debugging 这个接口返回 500 错误AI(进入四阶段调试法):🔍 阶段一:定位   - 错误发生在哪个环节?   - 查看日志、堆栈信息🔍 阶段二:分析   - 可能的原因有哪些?   - 输入数据、数据库连接、外部依赖...🔍 阶段三:假设   - 最可能的原因是 X   - 验证假设的方法...🔍 阶段四:修复   - 针对性修复   - 添加回归测试

效果对比:传统方式治标不治本;系统化调试找到根因,避免同样的问题反复出现。


案例三:用「中文代码审查」提升代码质量

❌ 传统审查

AI:代码写得很好!👍(实际漏掉了 5 个潜在问题)

✅ 使用中文代码审查 Skill

你:/chinese-code-review 帮我审查这段代码AI(按照国内团队文化规范):✅ 做得好的地方:   - 命名清晰   - 函数拆分合理⚠️ 建议改进:   1. 第 23 行:缺少空值检查(可能导致 NPE)   2. 第 45 行:SQL 拼接有注入风险,建议用参数化查询   3. 第 67 行:循环内查询数据库,建议批量处理💡 优化建议:   - 可以提取为公共方法   - 考虑添加缓存

效果对比:符合国内团队沟通文化,既指出问题又不伤人,技术严谨 + 情商在线。


快速上手

一步安装

cd /your/projectnpx superpowers-zh

或手动配置

# 克隆仓库git clone https://github.com/jnMetaCode/superpowers-zh.git# 复制到你的 AI 工具(以 Claude Code 为例)cp -r superpowers-zh/skills /your/project/.claude/skills

支持的工具

工具
配置方式
Claude Code
.claude/skills/
Cursor
.cursor/skills/
Codex CLI
~/.agents/skills/
Kiro
.kiro/steering/
DeerFlow
skills/custom/
Trae
.trae/rules/
VS Code Copilot
.github/copilot-instructions.md

使用建议

什么时候用哪个 Skill?

场景
推荐 Skill
接到新需求,还没想清楚
头脑风暴 → 编写计划
开始写代码
执行计划 / 测试驱动开发
遇到 Bug
系统化调试
代码写完了
完成前验证 → 请求代码审查
准备合并代码
完成开发分支

最佳实践

  • • 不要跳过思考阶段:头脑风暴和编写计划看起来”浪费时间”,但能避免后期大量返工
  • • 验证先行:声称完成前,先跑验证
  • • 审查是学习机会:接收代码审查时,技术严谨地处理反馈

真实体验

我实际测试了几个 skills,说下感受:

头脑风暴 — 确实能帮 AI 先想清楚再动手,避免写了一半发现需求理解错了。适合复杂需求,尤其是那种一开始说不清楚要做啥的场景。

系统化调试 — 四阶段法很实用,不是直接给答案,而是带着 AI 一步步定位根因。用这个修过几个棘手的 bug,效率比瞎猜高多了。

中文代码审查 — 这个挺有意思,符合国内团队的沟通方式,不会太直接伤人,但技术点都指出来了。拿来给团队成员做 code review 挺合适。

子 Agent 驱动开发 — 这个比较高级,每个任务分配一个 agent,自动做两轮审查。适合大项目拆分成多个模块并行开发。

使用建议

  • • 复杂需求、重要功能建议用上这套流程,能避开不少坑
  • • 简单功能、原型验证就没必要了,直接让 AI 写更快
  • • 需要 AI 工具支持 skill 系统(Claude Code、Cursor、Codex 等主流工具都支持)

总体来说,这套框架能让 AI 编程更靠谱,尤其是团队协作的时候,有个标准化的流程会省心很多。推荐试试。


相关链接

  • • GitHub: https://github.com/jnMetaCode/superpowers-zh
  • • NPM: https://www.npmjs.com/package/superpowers-zh
  • • 原始项目: https://github.com/obra/superpowers

作者介绍

  • 枫哥,90 后奶爸,十年互联网程序员。
  • 专注分享:效率工具,AI 编程,逆向技术。
  • 如果你想与我交流,欢迎加我微信~备注:公众号。