书名：Spec-Kit实战：AI编程全流程落地  
定价：59.8  
ISBN：9787115700667  
作者：黄桂钊、茹炳晟  
版次：第1版  
出版时间：2026-08  

内容提要：  
规范驱动开发（SDD）是软件开发领域中应对AI编程代理挑战的方法论。本书聚焦SDD，探讨的核心问题是在AI编程代理普及的背景下如何提升代码质量、可维护性与团队协作效率。本书构建了从理论到实践的完整知识体系：*部分系统讲解SDD的基础理论与核心价值、Spec-Kit的核心概念，介绍环境配置与AI编程代理；*部分通过组件驱动开发、状态管理、构建后端API与前后端联调、*加固与前后端联调等实战案例，展示如何运用Spec-Kit构建复杂应用系统；第三部分探讨存量系统的改造方案，并对SDD的未来发展趋势进行展望，帮助读者理解从氛围编程到SDD的*由之路。 本书适合各类软件开发人员（包括前端开发工程师、后端开发工程师、全栈开发工程师、软件架构师等）阅读，也适合作为高校计算机相关专业的教学参考用书。无论是软件开发领域的新手，还是经验丰富的*工程师，*能学到实用的开发技巧。  



作者简介：  
黄桂钊，拥有十多年的架构设计和程序开发经验，曾作为核心技术骨干、管理人员在中兴通讯等公司任职，主导过多款大型产品的架构设计；现任某科技公司的AI架构师，专注于AI工程化落地应用实践。《Cursor与MCP快速入门：*基础开发智能体应用》作者，*“AI趋势洞察家”主理人。 茹炳晟，腾讯TechLead，腾讯研究院特约研究员，腾讯集团技术委员会委员，中国计算机学会（CCF）TF研发效能SIG主席，“软件研发效能度量规范”团体标准核心编写*，中国商业联合会互联网应用技术委员会智库*，中国通信标准化协会TC608云计算标准和开源推进委员会云上软件工程工作组副组长，国内外各大技术峰会的联席主席、出品人和主题演讲嘉宾，*“茹炳晟聊软件研发”主理人。著有技术*书《测试工程师全栈技术进阶与实践》和《现代软件测试技术之美》等，译有《现代软件工程》和《DevOps实践指南（第2版）》等。  

目录：  


第 一部分 规范驱动开发的基础理论与工具准备  

第 1章 AI编程的范式转移 …………………………………………… 2  
1.1 氛围编程的局限与挑战 …………………………………………… 2  
1.1.1.局限一：代码质量如沙上建塔………………………………… 3  
1.1.2.局限二：可维护性被严重透支………………………………… 3  
1.1.3.局限三：团队协作沦为“各自即兴”………………………… 4  
1.1.4.局限四：结果不确定性………………………………………… 5  
1.2 SDD：新一代软件工程方法论 …………………………………… 5  
1.2.1.SDD的定义……………………………………………………… 6  
1.2.2.SDD的三根支柱………………………………………………… 7  
1.2.3.为什么现在需要 SDD——AI时代的*然选择………………… 8  
1.2.4.SDD的适用场景与边界………………………………………… 9  
1.3 SDD核心价值：确定性、可维护性与团队协作……………… 10  

第 2章深入理解 Spec-Kit ………………………………………… 11  
2.1 Spec-Kit的定位 ………………………………………………… 11  
2.1.1.脚手架：*摩擦的项目启动………………………………… 11  
2.1.2.工作流引擎：从宪法到实现的可执行流程………………… 12  
2.1.3.工具包：技术栈中立与 AI可选性 ………………………… 14  
2.2 核心概念：宪法、规范、计划与任务 ………………………… 14  
2.2.1.宪法…………………………………………………………… 15  
2.2.2.规范…………………………………………………………… 16  
2.2.3.计划…………………………………………………………… 16  
2.2.4.任务…………………………………………………………… 17  
2.2.5.四者的关系…………………………………………………… 18  

第3章环境配置与 AI编程代理 ………………………………… 20  
3.1 安装与配置 Spec-Kit …………………………………………… 20  
3.1.1.安装 specify…………………………………………………… 20  
3.1.2.验证系统依赖项是否完善…………………………………… 22  
3.2 认识与安装 CodeBuddy ………………………………………… 23  
3.2.1.CodeBuddy是什么…………………………………………… 23  
3.2.2.安装 CodeBuddy.CLI ………………………………………… 24  
3.3 其他 AI编程代理………………………………………………… 25  

*部分规范驱动开发实战进阶  

第4章【基础】组件驱动开发：用户名片组件 ………………… 28  
4.1 项目初始化及宪法确立 ………………………………………… 28  
4.1.1.初始化项目…………………………………………………… 28  
4.1.2.*启动 CodeBuddy………………………………………… 30  
4.1.3.确立项目宪法………………………………………………… 31  
4.2 编写组件规范 …………………………………………………… 34  
4.2.1.输入需求……………………………………………………… 34  
4.2.2.审视需求是否被*理解…………………………………… 35  
4.3 制定技术方案 …………………………………………………… 37  
4.3.1 输入技术方案………………………………………………… 37  
4.3.2 生成技术方案相关文件……………………………………… 37  
4.4 生成高质量 Vue组件 …………………………………………… 40  
4.4.1.拆解任务清单………………………………………………… 40  
4.4.2.执行实现……………………………………………………… 43  
4.4.3.验证项目效果………………………………………………… 45  
4.5 小结 ……………………………………………………………… 46  

第5章【进阶】状态管理：任务看板 …………………………… 48  
5.1 项目初始化及宪法确立 ………………………………………… 48  
5.2 编写任务看板规范 ……………………………………………… 51  
5.3 制定技术方案 …………………………………………………… 53  
5.4 任务拆解与实现：从列表到看板 ……………………………… 55  
5.4.1.拆解任务……………………………………………………… 55  
5.4.2.执行实现……………………………………………………… 57  
5.4.3.在浏览器中验证……………………………………………… 58  


第6章【基础】构建后端 API与前后端联调 …………………… 61  
6.1 项目初始化及宪法确立 ………………………………………… 61  
6.1.1.初始化后端 API服务项目…………………………………… 61  
6.1.2.编写后端 API服务项目宪法………………………………… 62  
6.2 定义后端 API契约 ……………………………………………… 64  
6.2.1.后端 API契约：核心作用与价值解析……………………… 64  
6.2.2.对齐契约与前端数据模型…………………………………… 66  
6.2.3.输入 API契约描述…………………………………………… 66  
6.2.4.审视契约：前后端一致性检查……………………………… 68  
6.2.5.确认契约并停止操作………………………………………… 70  
6.3 规划技术方案 …………………………………………………… 71  
6.4 拆解与实现任务 ………………………………………………… 72  
6.4.1.拆解任务……………………………………………………… 72  
6.4.2.执行实现……………………………………………………… 74  
6.4.3.验证后端 API服务…………………………………………… 75  
6.4.4.验证通过并终止操作………………………………………… 77  
6.5 前后端联调：替换前端数据层 ………………………………… 77  
6.5.1.理解数据层替换……………………………………………… 77  
6.5.2.配置前端开发代理…………………………………………… 78  
6.5.3.阅读 API契约——了解后端接口…………………………… 79  
6.5.4.创建 api.ts替换 storage.ts…………………………………… 80  
6.5.5.适配 BoardContext的异步调用……………………………… 82  
6.5.6.前后端联调验证……………………………………………… 83  

第7章【进阶】*加固与前后端联调 ………………………… 85  
7.1 更新宪法：增加*原则 ……………………………………… 85  
7.1.1.更新后端 API服务项目宪法………………………………… 85  
7.1.2.更新前端任务看板项目宪法………………………………… 86  
7.1.3.确认宪法并停止操作………………………………………… 87  
7.2 扩充规范：认证与权限 ………………………………………… 88  
7.2.1.理解*加固对规范的影响………………………………… 88  
7.2.2.更新后端 API服务项目规范………………………………… 89  
7.2.3.更新前端任务看板项目规范………………………………… 90  
7.2.4.确认规范并停止……………………………………………… 92  
7.3 更新方案：*模块的设计 …………………………………… 92  
7.3.1.理解*模块的技术选型…………………………………… 92  
7.3.2.更新后端 API服务项目计划文件…………………………… 93  
7.3.3.更新前端任务看板项目计划文件…………………………… 94  
7.3.4.确认计划并停止……………………………………………… 95  
7.4 前后端功能拆解与实现 ………………………………………… 96  
7.4.1.后端 API服务项目：拆解任务……………………………… 96  
7.4.2.后端 API服务项目：实现任务……………………………… 97  
7.4.3.后端 API服务项目：验证认证接口………………………… 98  
7.4.4.同步后端 API契约到前端…………………………………… 100  
7.4.5.前端项目：拆解任务………………………………………… 101  
7.4.6.前端项目：实现*任务…………………………………… 102  
7.4.7.前端项目：验证*认证功能……………………………… 102  


第三部分存量系统改造与未来展望  

第8章 存量系统 Spec-Kit开发实践：存量系统设计知识和代码理解 …………………………………………… 106  
8.1 存量系统面临的独特挑战 ……………………………………… 106  
8.1.1.文档缺失、代码错误的困境………………………………… 106  
8.1.2.隐含业务逻辑与“神秘代码”现象………………………… 107  
8.1.3.系统脆弱，*不敢轻易重构…………………………… 107  
8.1.4.SDD对存量系统的价值再审视 ……………………………… 108  
8.2存量系统理解：从代码到知识 ………………………………… 108  
8.2.1.静态分析：模块结构、调用链、数据流…………………… 109  
8.2.2.动态分析：运行时行为捕获………………………………… 109  
8.2.3.架构与集成分析……………………………………………… 110  
8.2.4.数据模型理解………………………………………………… 111  
8.3 从存量系统中提取规范：逆向工程实践 ……………………… 112  
8.3.1.API规范提取 ………………………………………………… 112  
8.3.2.业务规则与行为规范提取…………………………………… 113  
8.3.3.数据契约与领域模型规范…………………………………… 114  
8.3.4.流程规范提取（工作流提取）……………………………… 115  
8.4 规范验证：确保规范与现有系统一致 ………………………… 116  
8.4.1.规范与实现的一致性测试…………………………………… 116  
8.4.2.构建回归测试基线…………………………………………… 117  
8.4.3.处理歧义与非确定性行为…………………………………… 117  
8.5 在存量系统中增量落地 Spec-Kit ……………………………… 117  
8.5.1.选择*子域………………………………………………… 118  
8.5.2.建立规范基线，固定系统基准行为………………………… 118  
8.5.3.双轨工作流…………………………………………………… 118  
8.5.4.渐进式重构：用规范驱动*替换旧模块………………… 119  
8.5.5.组织与协作建议……………………………………………… 119  
8.6综合案例：为某电商订单系统引入 SDD……………………… 120  
8.6.1.系统背景与痛点……………………………………………… 120  
8.6.2.规范提取过程演示…………………………………………… 121  
8.6.3.验证与问题发现……………………………………………… 122  
8.6.4.新需求开发：使用 Spec-Kit流程新增“订单拆分”功能… 123  
8.6.5.成果与经验总结……………………………………………… 124  
8.7常见陷阱与应对策略 …………………………………………… 124  
8.7.1.过度提取：规范膨胀症……………………………………… 125  
8.7.2.忽略外部依赖的行为变化…………………………………… 125  
8.7.3.团队成员的抵触（“写规范不如改代码”）………………… 127  
8.7.4.规范与代码长期失步………………………………………… 128  
8.8 小结 ……………………………………………………………… 129  
第 9章从氛围编程到 SDD，*由之路与未来图景 ……………… 131  
9.1 氛围编程的局限性：繁荣表象下的暗流 ……………………… 131  
9.2 SDD：系统性突破每一个局限 ………………………………… 134  
9.3 展望：SDD的下一站 …………………………………………… 136  
9.4 启程建议：如何从你的下一个 PR开始拥抱 SDD …………… 138  
结语秩序不是创造力的敌人，而是规模化的朋友…… 140