一条让所有工程师沉默的曲线

admin 2026-11-16 19:47:18 网络安全文章 来源:ZONE.CI 全球网 0 阅读模式

一条让所有工程师沉默的曲线

异步图书
异步图书

只会看监控的实习生

2026年11月14日 16:00
广东

去阅读

AI 写得越快,项目死得越快?

这不是危言耸听,而是 2026 年 AI 编程现场每天都在重演的真实曲线。

Part.1

一条让所有工程师沉默的曲线

第一天,效率飙升。

你打开 Claude Code,敲下一行需求,几秒之后,几百行代码扑面而来。那一刻,你以为自己提前进入了下一个十年。

第一周,开始返工。

需求微调一次,AI 改了三个文件;你想回滚,发现连当初为什么这么写都说不清;code review 上,同事问一句\"这里的灰度规则为什么不走项目里那个 GrayReleaseUtil\"——你愣住了,因为 AI 不知道,你也不知道。

第一个月,陷入自我怀疑。

线上故障复现不出来。同一段 prompt 第二次跑结果不一样。三个月前那段代码已经没人敢动。项目像一团慢慢凝固的水泥,越搅越硬。

这条「第一天飙升 → 第一周返工 → 第一个月自我怀疑」的曲线,就是黄佳老师在新作前言里写下的开篇。一句话,戳穿了整个 AI 编程行业的甜蜜假象。

而他紧接着的下一句更狠:

\"核心问题不是 AI 能力不足,而是你的指令不够完整。\"

AI 编程时代的竞争,不再是比拼谁写得快,而是比拼谁把需求、架构与验收边界定义得更清楚。这正是《SDD 实战:规范驱动开发之道》这本书要解决的核心问题。

▼点击下方,即可购书

Part.2

Vibe Coding 的五个致命陷阱

黄佳在书的第 1 章「空中楼阁」里,把 Vibe Coding(凭感觉写代码)的甜蜜代价拆解成五个致命问题。每一个,都正在吞噬今天的 AI 项目。

需求蒸发

你跟 AI 说\"加一个灰度发布功能\"。它听懂了吗?没有。它在自由发挥。半小时后,代码里出现了一个全新的 GrayService,而你们项目里那个用了三年的 GrayReleaseUtil 它根本不知道。这个知识藏在老王脑子里,不在 README 里、不在注释里、不在 prompt 里——所以 AI 写不对。

上下文飘移

每一轮对话,AI 都在丢掉上一轮的约束。你最初说的\"不要改公共组件\",到第八轮已经被它当成空气。最后产出的代码,跟你最初的需求只剩字面相似。

不可审查

AI 一次性吐出几百行代码,没有思考过程、没有取舍说明、没有备选方案。code review 时,reviewer 根本无从切入——他在审\"结果\",但你和 AI 之间的\"过程\"已经永远丢失了。

不可复现

今天能跑,明天报错。同一段 prompt,今天产出 A,明天产出 B。bug 出现的时候,你连现场都还原不了——因为生成代码的那次对话,已经不存在了。

不可维护

三个月后,新人入职接手项目。他面对一坨没有规范来源的代码,没有 ADR,没有架构决策记录,连\"当初为什么这样设计\"都问不到——只能推倒重来。

这五个陷阱合起来,不是 AI 的错。是开发方法论缺了一环——「规范」这一环。

Part.3

SDD 的答案:

以终为始,两次创造

黄佳给出的解法,根植于一条 30 年前的管理学心法。

Stephen Covey 在《高效能人士的七个习惯》里写下:以终为始(Begin with the End in Mind),所有事物都经过两次创造。

第一次,是心智的创造——你在脑子里把房子想清楚。

第二次,是物质的创造——你按图纸把房子盖起来。

这条 30 年前的金句,在 AI 编程时代终于找到了它真正的归宿。SDD(Specification-Driven Development,规范驱动开发)把这条哲学翻译成了三份可执行的工程文档:

\"三份规范构成第一次创造,代码是第二次创造。\"

更关键的是黄佳点出的那个时代差异:

\"AI 时代的规范不再只是给人看的参考材料,而是给 Agent 执行的输入。\"

\"规范文档从『可选的说明』变成『必要的工程接口』。\"

这就是 SDD 区别于一切旧方法论的根本升级——规范不再是文档归档处吃灰的 Word 文件,而是 Agent 真正读取、解析、执行的机器接口。

SDD 不是反对 AI 编程,而是给 AI 编程配上一副工程化的骨架。

Part.4

《SDD 实战》全书脉络解构

全书 10 章 3 阶段,每一章四字成语开题,节奏稳、骨架清。

阶段一·认识问题

第 1 章 空中楼阁——拆解 Vibe Coding 的五个致命陷阱,让你看清自己每天踩的坑。

第 2 章 按图索骥——SDD 的核心思想。三次历史复兴(1988 契约式设计 / 2015 API-First / 2025 AI 时代 SDD)、5 大核心原则、6 阶段工作流,把 SDD 的来龙去脉一次讲透。

阶段二·掌握方法

第 3 章 欲善其事——SDD 工具链全景。OpenSpec、Spec-Kit、BMAD、Kiro,主流工具一一拆解,告诉你什么场景选什么工具,选完之后怎么搭配使用。

第 4 章 条分缕析——proposal.md 需求规范实战。怎么把\"加一个 retry\"这种模糊需求,拆成可执行、可验收、不模糊的 Requirement × Scenario 网格。

第 5 章 运筹帷幄——design.md 架构设计与 ADR(架构决策记录)。每一个技术选型都留下\"为什么\",半年后接手人不用再去考古。

第 6 章 化整为零——tasks.md 任务拆解与执行编排。把一个 change 切成 8 个 commit、10 个单测,让 AI 接手就能跑。

第 7 章 千锤百炼——Brownfield(既有项目)场景下的验证、迭代与演进。这一章解决最难的问题:老项目怎么渐进引入 SDD,不是推倒重来。

阶段三·深入应用

第 8 章 登堂入室——这是全书最让人眼前一亮的一章。SDD 与 5 种 Agent 设计模式深度融合:

规划与执行(Planner-Worker)

生成-评审(Generator-Critic)

层级委托(Hierarchical Delegation)

护栏三明治(Guardrail Sandwich)

条件路由(Conditional Routing)

每一种模式都对应一份规范模板。这一章背后,是黄佳在 Manning 全球英文书《Designing AI Agents》里沉淀的设计模式心法,第一次被翻译成可落地的中文 SDD 工程实践。

第 9 章 众人拾柴——团队中的 SDD 实践。个人 → 团队 → 组织,三阶段落地路径,每一阶段配真实案例。

第 10 章 大道至简——SDD 的边界、误区,与其他方法论(敏捷、DevOps、TDD)的融合。诚实地告诉你\"什么时候不要用 SDD\",这是一本成熟工程书的底气。

Part.5

一个真实场景:

45 分钟和 5 分钟的差距

讲一个书里精神能扎到的小故事。

某团队的 analyzer 调 LLM 没有 retry,深夜跑定时采集,50 条到第 23 条 timeout 退出。前 22 条的 token 钱花了,知识库当天空了。

Vibe 路径:5 分钟,让 AI 加个 retry 装饰器,跑通了,commit,下班。

SDD 路径:45 分钟。

先 explore 不落盘——5 问 5 答把 5 个模糊点钉死:哪些异常要重试?max\_attempts 多少?429 状态码怎么处理?失败重试要不要算 cost?全部失败后 pipeline 怎么走?

再写 proposal.md,把可重试异常清单(APITimeoutError / APIConnectionError / RateLimitError / 5xx)和不可重试异常清单(JSONDecodeError / KeyError——内容层错误重试无效,浪费钱)白纸黑字写清楚。

然后 design.md 选方案:装饰器 vs 基类继承 vs middleware。每一个权衡都留痕。

最后 tasks.md 拆成 8 个 commit、10 个单测。

40 分钟的差距,看似浪费了时间。但半年后,新人接手项目,照着 spec 一眼就能复现你当时的每一个决策。主语偏差一毫米,后面 spec/代码/测试全歪一公里——这是 SDD 真正值钱的地方。

这不是给一个 retry 加规范,这是把\"一时想清楚就够了\"的决策刻进仓库里。

Part.6

关于作者:

写一本爆一本的黄佳(咖哥)

黄佳,笔名咖哥。畅销技术书作者。

《GPT 图解:大模型是怎样构建的》——国内 LLM 入门书口碑长青

《大模型应用开发:动手做 AI Agent》——Agent 工程化中文圈的启蒙读物

《Designing AI Agents》(Manning 全球英文书)——把 Agent 设计模式做成了国际话语权

他总是思考技术的本质,从而提炼出可以穿越周期的心法,帮助读者在纷繁的 AI 时代抓住根本,成为技术领跑者。

《SDD 实战:规范驱动开发之道》是他从 Agent 设计模式延伸出的工程方法论新作。讲完 Agent 怎么设计,接着讲怎么把它工程化地交付出来——这一脉相承的写作主线,让这本书从一上市就有了清晰的工程坐标。

Part.7

这本书适合谁读

对独立开发者来说,这本书让你的个人项目第一次有了可以传承的工程档案。AI 不再是黑盒打工,而是有据可查的协作者。

对小团队 Leader 来说,这本书提供了一套可以马上落地的规范模板和工具链选型,把团队从\"谁写谁懂\"的口口相传里拉出来。

对企业架构师来说,第 8 章 SDD × Agent 设计模式 × Harness Engineering 的融合,给你一张未来三年企业级 AI 系统的施工图。

对每一个被 Vibe Coding 折磨过的工程师来说,这本书让你明白——第一个月的自我怀疑不是你的错,是方法论没跟上。

Part.8

终极 CTA:从「先试试看」

到「先定义清楚再执行」

黄佳在前言里留下了一句话,可以当作整本书的注脚:

\"从 Vibe Coding 到 SDD,不是从一种工具切换到另一种工具,而是从『先试试看』转向『先定义清楚再执行』。\"

AI 编程已经进入工程深水区,浪头之下,写得快的人正在被写得清楚的人甩开。

读懂《SDD 实战:规范驱动开发之道》这一套从需求到验收的规范心法,结合 OpenSpec、Spec-Kit、BMAD 这些一线工具链,把脑子里那些\"一时想清楚就够了\"的决策刻进仓库里,让今天的每一次 change 都成为下一次 change 的起点——

这才是 AI 时代真正不可替代的核心竞争力!

📚图书信息

• 书名:《SDD 实战:规范驱动开发之道》

• 作者:黄佳(咖哥)

• 出版社:人民邮电出版社 · 异步图书

• 页数:224 页 / 7.125 印张

🎁配套资源(异步社区独家)

• ✅ 全书源代码 · 三份规范模板可直接复用

• ✅ 全书高清图片 · 架构图 / 流程图 / 模式图一应俱全

• ✅ 全书思维导图 · 10 章脉络一图掌握

• ✅ 异步社区7 天 VIP阅读权益

🛒现在就上京东 / 当当 / 异步社区,搜索「\\SDD 实战\\」开启你的规范驱动开发之路。

关注本公众号,第一时间获取黄佳老师后续直播讲解、读者群答疑、配套实战课信息。

真正的核心竞争力,不在于使用多么强大的 AI 模型,而在于能否把需求、架构与验收边界定义清楚——这正是《SDD 实战》要教你的事。

理解UBI 网络安全文章

理解UBI

本文探讨了全民基本收入(UBI)的可行性和必要性,指出随着超级智能(SI)的发展,生产力和物质丰裕程度提高,UBI有望成为解决资源分配不均和保障基本生活的新体系。文章分析了当前社会生产力与物资供给的失衡现象,并提出了SI应与人类共享生产力进步收益的观点。
评论:0   参与:  0