Spec-Kit实战:AI编程全流程落地电子书

内容提要

前言

资源与支持

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

第1章 AI编程的范式转移

1.1 氛围编程的局限与挑战

1.1.1 局限一：代码质量如沙上建塔

1.1.2 局限二：可维护性被严重透支

1.1.3 局限三：团队协作沦为“各自即兴”

1.1.4 局限四：结果不确定性

1.2 SDD：新一代软件工程方法论

1.2.1 SDD的定义

1.2.2 SDD的三根支柱

1.2.3 为什么现在需要SDD——AI时代的必然选择

1.2.4 SDD的适用场景与边界

1.3 SDD核心价值：确定性、可维护性与团队协作

第2章 深入理解Spec-Kit

2.1 Spec-Kit的定位

2.1.1 脚手架：零摩擦的项目启动

2.1.2 工作流引擎：从宪法到实现的可执行流程

2.1.3 工具包：技术栈中立与AI可选性

2.2 核心概念：宪法、规范、计划与任务

2.2.1 宪法

2.2.2 规范

2.2.3 计划

2.2.4 任务

2.2.5 四者的关系

第3章 环境配置与AI编程代理

3.1 安装与配置Spec-Kit

3.1.1 安装specify

3.1.2 验证系统依赖项是否完善

3.2 认识与安装CodeBuddy

3.2.1 CodeBuddy是什么

3.2.2 安装CodeBuddy CLI

3.3 其他AI编程代理

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

第4章 【基础】组件驱动开发：用户名片组件

4.1 项目初始化及宪法确立

4.1.1 初始化项目

4.1.2 首次启动CodeBuddy

4.1.3 确立项目宪法

4.2 编写组件规范

4.2.1 输入需求

4.2.2 审视需求是否被准确理解

4.3 制定技术方案

4.3.1 输入技术方案

4.3.2 生成技术方案相关文件

4.4 生成高质量Vue组件

4.4.1 拆解任务清单

4.4.2 执行实现

4.4.3 验证项目效果

4.5 小结

第5章 【进阶】状态管理：任务看板

5.1 项目初始化及宪法确立

5.2 编写任务看板规范

5.3 制定技术方案

5.4 任务拆解与实现：从列表到看板

5.4.1 拆解任务

5.4.2 执行实现

5.4.3 在浏览器中验证

第6章 【基础】构建后端API与前后端联调

6.1 项目初始化及宪法确立

6.1.1 初始化后端API服务项目

6.1.2 编写后端API服务项目宪法

6.2 定义后端API契约

6.2.1 后端API契约：核心作用与价值解析

6.2.2 对齐契约与前端数据模型

6.2.3 输入API契约描述

6.2.4 审视契约：前后端一致性检查

6.2.5 确认契约并停止操作

6.3 规划技术方案

6.4 拆解与实现任务

6.4.1 拆解任务

6.4.2 执行实现

6.4.3 验证后端API服务

6.4.4 验证通过并终止操作

6.5 前后端联调：替换前端数据层

6.5.1 理解数据层替换

6.5.2 配置前端开发代理

6.5.3 阅读API契约——了解后端接口

6.5.4 创建api.ts替换storage.ts

6.5.5 适配BoardContext的异步调用

6.5.6 前后端联调验证

第7章 【进阶】安全加固与前后端联调

7.1 更新宪法：增加安全原则

7.1.1 更新后端API服务项目宪法

7.1.2 更新前端任务看板项目宪法

7.1.3 确认宪法并停止操作

7.2 扩充规范：认证与权限

7.2.1 理解安全加固对规范的影响

7.2.2 更新后端API服务项目规范

7.2.3 更新前端任务看板项目规范

7.2.4 确认规范并停止

7.3 更新方案：安全模块的设计

7.3.1 理解安全模块的技术选型

7.3.2 更新后端API服务项目计划文件

7.3.3 更新前端任务看板项目计划文件

7.3.4 确认计划并停止

7.4 前后端功能拆解与实现

7.4.1 后端API服务项目：拆解任务

7.4.2 后端API服务项目：实现任务

7.4.3 后端API服务项目：验证认证接口

7.4.4 同步后端API契约到前端

7.4.5 前端项目：拆解任务

7.4.6 前端项目：实现安全任务

7.4.7 前端项目：验证安全认证功能

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

第8章 存量系统Spec-Kit开发实践： 存量系统设计知识和代码理解

8.1 存量系统面临的独特挑战

8.1.1 文档缺失、代码错误的困境

8.1.2 隐含业务逻辑与“神秘代码”现象

8.1.3 系统脆弱，开发者不敢轻易重构

8.1.4 SDD对存量系统的价值再审视

8.2 存量系统理解：从代码到知识

8.2.1 静态分析：模块结构、调用链、数据流

8.2.2 动态分析：运行时行为捕获

8.2.3 架构与集成分析

8.2.4 数据模型理解

8.3 从存量系统中提取规范：逆向工程实践

8.3.1 API规范提取

8.3.2 业务规则与行为规范提取

8.3.3 数据契约与领域模型规范

8.3.4 流程规范提取（工作流提取）

8.4 规范验证：确保规范与现有系统一致

8.4.1 规范与实现的一致性测试

8.4.2 构建回归测试基线

8.4.3 处理歧义与非确定性行为

8.5 在存量系统中增量落地Spec-Kit

8.5.1 选择首个子域

8.5.2 建立规范基线，固定系统基准行为

8.5.3 双轨工作流

8.5.4 渐进式重构：用规范驱动安全替换旧模块

8.5.5 组织与协作建议

8.6 综合案例：为某电商订单系统引入SDD

8.6.1 系统背景与痛点

8.6.2 规范提取过程演示

8.6.3 验证与问题发现

8.6.4 新需求开发：使用Spec-Kit流程新增“订单拆分”功能

8.6.5 成果与经验总结

8.7 常见陷阱与应对策略

8.7.1 过度提取：规范膨胀症

8.7.2 忽略外部依赖的行为变化

8.7.3 团队成员的抵触（“写规范不如改代码”）

8.7.4 规范与代码长期失步

8.8 小结

第9章 从氛围编程到SDD，必由之路与未来图景

9.1 氛围编程的局限性：繁荣表象下的暗流

9.2 SDD：系统性突破每一个局限

9.3 展望：SDD的下一站

9.4 启程建议：如何从你的下一个PR开始拥抱SDD

结语 秩序不是创造力的敌人，而是规模化的朋友