这三个开源工具让你的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。这两个毛病单兵作战时几乎人人都犯，因为反正没人审你的代码。但项目一旦交付出去，没经过这两道关的代码就是定时炸弹。

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

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

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

我把分工图先放出来：

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

阶段 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 从临时工变成正式员工，有规矩、有纪律、有质量标准。

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