乐于分享
好东西不私藏

这三个开源工具让你的AI不再写屎山代码

这三个开源工具让你的AI不再写屎山代码

大家好,我是柿子👋,这是我写的第45篇原创!感谢大家每一次的阅读与点赞,话不多说,我们开始!

上周我打开三个月前用 Claude Code 起的项目,准备让它顺手修一个登录态的小 bug。

结果它先把一个核心依赖删了,又把验证逻辑挪到了另一个文件,第三轮回答开始一本正经地解释一个根本不存在的函数。

我盯着屏幕,第一次真切感到那种割裂——前一个月我用它两小时写出原型,那时它像个天才;三个月后,它像个失忆症患者,把整个项目当成自己第一次见到的陌生人。

这不是 AI 模型变笨了,是我们用 AI 的方式从一开始就缺了一层骨架。

今天这篇,把我最近真正用顺手的开源三件套写清楚。新手抄作业级别,进阶可以叠加。一篇看完,知道先装哪个、什么时候加下一个、为什么这样选。

先把症状摆出来:AI 编码的三种死法

第一种叫 vibe coding.

你打开聊天框,凭感觉敲一句「帮我做个登录页」,AI 配合得很好,五分钟出代码。项目小的时候这没问题,一旦功能多起来,需求和实现之间的差距开始指数级扩大。AI 也不知道你最初想的是什么,只能按这一轮你说的话猜。

第二种叫上下文丢失。

每次重启 IDE,AI 都像换了一个新员工。你已经在心里跑了一百遍的业务逻辑、表结构、约束条件,得重新解释一遍。讲得久了,对话变长,AI 又开始把早期的话忘掉。这一来一回,时间全花在了「重新教 AI 我们是谁」上。

第三种叫代码质量失控。

刚跑通的时候每一行都看了,舒服。三个月后回头看,命名风格三种、错误处理两套、测试只有最早写的那批还能跑。等你想重构,AI 给你的方案是从头再写一遍。

这三种死法,市面上很多人归咎于模型不够强。但实际我用下来的体感是——模型已经够强了,是我们没有给它一个写代码之前必须遵守的工程框架。

解药叫 SPEC 规范开发

SPEC 规范开发(Spec-Driven Development,简称 SDD)的核心一句话能讲完:

先写清楚需求、计划、验收标准,再让 AI 严格按规范执行。

这不是什么新概念。资深工程师团队从来都是先有 PRD 再开工。但单兵作战的 AI 独立开发者很容易跳过这一步——因为对面是 AI,反正问错了再问一次嘛。

问题是,AI 不会替你记住「再问一次」的成本。每一次跳过设计直接动手,都在给项目埋一颗后期重构地雷。

SPEC 这套方法论,本质是把 AI 从一个临时工升级成一个按规矩干活的正式员工——它干活前先看规范,干活中按规范走,干完用规范验收。

现在的好消息是,落地这套方法论的开源工具已经成熟到能让新手 5 分钟装完。下面这三件套,分别解决「记忆」、「纪律」、「标准」三层问题,是我目前最推荐的组合。

第一件:OpenSpec,给 AI 装上记忆层

OpenSpec 是新手最容易上手的一件,轻量、自动化、无侵入。

它的核心思路一句话:把 PRD、计划、任务都结构化管理,每次变更沉淀成可复用的 SPEC 文件,AI 子任务直接读取,告别每次重启都重新解释世界。

安装两行命令:

``bashnpm install -g @fission-ai/openspecopenspec init`

新手最爱它的点有四个:

  • 主流工具的斜杠命令都支持,Claude Code、Cursor、Codex 都能用 /opsx: propose、/opsx: archive

  • 自动生成提案文档、任务清单、规范增量文件,变更历史一目了然

  • 内置校验和归档,防止 SPEC 文档变成没人看的坟场

  • 多个工具能共享同一套规范,团队协作友好

工作流程也很清晰:提案 → 人工审查 → 归档更新 SPEC → AI 读取执行。

我自己用下来的真实体感:OpenSpec 等于给 AI 加了一层不会被重置的记忆。你今天写的规则、约定、技术选型,下个月新对话直接接着用,不用重新教。

GitHub:https://github.com/Fission-AI/OpenSpec 

适合阶段:项目刚开始 → 让 SPEC 跟着代码一起长。哪怕只是一个周末小项目,先 init 一下都不亏。

第二件:Superpowers,给 AI 装上工程纪律

如果说 OpenSpec 是记忆层,Superpowers 就是执行纪律。

这是一个 agentic skills 框架加软件工程方法论的合体,GitHub 已经 14.5 万星,是 Claude Code 官方认证插件,由 Jesse Vincent 主导。它强制 AI 按完整工程流程工作,而不是上来就狂敲代码。

核心理念可以浓缩成一句话:先思考、再计划、TDD 执行、双重审查。

它的 7 阶段强制流水线,新手直接抄就行:

  1. Brainstorming——苏格拉底式追问,把模糊需求细化成设计文档,确认后才往下

  2. Git Worktree——自动新建隔离分支,避免改坏主代码

  3. Writing Plans——任务拆成 2-5 分钟一个的原子单元,精确到文件路径和代码片段

  4. Subagent-Driven 加 TDD——子 Agent 先写失败测试,再写代码,再让测试通过,跳过测试的代码直接删

  5. Two-Stage Review——先查是否符合 SPEC,再查代码质量,Critical 问题直接卡住流程

  6. Finish——跑测试、自动 PR 或合并

X 上有句话评价它特别准:Superpowers 让 AI 像资深团队一样工作,先写 spec、评审计划、TDD、审查、Git 管理一条龙。

安装也很简单:

text /plugin marketplace add obra/superpowers-marketplace /plugin install superpowers @superpowers-marketplace 

GitHub:https://github.com/obra/superpowers

Superpowers 和 OpenSpec 的关系,是这篇文章我最想讲清楚的一个点:

OpenSpec 管「记忆和规格」,Superpowers 管「执行和纪律」。一个负责把要做的事沉淀下来,一个负责把每一步动作约束住。两者完全不冲突,是互补关系。

适合阶段:项目变大、模块多起来、自己审不动了 → 让纪律帮你审。

第三件:Addy Osmani 的 agent-skills,注入大厂规范

最后一件,是我认为最适合「抄作业」的技能库。

Addy Osmani 是 Google 前工程总监,他把 Google 内部 19 到 23 个工程技能打包成 Markdown 文件,直接注入 AI,让 AI 强制按大厂标准交付。

核心是 7 个斜杠命令:

  • /spec:先写 PRD、需求、验收标准

  • /plan:拆任务、排依赖

  • /build:增量实现、红绿重构

  • /test 和 /review:质量门禁、安全检查

  • /code-simplify:降低复杂度

  • /ship: Git 工作流、发布 checklist

除了斜杠命令,配套还有:

  • grill-with-docs:写 SPEC 之前先和 Agent 深度对齐,采访式提问

  • interview-me、idea-refine:把模糊想法变成清晰 SPEC

  • 安全、简化、CI/CD 等一整套 Google 最佳实践(Hyrum‘s Law、Test Pyramid 这些经典原则也都在里面)

安装一行命令:

bash npx skills add addyosmani/agent-skills 

然后复制到对应工具的 rules 文件夹,几乎所有主流 AI 编码工具都支持。

GitHub:https://github.com/addyosmani/agent-skills

它最大的价值是治新手的两个坏毛病:偷懒跳测试、偷懒跳 review。这两个毛病单兵作战时几乎人人都犯,因为反正没人审你的代码。但项目一旦交付出去,没经过这两道关的代码就是定时炸弹。

适合阶段:追求生产级、要交付给同事或客户 → 让大厂规范当底线。

三件套怎么选:独立开发者的三阶段路径

到这里,三件套都介绍完了。但更关键的问题是——一个新手到底怎么挑、怎么叠加。

我把分工图先放出来:

工具
解决的层
一句话定位
OpenSpec
记忆层
让SPEC跟着代码一起长
Superpowers
纪律层
让AI按工程流程干活
agent-skills
标准层
让AI按大厂规范交付

然后是按项目体量分阶段的上手路径:

阶段 1 · 刚入门 / 周末小项目 → 先装 OpenSpec

你只有一个模块、一个开发者、一个迭代周期。这时候最值钱的是把脑子里的需求和决策落到文件里,不要再让 AI 重新猜。装 OpenSpec,5 分钟成本,立竿见影。

阶段 2 · 项目变大 / 多模块 / 多人审 → 加 Superpowers

模块开始多起来,自己审代码已经审不过来。这时候加 Superpowers,让它强制 AI 走 TDD、走 Two-Stage Review,把质量底线拉住。OpenSpec 继续负责沉淀规范,Superpowers 负责把每一次实现都按规范走。

阶段 3 · 追求生产级 / 准备交付 → 再叠 agent-skills

代码要上线、要交给同事、要面对真实用户。这时候再叠上 Addy 的 agent-skills,把 Google 那套底线带进来。SPEC 写得清、纪律走得严、标准跟得上,三层组合,AI 写出的代码才敢真的发出去。

判断节点其实不复杂:

  • 还在一个文件里写 → 你需要 OpenSpec

  • 已经在多个文件里改、回头看不懂自己的代码 → 你需要 Superpowers

  • 这份代码要给别人看、要上线、要长期维护 → 你需要 agent-skills

一份新手上手清单

如果你今天就想动手,按这个顺序来:

`bash 第一步:装 OpenSpecnpm install -g @fission-ai/openspecopenspec init

第二步:装 Superpowers(在 Claude Code 里)/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers @superpowers-marketplace

第三步:装 agent-skillsnpx skills add addyosmani/agent-skills`

装完之后,第一件该做的事不是马上写代码,而是用 openspec` 把你手头那个混乱的项目里最不清楚的那个模块先写一份 SPEC。

这一步你写得越认真,后面 AI 帮你干活的质量就越高。

写在最后

AI 写代码这件事,速度从来都不是问题。问题在它写完之后跑没跑、维护得了维护不了、三个月后你还认不认识。

SPEC 规范开发本质上解决的是可维护性这件事。它让 AI 从临时工变成正式员工,有规矩、有纪律、有质量标准。

这三个工具都是开源的,不用付钱,安装一键完成。新手友好度拉满,没建立自己方法论的同学非常推荐先用起来——先借鉴,再自创,是亘古不变的成长路径。

我是柿子,AI 产品经理,持续分享 AI 工具实战和 Vibe Coding 干货。觉得有用就点个在看,转发给同样在找工具的朋友。
如果你也对 AI 超级个体、独立开发、将技术变现实践感兴趣,欢迎关注我!
让我们一起进步!