先说个事。
上周GitHub发布了一个开源工具包叫Spec Kit,上线没几天就冲到109K stars。这玩意干嘛的?翻译成人话:教你怎么跟AI写代码的时候不被AI坑。
我看到这个项目的时候,心里五味杂陈。因为我踩过的坑,它全给总结出来了。
先聊聊"vibe coding"这个病
"vibe coding"是硅谷最近火起来的一个词,翻译过来大概叫"凭感觉编程"。什么意思呢?就是你跟AI说"帮我做个登录页面",AI哐哐哐写完,你看一眼觉得还行,就上线了。感觉对了,代码就对了。
听起来很爽对吧?但如果你真的这么干过,你知道接下来会发生什么:
第三周,你发现登录页面有个漏洞。你让AI修,AI改了三行代码,把注册功能改崩了。你让它再修,它改了五处,把数据库连接搞挂了。你开始慌了,打开代码一看——你根本看不懂AI写了什么。
这不是段子。这是过去半年每天都在发生的事。
GitHub Spec Kit干的事就是把"vibe coding"这个病给治了。它的核心逻辑很简单:先写清楚你要什么,再让AI动手。
听上去像废话?我解释一下。
Spec Kit到底做了什么
传统的AI编程流程:你说需求 → AI写代码 → 你检查 → 上线。
Spec Kit的流程:你说需求 → AI帮你写出"开发规格"(Spec)→ 你确认规格 → AI拆成具体任务 → AI逐个执行 → 你逐个验收。
区别在哪?在"AI写代码"之前,多了一个"写规格"的环节。
这个规格不是那种几十页没人看的PRD。它是AI读得懂、人也读得懂的"开发合同"。里面写清楚了:要做什么功能、数据怎么流转、边界条件是什么、什么算做完。
举个例子。你要做一个用户注册功能。vibe coding的做法是跟AI说"帮我做注册"。Spec Kit的做法是先生成一份规格,里面写了:用户名3-20位、邮箱要验证、密码要有强度校验、注册完自动登录、并发量1000以内。然后AI按照这份规格,一条一条地实现。
我问你,如果六个月后有人问你"这个注册功能当初为什么这么设计",哪种做法你能答得上来?
我从"vibe coding"到"规范驱动"的血泪史
说实话,我一开始也不信这一套。
去年年底开始用AI员工的时候,我觉得"跟AI说人话就够了"。结果三个月后,我发现我的11个AI员工写出来的代码,风格完全不统一。有的用class,有的用function;有的用axios,有的用fetch;有的加了类型检查,有的啥也没加。
更要命的是,当我要改一个功能的时候,没人——包括我自己——知道当初为什么那么写。
我花了两周时间,给每个AI员工写了一份"工作规范"。里面写了代码风格、技术选型、命名规则、测试要求。然后呢?效率突然上来了。因为AI不用猜了。它知道规则,直接按规则来。
GitHub Spec Kit就是把这件事做成了产品。它把"规范"从一份文档变成了可执行的工程框架。写出来的规格,AI能读、能拆、能检查、能执行。人只需要做一件事:确认。

Harness Engineering:OpenAI也在干同一件事
就在GitHub发Spec Kit的前几个月,OpenAI Codex团队发了一篇文章,标题叫《Harness Engineering》,翻译过来大概是"驾驭工程"。
文章里说了一件让我很在意的事:他们3个工程师,配了5个AI Agent,在5周内从零搭建了一个内部beta产品。整个过程,工程师亲手写的代码量不到总代码的15%。
剩下的85%呢?AI写的。但他们不是让AI随便写。他们设计了一套"agent harness"——你可以理解为一个AI管理系统。这套系统规定了每个Agent的职责边界、输入输出格式、错误处理流程、什么时候该停下来问人。
翻译成人话:不是让AI当员工,是让AI当工具。 操控工具的人,得知道自己要什么。
三个教训,说给你听
做了半年AI管理,加上看完了GitHub和OpenAI这两套方法论,我总结了三条:
第一,模糊的需求是AI的毒药。 AI不会问你"这个按钮放左边还是右边",它直接给你一个方案。你觉得不对,让它改。改来改去,你的时间全花在改东西上了。反过来,你把需求写清楚,AI一把过,你只需要检查。
第二,AI的能力上限是你给它的规则上限。 我见过太多人抱怨"AI写的代码质量差"。我问他们给AI什么指令了,答案是"帮我做个网站"。你给一个人类工程师说"帮我做个网站",他也写不出好东西。AI不是魔法,你喂它什么,它吐什么。
第三,规范是资产,不是负担。 很多人觉得写规范浪费时间。但你想一个问题:你公司最值钱的东西是什么?代码?产品?都不是。是你对业务的"理解"。规范就是把你脑子里的理解变成文字,变成规则,变成AI能执行的东西。这份东西,比代码值钱一百倍。

说句得罪人的话
我觉得"vibe coding"这件事被严重高估了。
它让你像一个魔法师一样,说句话就能变出代码。但魔法师的魔法不是凭空来的——他背了几十年的咒语书。
你不写规范,不定义规则,不设计流程,就指望AI帮你搞定一切。最后得到的只会是一堆你读不懂、改不了、不敢动的代码。
Spec Kit和Harness Engineering给我最大的启发是:AI时代的核心竞争力,不是你会不会用AI,而是你能不能清晰地表达自己到底要什么。
这件事,AI帮不了你。
如果这篇文章对你有启发,点击上方蓝字「杨宗主」关注我。
每周持续更新AI操盘实战笔记,不吹不装,只说真话。
夜雨聆风