文章目录
- 前言
- 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的朋友,否则看看零散的博文就够了。


