6.6 KiB
6.6 KiB
SDD 规格驱动落地：文档管理策略
研讨会背景与目的
本次分享是 AI 编程相关话题的延续，主要聚焦 SDD（Spec-Driven Development，规格驱动开发） 的文档管理策略。
研讨会机制
- 目的：让参会者能够参与达成社区共识，分享各公司在 AI 编程实践中的经验
- 形式：咨询师分享观察到的公司实现方案、架构设计、系统设计等内容
- 价值：对个人和团队帮助都非常大，通过集体讨论形成共识
特别感谢卡尼克老哥在研讨会期间贡献了大量分享思想，受益颇多。
AI 编程发展历程回顾
时间线概览
| 时间 | 分享内容 | 核心概念 |
|---|---|---|
| 2025年6月 | 早期 AI 编程实践 | DPER5 方法论 |
| 后续 | MCP 等工具整合 | MCP、Scales |
| 5月9日 | Plan 和 Build 模式 | 新因子（吸引子）概念 |
| 本次 | SDD 文档管理策略 | 规格驱动落地 |
DPER5 方法论
核心思想
DPER5 将软件工程中使用 AI 进行开发的过程分为 5 个弱阶段（Weak Stages）：
Discover → Plan → Execute → Review → Refine
↓ ↓ ↓ ↓ ↓
发现 规划 执行 评审 优化
阶段特性
- 不同阶段 AI 会按照不同的模式运行
- 例如在 Design 模式或 Discover 模式下，AI 不会修改代码
- 这种分阶段约束是驯服 AI 的简单有效方法
实践应用
- 在早期阶段（2025年），演讲者已经在公司内部领先应用
- 采用
Design → Plan → Execute的流程驱动开发 - 该方法使用了较长时间，有效规范了 AI 辅助开发流程
MCP（Model Context Protocol）工具生态
工具整合
后续随着 MCP 以及相关工具套件的出现，形成了完整的 AI 编程工具生态：
- MCP（Model Context Protocol）：模型上下文协议
- Scales：扩展工具
- SDD：规格驱动开发方法论
这些工具被整合到一份 PPT 手册中，作为团队 AI 编程的指南或手册参考。
SDD（规格驱动开发）
SDD 的核心模式
SDD 提供了多种工作模式，适用于不同的开发场景：
| 模式 | 适用场景 | AI 行为特征 |
|---|---|---|
| Design | 需求分析、架构设计 | 不修改代码，仅提供设计建议 |
| Discover | 探索发现、方案调研 | 不修改代码，专注于信息收集 |
| Plan | 规划分解、任务拆解 | 生成实现计划 |
| Build | 代码实现、具体开发 | 执行代码编写和修改 |
新因子（吸引子）概念
由 countic 大佬在 5月9日的分享中引入：
物理学的概念解释：
- 在混沌系统中，存在两种震荡反馈的系统
- 这种系统最终会收敛到一个稳定状态
- 这个收敛点被称为 吸引子（Attractor）
在 AI 编程中的应用：
- 通过引入新因子，可以引导 AI 的输出趋向于预期的稳定状态
- 帮助控制 AI 在复杂任务中的发散性
- 实现更可控的 AI 驱动开发流程
SDD 文档管理策略
本次分享的核心主题，聚焦于规格驱动开发的文档管理方法
文档在 SDD 中的作用
- 规格定义：明确需求和设计规范，作为开发的基准
- 上下文传递：在不同阶段之间传递上下文信息
- 版本控制：记录规格的变更历史
- 团队协作：统一团队对需求的理解和实现方式
文档管理最佳实践
（基于 SDD 方法论，文档管理应遵循以下原则）
- 规格优先：在开发前先完成规格文档的编写
- 增量迭代：规格文档随项目进展逐步完善
- 双向追溯：规格与实现之间保持可追溯性
- 工具集成：将文档管理与 AI 编程工具链整合
工具链整合方案
推荐的 AI 编程工具栈
┌─────────────────────────────────────────────────────┐
│ 规格层 (Spec) │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Design │ │ Discover │ │ Plan │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
├─────────────────────────────────────────────────────┤
│ 工具层 (Tools) │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ MCP │ │ Scales │ │ SDD │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
├─────────────────────────────────────────────────────┤
│ 执行层 (Execution) │
│ ┌─────────────┐ ┌─────────────┐ │
│ │ Build │ │ Review │ │
│ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────┘
MCP 的核心功能
- 提供标准化的上下文协议
- 实现 AI 与外部工具的无缝集成
- 支持多工具协同工作
社区贡献者致谢
| 贡献者 | 贡献内容 |
|---|---|
| 卡尼克 | 大量分享思想，研讨会核心参与者 |
| countic | 引入新因子（吸引子）概念，分享 Plan/Build 模式 |
| 少个分号 | SDD 方法论整理，工具链整合，文档管理策略分享 |
后续话题预告
本次分享的议程安排：
- SDD 文档管理策略（当前内容）
- AIGC 模板相关话题（由卡尼克老哥分享）
参考资源
- 本次分享的 PPT 资料（可作为团队 AI 编程手册/指南）
- 搜索关键词：
AI编程、MCP、SDD、DPER5、规格驱动开发 - 相关标签：
人工智能、规格驱动开发、AI编程