把 vibe coding 变成 spec-driven coding

为什么 spec-driven

「和 AI 聊天写代码」最大的问题是 决策漂移。前 5 轮你说要 SSR,第 10 轮你 prompt 里突然只提到一句"加个组件",AI 根据上下文猜你是要 client-rendering。结果两小时后你发现整个模块需要 SSR 重写。

Spec-driven 的核心:先把决策写下来,再让 AI 执行。

三步落地

1. 写 1 页 spec

不需要长篇大论。回答这几个问题:

• 要解决什么问题?
• 不解决什么?(明确边界)
• 关键决策(技术栈、样式风格、数据模型)
• 验收标准(怎么知道做完了)

把它丢到 SPEC.md、.plans/feature-X.md、Linear issue 都可以。

2. 让 AI 把 spec 拆成步骤

@SPEC.md 把这份规范拆成有序步骤,每一步:
- 改动哪些文件
- 验收标准
- 可独立 commit

输出到 .plans/feature-X-plan.md

3. 一步一步执行,每步独立 verify

@.plans/feature-X-plan.md 执行第 1 步,完成后报告 verify 结果

推荐工具

• Superpowers:/brainstorm /write-plan /execute-plan 三件套
• GSD:更重的五段式流程,适合团队协作
• Kiro:把 spec 直接放进 IDE,不再"丢失"
• oh-my-claudecode:ralph / autopilot 内置类似 loop

反 pattern

• ❌ 在 spec 里写"做得好看一点"(不可验证)
• ❌ spec 里写"用最佳实践"(没说哪种)
• ❌ 一份 spec 同时塞 5 个 feature(拆掉)