Skip to content

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生成项目规格文档
4TASKS.md 写法把规格文档拆成开发任务
5让 AI 先提问让 AI 先澄清需求,减少误解
6UI Prompt 写法描述页面、布局、风格和交互
7Bug 修复 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 才真正开始变得可靠。

最近更新