你可能会说：
- “我说了好几遍"不对"，AI 每次都只改一点点，怎么办？”
- “做之前需要先写文档吗？感觉很麻烦。”
它是什么
需求说明不必是长文档，一页甚至十行就够。关键是把只在你脑子里的东西写出来：为什么要做、给谁用、必须保留什么、明确不做什么、参考哪个现成的东西。
它最大的价值是让"不对"变得可以说清楚。没有说明时，每一轮反馈都只能描述症状（"太乱了"），AI 只好挑最明显的一层去改；有了说明，可以直接指出哪一条没满足。
和 AI 协作时，说明还有第二个用处：长对话会被压缩，写在文件里的说明不会。
打个比方
像装修前签的施工图：墙打不打、插座装几个、用什么材料都画清楚。没有图纸，每次返工只能靠"感觉还是不对"来沟通。
在这个网站里
Vibe Coding 这个板块本身就是先写说明再动手的：docs/vibecoding-plan.md 写清了定位、借鉴什么和不借鉴什么、入门与进阶各篇的大纲、每课的骨架、分阶段的排期和验收标准，之后每一步都照着它做。
容易搞混的地方
常见误解
需求说明是写给别人看的，自己做项目不需要
正确理解
和 AI 协作时，它就是写给 AI 看的。你不写，AI 就用"最常见的做法"替你补上。
你可以这样告诉 AI
复制下面这段，贴给你的 AI
先别写代码。根据我们的讨论，写一份一页以内的需求说明：目标、范围、明确不做的事、参考对象、完成标准。我确认之后，再按它来实现。
接下来去哪
先知道
- 提示词——你交给模型的全部文字：要求、背景、参考、限制。模型只能根据它看到的这些来写。
接着看
- 验收标准——事先约定的、能逐条检查的完成条件：满足了就算做完，不满足就没做完。
在这些课里出现