切换深色模式
Prompt 与需求表达
在 Vibe Coding 中,最重要的能力不是“会不会写代码”,而是:
能不能把想法说清楚。
很多人使用 AI 编程工具失败,不是因为 AI 太弱,而是因为一开始给 AI 的需求太模糊。
例如:
帮我做一个网站。这个需求太宽泛。AI 不知道:
- 网站给谁用?
- 网站解决什么问题?
- 需要哪些页面?
- 是否需要登录?
- 数据从哪里来?
- 用什么技术栈?
- 第一版只做哪些功能?
- 什么结果算完成?
更好的表达是:
我想做一个 AI 工具导航站。
目标用户:
经常使用 AI 工具的内容创作者和知识工作者。
核心功能:
1. 按分类浏览工具;
2. 支持关键词搜索;
3. 每个工具展示名称、介绍、标签、官网链接;
4. 支持收藏工具;
5. 第一版只使用本地 mock 数据,不接后端。
技术要求:
使用 React + Vite + TypeScript。
请先不要写代码。
请先根据以上信息生成 SPEC.md,并指出需求中仍然不清楚的地方。这就是 Prompt 与需求表达的价值。
本模块解决什么问题?
本模块帮助你解决 Vibe Coding 中最常见的几个问题:
- 不知道怎么向 AI 描述项目;
- AI 总是生成不符合预期的代码;
- AI 一次写太多,项目变乱;
- 需求没说清,后面反复返工;
- 不知道如何写 SPEC.md;
- 不知道如何拆 TASKS.md;
- 不知道如何让 AI 先提问;
- 不知道如何描述 UI;
- 不知道如何让 AI 修 Bug;
- 不知道如何让 AI 重构代码;
- 不知道如何让 AI 写测试。
简单说:
这个模块教你如何从“一个模糊想法”走到“AI 可以执行的开发任务”。
你会学到什么?
完成本模块后,你应该能够:
- 写出清楚的编程 Prompt;
- 把一句话想法拆成完整需求;
- 让 AI 先提问,而不是直接写代码;
- 生成可执行的
SPEC.md; - 生成可追踪的
TASKS.md; - 描述页面、组件、交互和 UI 风格;
- 写出高质量 Bug 修复 Prompt;
- 控制 AI 重构范围;
- 让 AI 生成有效测试;
- 使用模板库快速开始项目。
推荐学习顺序
| 顺序 | 文章 | 你会学到什么 |
|---|---|---|
| 1 | 编程 Prompt 入门 | 编程 Prompt 的基本结构和写法 |
| 2 | 如何把想法写成清楚需求 | 从模糊想法到明确需求 |
| 3 | 从想法到 SPEC.md | 生成项目规格文档 |
| 4 | TASKS.md 写法 | 把规格文档拆成开发任务 |
| 5 | 让 AI 先提问 | 让 AI 先澄清需求,减少误解 |
| 6 | UI Prompt 写法 | 描述页面、布局、风格和交互 |
| 7 | Bug 修复 Prompt | 让 AI 正确分析和修复错误 |
| 8 | 重构 Prompt | 控制 AI 重构范围,避免越改越乱 |
| 9 | 测试 Prompt | 让 AI 生成单元测试和 E2E 测试 |
| 10 | 编程 Prompt 模板库 | 可直接复制使用的开发模板 |
编程 Prompt 的核心公式
新手可以先记住这个公式:
目标 + 背景 + 技术栈 + 功能要求 + 约束条件 + 输出格式 + 验收标准对应到实际 Prompt:
我想做一个 Prompt 模板库 Web 应用。
背景:
这个工具用于整理我常用的 ChatGPT、Claude、Vibe Coding Prompt。
技术栈:
React + Vite + TypeScript。
功能要求:
1. 按分类展示 Prompt;
2. 支持搜索;
3. 支持一键复制;
4. 支持收藏;
5. 第一版使用本地 mock 数据。
约束条件:
1. 不接后端;
2. 不使用数据库;
3. 不引入复杂 UI 库;
4. 先实现核心功能,不做登录。
输出格式:
请先生成 SPEC.md,不要直接写代码。
验收标准:
1. 需求清楚;
2. 页面结构明确;
3. 功能边界明确;
4. 能继续拆成 TASKS.md。为什么要先写 SPEC.md?
很多 Vibe Coding 失败,是因为一开始就让 AI 写代码。
不推荐:
帮我做一个 Todo App。更推荐:
请先根据我的想法生成 SPEC.md。
在生成前,如果信息不足,请先向我提问。SPEC.md 的作用是:
- 明确项目目标;
- 明确目标用户;
- 明确功能范围;
- 明确页面结构;
- 明确数据模型;
- 明确技术约束;
- 明确验收标准;
- 明确第一版不做什么。
有了 SPEC.md,AI 才不容易乱猜。
为什么要写 TASKS.md?
SPEC.md 说明“要做什么”。
TASKS.md 说明“按什么顺序做”。
一个项目不能一次性全部交给 AI。更好的方式是拆成小任务:
1. 创建项目结构
2. 实现静态页面
3. 添加数据结构
4. 实现列表渲染
5. 实现搜索
6. 实现筛选
7. 实现复制按钮
8. 实现收藏
9. 补充测试
10. 部署这样每一步都更可控。
本模块的核心原则
1. 不要一上来写代码
先澄清需求。
请先问我问题,不要直接写代码。2. 不要一次做完整项目
分阶段做。
先实现静态页面,再加交互,再接数据。3. 不要让 AI 猜
缺什么就让 AI 问。
如果信息不足,请先向我提问。4. 不要让 AI 随意修改
限制范围。
只修改和搜索功能相关的文件,不要做无关重构。5. 不要跳过验收标准
让 AI 知道什么算完成。
完成标准:页面可以搜索工具名称,空关键词显示全部工具。Prompt 写得好,代码才更稳定
Vibe Coding 的质量,很大程度取决于你是否能给 AI 提供清晰上下文。
一个好的编程 Prompt 通常具备:
- 目标明确;
- 背景清楚;
- 技术栈明确;
- 功能可拆分;
- 约束条件具体;
- 输出格式明确;
- 验收标准可检查;
- 安全边界清楚。
小结
Prompt 与需求表达是 Vibe Coding 的核心能力。
你可以这样理解:
需求越清楚,AI 越像开发助手。需求越模糊,AI 越像随机代码生成器。
学习本模块的目标,不是背很多 Prompt,而是掌握一套稳定流程:
想法
→ 需求澄清
→ SPEC.md
→ TASKS.md
→ 小步开发
→ 测试
→ 审查
→ 部署当你能把一个模糊想法转化成清晰需求,Vibe Coding 才真正开始变得可靠。