wiki-ingest: Multi-Agent System Reliability

wiki/concepts/设计文档优先.md

@@ -0,0 +1,43 @@
+---
+title: "设计文档优先"
+type: concept
+tags: [vibe-coding, workflow, planning, documentation]
+---
+
+## 定义
+在交给 AI 生成代码之前，先完成完整的技术设计文档（含伪代码），再由 AI 执行实现。vibe coding 工程化的核心原则。
+
+## 工作流
+
+```
+需求 → 设计文档（含 service 层伪代码） → AI 直出代码 → AI review → 修改提交
+```
+
+## 设计文档应包含的内容
+- **模块划分**：每个模块的职责边界
+- **接口定义**：模块间 API/函数签名
+- **伪代码**：核心逻辑的实现步骤（降低 AI 推理难度）
+- **技术选型**：明确使用的库/框架/版本
+- **上下游链路**：模块与其他系统/服务的依赖关系
+
+## 核心价值
+- AI 直出质量与设计文档质量正相关
+- 伪代码将"创意"转化为"可执行步骤"，减少 AI 幻觉
+- 文档本身是团队知识沉淀，不依赖 AI 执行才存在
+
+## 与传统开发的区别
+
+| 维度 | 传统开发 | 设计文档优先 |
+|------|---------|------------|
+| 代码生成 | 人写 | AI 生成 |
+| 架构决策 | 人做 | 人做（通过文档） |
+| 单元测试 | 人写 | AI 生成 |
+| review | 人做 | AI + 人 |
+
+## 在 vibe coding 中的位置
+[[Vibe Coding]] = 规划驱动（设计文档）+ AI 结对执行 + 上下文固定。设计文档优先是"规划驱动"的具体实践。
+
+## Aliases
+- Design Doc First
+- 伪代码前置
+- 设计先行