5 步快速上手
从零开始，5 分钟掌握文档驱动开发
1
创建 /docs 文件夹
在项目根目录创建文档目录
2
写 intent.md
明确为什么做、为谁做
3
写 spec.md
定义做什么、用户如何使用
4
写 plan.md
规划技术方案、怎么做
5
生成代码
让 Claude 根据文档生成代码
三层文档系统
文档是代码的源头，不是附属品
intent.md最稳定意图层
回答: WHY & FOR WHOM
- 项目愿景
- 目标用户
- 核心问题
- 成功标准
- 非目标
spec.md中等稳定规格层
回答: WHAT
- 功能列表
- 用户旅程
- 验收标准
- 非功能需求
plan.md最灵活计划层
回答: HOW
- 技术栈
- 架构设计
- 数据模型
- 实现细节
适合你吗?
✅ 强烈推荐
- 需求不明确的新项目（0 到 1）
- 需要迭代的功能开发
- 团队协作项目（文档即规范）
- 复杂的 SaaS 应用
❌ 可以跳过
- 快速修 Bug（直接改就行）
- 原型验证（还不确定要做什么）
- 一次性脚本（用完就扔）
常见问题
- Document-Driven Development 和传统文档有什么区别？
传统文档是「写完代码后补文档」，DDD 是「先写文档再生成代码」。文档是代码的源头，不是附属品。
- 这个方法适合个人开发者吗？
非常适合。个人开发者更容易「想到哪写到哪」，DDD 帮你保持清晰的思路，避免返工。
- 三个文档都必须写吗？
建议都写，但可以简化。小项目每个文档几行就够，关键是思考过程，不是文档长度。
- 如何和 Claude Code 配合使用？
把这个 Skill 添加到 Claude Code，它会自动引导你先创建文档，再生成代码。