Document-Driven Development：让 AI 编程从失控到可控

用 Claude 写代码时，你是否遇到过这些问题？

• 生成的代码和预期差很远
• 改了几轮还是不对
• 项目越大越难控制

问题的根源是：你没有给 AI 足够的上下文。

什么是 Document-Driven Development

Document-Driven Development（DDD）是一种「先写文档，再生成代码」的开发方法。通过三层文档系统，让 AI 理解你的意图、规格和计划，从而生成符合预期的代码。

三层文档系统

1. intent.md - 意图层

回答 WHY & FOR WHOM（为什么做、为谁做）

# 项目意图

## 愿景
一句话描述项目要解决什么问题

## 目标用户
谁会使用这个产品

## 核心问题
用户现在面临什么痛点

## 成功标准
怎样算成功

## 非目标
明确不做什么

2. spec.md - 规格层

回答 WHAT（做什么）

# 产品规格

## 功能列表
- 功能 A：描述
- 功能 B：描述

## 用户旅程
用户如何使用产品

## 验收标准
每个功能的完成标准

## 非功能需求
性能、安全、可用性要求

3. plan.md - 计划层

回答 HOW（怎么做）

# 技术计划

## 技术栈
使用什么技术

## 架构设计
系统如何组织

## 数据模型
数据结构设计

## 实现步骤
分阶段实现计划

5 步快速上手

1. 创建 /docs 文件夹 - 在项目根目录创建文档目录
2. 写 intent.md - 明确为什么做、为谁做
3. 写 spec.md - 定义做什么、用户如何使用
4. 写 plan.md - 规划技术方案、怎么做
5. 生成代码 - 让 Claude 根据文档生成代码

什么时候用 DDD

强烈推荐：

• 需求不明确的新项目（0 到 1）
• 需要迭代的功能开发
• 团队协作项目（文档即规范）
• 复杂的 SaaS 应用

可以跳过：

• 快速修 Bug（直接改就行）
• 原型验证（还不确定要做什么）
• 一次性脚本（用完就扔）

实际效果

使用 DDD 后：

• 减少 40% 返工时间
• 代码质量显著提升
• 需求不再漂移

开始使用

访问 Document-Driven Development Skill 获取完整的 Skill 定义，复制到 Claude 即可开始使用。