欢迎光临
我们一直在努力

别再用Vibe Coding瞎写代码!SDD才是AI开发的施工图

文章目录

  • 前言
  • 1 爽不过三天,返工才是常态
    • 1.1 快乐只存在第一天
    • 1.2 第二周直接进入地狱模式
  • 2 不是AI不行,是你没给“施工图”
    • 2.1 你只说了“去做”,没说“做成啥样”
    • 2.2 所有东西都要经历“两次创造”
  • 3 SDD就是给AI的一份施工图
    • 3.1 SDD到底是个啥?
    • 3.2 核心流程就四步
  • 4 一套实用的SDD,就三份文档
    • 4.1 第一份:先说清楚“不做什么”
    • 4.2 第二份:技术坑提前踩平
    • 4.3 第三份:拆成小任务,一口一口吃
  • 5 需求变了?先改规范再改代码
    • 5.1 别直接上来就改代码
    • 5.2 变更要走完整流程
  • 6 跟AI配合的正确姿势
    • 6.1 阶段一:只聊需求
    • 6.2 阶段二:只做技术设计
    • 6.3 阶段三:拆解任务
    • 6.4 阶段四:逐项实现
  • 7 别把SDD搞成新的形式主义
    • 7.1 文档规模跟风险匹配
    • 7.2 先写验收标准,再想实现
    • 7.3 非目标和目标一样重要
    • 7.4 把结论写进文档,别只留链接
    • 7.5 小步提交,随时验证
    • 7.6 规范漂移就是缺陷
  • 8 最后说句实在的

在这里插入图片描述
P.S. 目前国内还是很缺AI人才的,希望更多人能真正加入到AI行业,共同促进行业进步,增强我国的AI竞争力。想要系统学习AI知识的朋友可以看看我精心打磨的教程
http://blog.csdn.net/jiangjunshow,教程通俗易懂,高中生都能看懂,还有各种段子风趣幽默,从深度学习基础原理到各领域实战应用都有讲解,我22年的AI积累全在里面了。注意,教程仅限真正想入门AI的朋友,否则看看零散的博文就够了。

前言

不知道你们有没有过这种经历。

第一次用AI写代码,爽到天灵盖发麻。

甩一句“帮我做个用户认证系统”,喝口水的功夫,目录、接口、页面全给你整出来了。

两千行代码往那一摆,你当场就想:完了,程序员要失业了,我先失业为敬。

1 爽不过三天,返工才是常态

1.1 快乐只存在第一天

刚开始那叫一个效率飞升。

以前一周的活,AI一下午给你干完。

你甚至开始琢磨,剩下的时间是不是可以摸鱼到退休。

1.2 第二周直接进入地狱模式

写着写着不对劲了。

它偷偷给你选了个你根本不想用的框架;

登录功能能跑,令牌刷新、异常处理全给你漏了;

新加一个小需求,旧功能直接集体罢工;

换个对话框再聊,之前定好的架构,AI转头就忘得一干二净。

你就不停补提示词,AI不停重写代码。

时间和token一起烧,最后发现,返工花的时间比自己写还长。

第一天效率提升10倍,第二周全部吐回去还得倒贴。

2 不是AI不行,是你没给“施工图”

2.1 你只说了“去做”,没说“做成啥样”

很多人骂AI笨,写出来的东西不对味。

其实真不一定是模型能力不行。

你就给了一句话需求,剩下的全靠AI猜。

就像你跟装修师傅说“装成现代简约风”,然后就撒手不管了。

师傅给你装完,你发现地砖颜色不对,吊顶太矮,插座留少了。

你骂师傅手艺差,可你压根没给人施工图啊。

2.2 所有东西都要经历“两次创造”

有个说法我特别认同。

任何事都要先在脑子里造一遍,再在现实里造一遍。

盖房子先画图纸,做产品先写需求。

Vibe Coding最大的问题,就是跳过了第一次创造,直接扎进第二次创造里。

想到啥就让AI写啥,写不对就改,改完又有新想法。

整个项目的需求,从头到尾只存在你自己脑子里。

AI哪有读心术啊,它不猜怎么办?

3 SDD就是给AI的一份施工图

3.1 SDD到底是个啥?

SDD,Spec-Driven Development,说人话就是规范驱动开发。

听起来高大上,其实道理特别简单。

先把要做的事写明白,再让代码去匹配这份规范。

以前我们是写着写着,代码就成了唯一的真相,文档早就过期没人看了。

SDD反过来,规范才是老大,需求、设计、任务、代码都围着它转。

3.2 核心流程就四步

说穿了就四个环节:

先定义做什么,再想怎么做,接着拆成一步一步做什么,最后动手实现。

不是让你提前写几十页的需求说明书。

核心就一个:AI动手写代码之前,关键决策都得白纸黑字记下来。

别散落在几十条聊天记录里,回头找都找不到。

4 一套实用的SDD,就三份文档

别一听文档就头疼。

真不用写厚厚的PRD,就三份文件,解决核心问题。

4.1 第一份:先说清楚“不做什么”

第一份叫proposal或者spec,核心回答“为什么做、做什么”。

重点不是列功能,是划边界。

AI最容易犯的毛病就是过度实现。

你说要个翻译插件,它能给你加上账号系统、云同步、一键发公众号。

功能越堆越多,核心链路反而没跑通。

所以一定要写清楚,哪些东西这次不做。

还有验收标准,别写“界面要好看”“速度要快”。

这都是废话,好不好看谁说了算?

要写得可验证:点击图标能弹出侧边栏,复制的内容和原文一致,没配密钥不发请求。

这样AI才知道,做到啥样算完事。

4.2 第二份:技术坑提前踩平

第二份叫design或者plan,回答“怎么做”。

技术栈选什么,架构怎么搭,数据流怎么走,异常怎么处理,安全有啥要求。

别让AI随手给你选依赖。

就比如做Chrome插件,你说要个弹窗,AI可能给你写个悬浮div凑数。

但Chrome本身就有原生的侧边栏API,好用又稳定。

这些东西提前调研好写进去,能省后面一大堆改bug的功夫。

还有各种异常场景,都得提前想到。

提取不到正文怎么办?文章太长超上下文了怎么办?请求超时了怎么办?

这些问题越早明确,后面返工成本越低。

4.3 第三份:拆成小任务,一口一口吃

第三份就是tasks,回答“按什么顺序做”。

别一句话让AI“全部实现”,那大概率会写崩。

拆成一个个小任务,每个任务都有明确的完成标准。

比如先搭项目骨架,再做侧边栏,再接配置页面,一步步来。

好处太多了。

AI单次注意力更集中,不容易写飞;

出了问题,一眼就能看出是哪一步出的错;

做完一步提交一步,想回退也方便。

没依赖的任务还能并行做,效率反而更高。

5 需求变了?先改规范再改代码

5.1 别直接上来就改代码

做项目哪有不改需求的。

比如之前做的弹窗,现在想改成全屏侧边栏。

很多人直接就跟AI说:把弹窗改成右边全屏的。

AI咔咔改完CSS,结果一堆兼容问题,还多了一堆没用的旧逻辑。

5.2 变更要走完整流程

在SDD里,需求变更不是聊天里的一句补充。

得先调研能不能做,再更新需求和设计,再改任务,最后改代码。

文档和代码要一起版本控制。

不然过两个月你自己都忘了,为啥要加这个权限,为啥要用这个方案。

文档写的是A,代码实现的是B,这本身就是个bug。

6 跟AI配合的正确姿势

SDD不挑工具,Claude Code、Cursor、Copilot啥都能用。

关键是别让一次聊天同时干好几件事。

分阶段来,效率反而高。

6.1 阶段一:只聊需求

先让AI读项目,只聊用户场景、功能范围、验收标准。

就输出第一份文档,不准碰代码。

别聊着聊着就开始写功能了,节奏要稳住。

6.2 阶段二:只做技术设计

需求定死了,再开始调研技术方案。

对比不同选型的优劣,写清楚选什么、为什么选、有啥风险。

就输出第二份文档,还是不碰代码。

6.3 阶段三:拆解任务

两份文档都齐了,再拆成具体的任务列表。

每个任务要多小有多小,标清楚依赖关系和完成条件。

6.4 阶段四:逐项实现

最后一步,才是让AI写代码。

一次只做一个任务,做完就验证,没问题再下一个。

别让它提前做后面的事,省得越写越偏。

7 别把SDD搞成新的形式主义

很多人一搞流程就容易走极端。

文档写了一大堆,没一句有用的,那反而更糟。

记住几个原则就行。

7.1 文档规模跟风险匹配

改个按钮文案,没必要写完整PRD。

做支付、权限、认证这种核心系统,就不能只留一句话。

风险越高,越要写清楚;小改动,就简单记两句。

7.2 先写验收标准,再想实现

一个需求如果你说不清楚怎么算完成,那它就是没想清楚。

别用“好用”“稳定”这种虚词。

改成可观察、可验证的具体描述。

7.3 非目标和目标一样重要

明确说清楚这次不做什么。

既能管住AI的手,也能管住自己不断加需求的念头。

7.4 把结论写进文档,别只留链接

聊天记录会丢,链接会失效。

最终选了什么方案,放弃了什么选项,原因是什么,都写下来。

不然过段时间你自己都忘了当时怎么想的。

7.5 小步提交,随时验证

AI写代码越快,你越要勤检查。

写一点测一点,及时保存版本。

版本控制不是最后上传才用的,是你的安全绳。

7.6 规范漂移就是缺陷

代码和规范对不上,要么代码写错了,要么规范过期了。

哪个有问题修哪个,别总说“文档以后再补”。

以后就不会补了。

8 最后说句实在的

AI把写代码的成本打下来了。

但软件开发里最难的部分,其实一点没变。

理解用户、划定边界、选型架构、处理异常、判断结果。

这些事,AI替不了你。

以前我们花大量时间把方案翻译成代码,现在这部分可以交给AI了。

但清晰的思路、明确的意图,反而越来越值钱。

Vibe Coding适合快速探路、验证想法。

但真要做一个能维护、能迭代的项目,你还是得给AI一份靠谱的施工图。

下次再想跟AI说“帮我做个系统”之前,先花十分钟。

想明白四件事:为什么做、做什么、怎么做、怎么证明做好了。

这十分钟,大概率能帮你省下后面几天的返工。

P.S. 目前国内还是很缺AI人才的,希望更多人能真正加入到AI行业,共同促进行业进步,增强我国的AI竞争力。想要系统学习AI知识的朋友可以看看我精心打磨的教程 http://blog.csdn.net/jiangjunshow,教程通俗易懂,高中生都能看懂,还有各种段子风趣幽默,从深度学习基础原理到各领域实战应用都有讲解,我22年的AI积累全在里面了。注意,教程仅限真正想入门AI的朋友,否则看看零散的博文就够了。

赞(0)
未经允许不得转载:171主机测评 » 别再用Vibe Coding瞎写代码!SDD才是AI开发的施工图
分享到: 更多 (0)

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址