181 lines
6.8 KiB
Markdown
181 lines
6.8 KiB
Markdown
---
|
||
title: "[Milky] 为您整理《2026-05-30 SDD 规格驱动落地，文档管理策略》笔记 | BV1mZV76eEPC"
|
||
source: "milky@4ueo.com"
|
||
date: 2026-06-09 10:48
|
||
tags: [milky, bilibili, notes]
|
||
email_id: 2044
|
||
---
|
||
|
||
Milky 为您整理了《2026-05-30 SDD 规格驱动落地，文档管理策略》 | BV1mZV76eEPC 笔记。
|
||
|
||
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编程
|
||
|
||
──────────────────────────────
|
||
Generated by MilkyAi@Bilibili: https://space.bilibili.com/3461574540921489 |