前几天一个独立开发者朋友跟我吐槽，他给 AI 写了快一千字的提示词，结果做出来的东西还是不对。他问我，是不是模型不够聪明？

我说，问题也许不在模型，在你跟它说话的方式。

我们习惯了跟人打交道——说得模糊点，对方也能猜到。但 AI 不是你的同事，它不知道你前面想了什么，也没有你脑子里那些”理所当然”的东西。你给它一千字的提示词，里面可能八百字是情绪和背景，只有两百字是真正的需求。

古人建房子，靠的是图纸，不是口述。工匠拿到图纸，一砖一瓦照着来。图纸是什么？是规格，是把脑子里模糊的想象，翻译成不会产生歧义的语言。

最近看到一位叫邵猛的开发者分享了一套方法论，Spec 驱动开发。他做了三个 AI Skills，分别负责写产品规格、写技术规格、验证实现是否符合规格。五步流程，从想法到交付，每一步都有明确的文档约束。

他的核心观点很朴素：与其花时间写提示词，不如花时间写规格文档。

这让我想到老子那句，“知人者智，自知者明”。我们总在学怎么跟 AI 说话，却很少想过，也许我们连自己要什么都还没想清楚。

我们跟 AI 说话的方式就是错的

我们跟 AI 聊天的时候，脑子里其实同时在做两件事。一件是“想清楚自己要什么”，另一件是“把想法翻译成 AI 能理解的话”。问题是，大多数人把这两件事混在一起做了。

结果就是，你写出一段又长又模糊的提示词，里面夹杂着需求、情绪、背景故事、甚至自我怀疑。你以为自己说清楚了，AI 也以为自己听明白了。做出来的东西，就是不对。

古时候的将领给士兵下命令，如果只说”去把那座城打下来”，结果往往是灾难性的。他需要的是什么？是军令状，是行军路线图，是粮草调度表，是攻城的时间节点和退路安排。把这些写下来的过程，就叫规格。

2026 年 6 月，GitHub 开源了一个叫 Spec Kit 的工具包，一周之内拿到了超过 10 万颗星。它做的事情跟邵猛的理念不谋而合：不要让 AI 直接跳进代码里，先把产品规范写清楚，再让 AI 根据规范去实现。

GitHub Spec Kit 的核心理念：把流程从“让 AI 直接构建”改为“先写产品规范，再让 AI 根据规范实现”。规范成为可执行的开发合约，支持 Copilot、Claude Code、Codex、Gemini、Cursor 等 30 多种 AI 工具集成。 — GitHub Spec Kit，109K+ stars

10 万颗星意味着什么？意味着“写提示词不如写规格”这件事，已经不是一个人的直觉了，它正在变成整个行业的共识。

什么是 Spec 驱动开发

邵猛的方法叫 SDD，Spec Driven Development。核心就一件事：先写两份规格文档（产品规格和技术规格），放在项目里跟代码一起提交，然后让 AI 照着规格去实现。

流程拆成五步：写产品规格、写技术规格、AI 按规格实现、一致性校验、端到端验证。每一步都有明确的文档输出。规格不会过期，它会成为项目的一部分，被维护、被更新、被后人阅读。

AI 是执行者，你才是设计师。 提示词是临时的对话，规格是长期的契约。

我自己试了一下

上个月我有个小工具要重写，之前用提示词跟 Claude Code 反复拉扯了三天，改了六七版，每次都差那么一点。后来看到邵猛的方法，我想，不如试一下。

花了一个小时写了一份产品规格。不长，两千字左右，但把用户故事、核心状态、错误处理都写清楚了。然后把这份规格丢给 AI。

第一次生成的东西，八成是对的。

以前呢？以前写提示词，三成对就不错了。

一个小时的规格文档，省了大概六个小时的反复修改。那一刻我突然明白了一件事：我以前花在写提示词上的时间，大部分是在弥补”我自己都没想清楚”这个事实。 规格逼着你先想清楚，再开口说话。

更让我意外的是，规格写完之后，我对这个项目的理解比之前深了很多。以前我以为自己很了解这个工具，写规格的时候才发现，有好几个状态转换我根本没想清楚。规格不只是给 AI 看的，也是给自己看的。

这让我想起中国古代建筑史上的一件大事。北宋时期，李诫写了一部《营造法式》，把建筑的每一个细节都用文字和图纸记录下来，柱子多粗、斗拱几层、瓦片什么颜色。这部书是给所有工匠看的。有了它，任何一个合格的工匠都能按照规格把房子建起来。

Spec 驱动开发做的，其实是同一件事。只不过“工匠”变成了 AI，“图纸”变成了规格文档。

Karpathy 几年前说过一句话，”Software 2.0”的时代，代码不再是人类写的，而是机器根据某种规格生成的。当时很多人觉得这是遥远的未来。但现在看看 Spec Kit 的 10 万颗星，看看邵猛的三个 Skills，看看 Angular 团队都在给 AI 写编码规范的 Skills，你会发现这个未来已经到了。就在现在。

我们正在从“写代码”的时代，过渡到“写规格”的时代。

这是一种思维方式的迁移。过去我们训练的是”怎么跟 AI 说话”，现在我们需要训练的是”怎么把脑子里的东西结构化地表达出来”。前者是技巧，后者是能力。技巧会过时，能力不会。

不只是邵猛一个人在做这件事。

2026 年 6 月，Google 的 Angular 团队发布了一个叫 angular/skills 的仓库，专门为 AI 编码工具提供 Angular 框架的 Skills。这些 Skills 告诉 AI，在 Angular 里正确的代码长什么样。Google 自己也在用规格来约束 AI 的输出，这件事本身就说明了很多。

GitHub 自己的 Spec Kit 支持 30 多种 AI 工具，从 Copilot 到 Claude Code 到 Codex 到 Gemini 到 Cursor。不管你用哪个 AI，规格文档是通用的。

甚至有人专门做了一个面向 AI 的 PRD 生成工具，叫 qiaomu-ai-prd。它的核心洞察是，人类写的 PRD 和 AI 需要的 PRD 是不一样的。人类能容忍模糊，AI 不能。所以你需要专门为 AI 写一份”AI 友好型”的规格文档。这个工具本身的存在，就说明了”给 AI 写规格”已经成了一个独立的需求。

这些事情加在一起，指向一个趋势：规格正在从”个人习惯”变成”行业基础设施”。

就像 Git 让代码版本管理变成了基础设施，就像 Docker 让环境配置变成了基础设施，Spec 和 Skills 正在让“需求规格化”变成 AI 时代开发的基础设施。

但基础设施的爆发，也带来了新的问题。

Skills 生态是繁荣的，也是危险的

NVIDIA 最近开源了一个叫 SkillSpector 的工具，专门扫描 AI Agent Skills 的安全性。他们的研究发现了一个让人不安的数字。

26.1% 的 AI Agent Skills 含安全漏洞，5.2% 显示出可能的恶意意图。这些 Skills 在隐式信任和极少审查的环境下运行。 — NVIDIA SkillSpector

26%，超过四分之一。

这不是一个小问题。Skills 生态正在爆发，开发者在疯狂地安装各种 Skills，就像十年前大家疯狂地安装 npm 包一样。那时候我们也觉得装个包能有什么问题，结果 left-pad 事件让半个互联网瘫痪了。现在 Skills 的信任问题，比当年的 npm 只会更严重。

邵猛的 SDD 方法恰好提供了一种解法。因为有了规格文档，你可以在提交代码之前先校验，AI 生成的代码有没有偏离你的规格。规格就像一道防火墙，它不能阻止所有的恶意，但它能让你第一时间发现“不对劲”。

规格不只是提高效率的工具，它也是一种安全机制。

这跟古代匠人的智慧是一样的。为什么造房子要图纸？不只是为了让工匠知道怎么做，更是为了让验收的人知道应该检查什么。图纸是沟通工具，也是约束工具。有了规格，你验收的时候就有据可依——这个功能符合规格吗？符合就过，不符合就打回去。没有规格，你只能凭感觉验收，凭感觉是靠不住的。

一个人开发，最需要的就是规格

说到这里，我想跟做独立开发的朋友们聊几句。

很多人觉得 SDD 是大团队的事，一个人开发不需要这么正式。恰恰相反。一个人加一个 AI 的组合，是最需要规格文档的场景。

为什么？因为大团队里有人会 review 你的代码，有人会问你“这个功能是做什么的”。但一个人开发的时候，唯一的“沟通对象”就是 AI。而 AI 读不懂你的心思，它只能读懂你写下来的东西。

我那个朋友后来试了一下 SDD 的方法。他花了一个小时写了一份产品规格，把“用户登录后应该看到什么”、“这个页面有哪些状态”、“错误的时候应该怎么处理”都写清楚了。然后让 AI 按照这份规格去实现。

他说，这一次 AI 做出来的东西，八成是对的。

以前呢？以前写一千字提示词，做出来的东西，三成对就不错了。

一个小时的规格文档，省了他大概六个小时的反复修改。

这就是规格的力量。它不是增加了你的工作量，它是减少了你的总工作量。 前期多花一点时间想清楚，后期就少花很多时间返工。

这跟老子说的“知人者智，自知者明”是一样的道理。你花时间写规格的过程，其实就是“自知”的过程。你得先想清楚自己要什么，才能告诉别人，也才能告诉 AI。

回到最开始的那个问题。朋友问我，是不是模型不够聪明？

现在看来，不是模型的问题，是我们的问题。AI 读过的代码比我们一辈子写的多得多，但它只有你写下来的那些字。你脑子里那些模糊的想法、那些”我觉得这样比较好”的感觉，它感受不到。

规格文档本质上是什么？是你和 AI 之间的一份契约。条款写得越清楚，执行的偏差就越小。两个人合作，口头说说”咱们一起干”，后面一定会出问题。写下来就不一样了。

古人靠图纸造了万里长城，靠《营造法式》让千年后的我们还能复原北宋的建筑。我们总在学怎么跟 AI 说话，学各种提示词技巧。也许最该学的是另一件事：怎么把脑子里模糊的想法，翻译成不会产生歧义的语言。

AI 把这件事的重要性放大了一百倍。规格就是这个时代的图纸。与其花一千字写提示词，不如花一百字写规格。(·ω·)

研究Agent的云 · 风云
若有共鸣,愿你转给那位你想到的朋友
邮箱 2330304961@qq.com · 微信 FengYunAgent