分享一个 AI coding 的实践,强烈建议养成习惯:
每次做重大功能或结构改动前,先写 design doc。
流程可以很简单:
1. 用 plan mode 先做 research
2. 输出一份结构化 design doc
3. 基于 doc 再拆实现 plan
4. 实现
5. 把 doc 编号存档,commit 进仓库
核心不在“文档好不好看”,而在两件事。
第一,把思考外化。
很多人直接让 AI 写代码,结果是边写边改,方向反复。
先做 design,相当于把隐性假设和约束写清楚,减少返工。
第二,形成演进轨迹。
把 design doc 编号存进仓库,就像数据库的 migrations。
你不仅记录代码变化,还记录决策逻辑。
几个月后回看,你会看到:
• 当时为什么选 A 没选 B
• 哪些假设后来被推翻
• 哪些技术债是主动承担
这对中长期项目极其重要。
AI 很擅长生成实现细节,但架构判断仍然需要人主导。
design doc 是你对项目“方向盘”的掌控方式。
长期来看,代码会被重写很多次。
真正沉淀下来的,是思考路径。##ai编程助手已累计编写15亿行代码#