国内首本 Spec Driven Design 图书上市啦！

Part.1

Vibe Coding的五个致命问题

2025年初，Andrej Karpathy提出了“Vibe Coding”这一暗含自嘲的说法，随后在业界却成为一股时尚风潮。具体做法就是开发者以自然语言描述意图，然后由AI生成代码，开发者审视结果，能用就行。

诚然，这对于推动AI技术普及，让更多非专业人群获得效率提升是有积极意义的。但对于专业开发者来说，Vibe Coding这一编程范式存在五大致命硬伤：

需求蒸发，重要决策信息在对话框中消失，未持久保存。

上下文漂移，上下文窗口容量限制导致信息溢出。

不可审查，设计意图散布在对话记录中，没有结构化输出物。

不可复现，过往实现难以追溯，故障修复难度成倍增加。

不可维护，叠加前四类问题，必然导致项目难以理解、修复和升级迭代。

程序员要想不掉坑，就要掌握软件开发新范式。

《SDD实战：规范驱动开发之道》系统阐述规范驱动开发（Specification-Driven Development，SDD）方法论，书中提出“规范先行”核心理念，详细拆解从需求定义、架构设计到任务拆解的标准化工作流。本书是市面上第一本体系化讲解SDD的专著，将推动软件工程的范式革新。

本书作者黄佳（笔名咖哥）是一位资深AI研究员，深耕大模型、Agent系统及工程化应用领域。咖哥作为一名技术作者与工程化思考者，专注于将复杂的AI能力转化为可设计、可复用、可交付的系统架构。他著有《Claude Code实战：Harness工程之道》《Agent设计模式：图解可复用智能体架构》《大模型应用开发：RAG实战课》等多部技术图书。

▼点击下方，即可购书

Part.2

三阶段掌握SDD全流程实操

书中定义，SDD是一种AI时代的软件开发方法论。它主张在AI辅助开发中，人类工程师的核心产出是结构化的规范文档，而代码则是AI依据规范生成的衍生物。规范支持版本控制，可审查、可追溯，构成项目的“唯一直相来源”（Single Source of Truth）。

针对以上定义，本书按“为什么一怎么做一怎么做好”三个阶段展开，层层拆解SDD理论、工具、实战、团队与Agent融合方案。

第一阶段：认识问题

本阶段核心目标是辨析当下Vibe Coding的底层缺陷，建立“规范先行”的核心思维，厘清SDD的完整定义、历史脉络与基础工作逻辑。

开篇以一个真实项目的“三天崩塌”典型案例，罗列Vibe Coding的五大致命短板，梳理软件开发三代范式迭代路径：重规范无迭代的瀑布模型、重迭代轻规范的敏捷开发、兼顾规范与灵活迭代的SDD新模式，直观对比三者优劣。

接着溯源规范开发三次发展浪潮，从1988年契约式设计、2015年API-First开发，延伸至2025年AI原生SDD。明确SDD五大核心原则：规范先行、规范即文档、规范可执行、规范纳入版本控制、代码服务于规范。

详解SDD的六阶段工作流，确立proposal.md、design.md、tasks.md三份核心规范文档的分工——三份规范完成需求、架构、任务的心智创造，代码只是落地执行的物质创造。清晰界定SDD适用边界，破除大众常见认知误区。

第二阶段：掌握方法

把碎片化口头需求转化为结构化proposal.md需求文档，提供完整写作范本与规范质量自检清单，演示借助Claude Code辅助生成需求文件；

讲解模块划分、接口契约、数据模型、非功能性约束的撰写方法，引入ADR（架构决策记录）机制，输出完整design.md架构模板；

拆解tasks.md任务执行文件，提出“一个任务对应一份可验证交付物”黄金拆分法则，基于DAG（有向无环图）管理任务依赖，区分串行单 Agent 执行、并行子智能体执行两套工作流，为每项任务定义清晰的验收标准；

搭建规范驱动的分层测试体系，区分四类代码变更对应的规范同步流程，提供存量老旧项目渐进补全规范方案。完整演示从规范更新、代码生成、全量测试到迭代优化的闭环流程。

第三阶段：深入应用

本阶段上升到智能体融合、团队协作、行业长期思考层面，打通SDD与Harness工程的联动体系，支撑企业级规模化AI开发。

搭建SDD与五大Agent设计模式的融合体系：规划执行、生成评审、层级委托、护栏三明治、条件路由模式。明确SDD规范作为Harness工程核心输入的定位，可存入CLAUDE.md记忆系统、通过Hooks实现自动化规范校验、驱动子智能体任务分发。

专注团队落地实践，规划个人试点到全团队推广三阶段落地路线，划分规范撰写、审核、执行三类协作角色，设计规范PR审查流程。支持SDD与Scrum、CI/CD流水线无缝融合，配套可量化的落地效果评估指标，搭建三层自动化规范校验机制。

梳理SDD适用与不适用场景，分析SDD与各类传统开发方法论的融合路径，预判AI编程从人工辅助到自主智能体的长期演进趋势，提出“规范即代码”行业终极愿景。

点明AI时代工程师能力迁移核心：快速编码不再稀缺，清晰定义需求、搭建标准化工程体系的综合工程素养才是核心竞争力。帮助读者完成从即兴Vibe Coding到规范驱动开发的思维升级。

Part.3

为什么写这本书

当下各类AI编程工具均宣传十倍开发效率，但开发者的真实体验普遍是短期提速、长期持续内耗。作者发现问题根源是开发者仅依靠碎片化聊天指令传递需求，没有结构化、可持久化的标准化规范，AI只能自行推演业务约束，进而引发上下文漂移、技术债堆积等问题。 

基于行业普遍痛点，作者结合《高效能人士的七个习惯》中“以终为始”的底层逻辑，融合瀑布模型与敏捷开发的优势，提出适配AI智能体的规范驱动开发方法论。

 全书不堆砌工具操作命令，而是聚焦长期不变的底层工程思想，希望帮助开发者把“厘清需求”前置，将重复返工、无效Token损耗的成本彻底消除，搭建稳定可控、可迭代、团队可复用的AI编程体系。

Part.4

结语

《SDD实战：规范驱动开发之道》以Vibe Coding的工程缺陷为切入点，提出AI原生的规范驱动开发方法论，通过标准化三份核心规范固化开发意图，打通SDD Agent Harness工程、主流AI编程工具、企业团队流水线的落地链路。

本书一大特点是思想体系完整，注重传授具有长期复用价值的方法论，包括SDD的核心原则、三份规范文档的设计逻辑、需求—架构—任务的递进关系、Agent与规范的融合模式、团队规范治理思路、上下文资源管控底层逻辑等核心思想。

▲精彩书摘

无论读者使用Claude Code、Cursor、各类国产CLI AI编程工具，还是使用后续出现的全新智能体产品，书中的规范驱动底层逻辑、Harness工程协同思路均可直接复用。

本书另一大特点是重视实战。书中围绕“智能日报生成器”这一完整项目，从需求分析到验证交付，手把手教读者走完SDD的6个阶段，读者学完即可直接套用模板落地规范驱动开发。

▲精彩书摘

本书语言通俗易懂，作者借助虚拟人物咖哥和小冰的对话展开技术讨论，融入真实场景中的问题，推动内容层层展开，兼具实用性、趣味性与可读性。

本书适配多类专业群体：

深受上下文漂移、代码不可维护困扰的开发者；

需要团队规模化推广AI辅助开发的技术负责人、架构师；

深耕Agent智能体、Harness编排框架设计，想要打通规范与智能体联动的技术从业者；

使用OpenSpec、Spec-Kit、Kiro等规范工具，缺少标准化流程的开发者。

告别Vibe Coding，吃透SDD软件工程新范式，想在AI时代领跑的开发者请翻开《SDD实战：规范驱动开发之道》！

Part.5

黄佳更多作品

▼点击下方，即可购书

本书系统介绍了Claude Code的技术架构与工程化实践。

全书从“软件工程”视角解析从命令行助手到可编程Agent的演进路径，并围绕Claude Code的四层架构模型展开，深入探讨记忆系统（CLAUDE.md）、技能（Skills）、子智能体（SubAgents）、事件钩子（Hooks）与MCP等核心机制的设计哲学与协同原理。

书中不仅提供了翔实的技术选型指南、组件配置方法和触发机制对比，更通过大量实战案例展示了如何构建安全、高效、可维护的AI辅助编程工作流，涵盖从个人开发到团队协作，再到与CI/CD流水线集成的企业级部署全流程。

▼点击下方，即可购书

本书是Agent时代的架构设计与工程实践指南，旨在连接传统软件工程与大模型应用。 

全书分为上下两篇：上篇以历史演进为线索，剖析软件范式从“确定性结构”向“概率性智能”的演进，揭示Agent诞生的必然性；下篇作为实战手册，系统构建涵盖感知、记忆、推理、行动、反思与协作的通用架构，并拆解21个核心设计模式。 

本书超越代码层面，从架构、机制与实践等多维度出发，通过丰富案例，为解决“如何在不确定的大模型上构建可靠系统”提供了可复用的方法论。

▼点击下方，即可购书

本书围绕完整的RAG系统生命周期，系统拆解其架构设计与实现路径，助力开发者和企业构建实用、可控且可优化的智能问答系统。

首先，本书以“数据导入—文本分块—信息嵌入—向量存储”为主线，详细阐述从多源文档加载到结构化预处理的全流程，并深入解析嵌入模型的选型、微调策略及多模态支持。

其次，从检索前的查询构建、查询翻译、查询路由、索引优化，到检索后的重排与压缩，全面讲解提高召回质量和内容相关性的方法。接下来介绍多种生成方式及RAG 系统的评估框架。

最后，展示复杂RAG范式的新进展，包括GraphRAG、Modular RAG、Agentic RAG和Multi-Modal RAG的构建路径。

—END—