第 1 课 · 学习路径 01 / 06
需求层：怎么把想法说给 AI 听
同一件事，怎么说，AI 才能一次做对七八成。这一课给你三种说法（口头 / 任务书 / 参考物）， 配 3 个真实项目复盘 —— 从"一句话丢过去"到"它能照着做"的全部过程。
核心
三种需求，三种说法
90% 的人失败在这一步：把"任务书型"和"口头需求型"都用"指令型"说了。
| 类型 | 什么时候用 | 长度 | 说法 |
|---|---|---|---|
| 指令型 | 已有项目，改一处 | 5–30 字 | [截图] 往下移动 10px |
| 任务书型 | 开一个新模块 / 一堆文件要改 | 300–1500 字 | 落成 .txt 让它读（案例 2） |
| 口头需求型 | 说出一个还没想清的产品想法 | 500–1500 字语音 | 说完立刻让它复述（案例 1） |
判据：如果你发现自己"说完之后还要解释三遍"，说明你用错了类型 —— 该升级成任务书。
需求进来，先分一次类（选错类型 = 白说）
手里有一个需求，先判断它属于哪一类
已有项目，只改一处 → 直接说：指令型
5–30 字，
[截图] + 一句话 + 一个数值，其它不动开新模块 / 一堆文件要改 → 落成文件：任务书型
前端开发.txt · 后端开发.txt · 验收标准.txt（见下一节模板）
产品想法还没想清 → 说完让它复述：口头需求型
语音从头说到尾 → 立刻「先不修改，先复述一下」→ 对了才动手
为什么必须先分类：三种类型的长度差 100 倍。用 30 字去讲一个新产品（AI 只能猜），
或者用 1000 字去改一个按钮（AI 会顺手重构），都是最常见的失败起点。
说人话
别把 AI 当"能听懂一切的人"。它更像一个技术很强、但完全不了解你的外包：
你说得越模糊，它猜得越离谱；你给的东西越具体（图、路径、现成案例），它做得越准。
分类的目的，就是让你先决定"这次要说多细"。
✕
误区：话说得越多越好。我第一次做整站时说了 300 多字口语，能成是因为后面马上补了复述和方案。
光长不行 —— 长 + 有参考物 + 有判据才行。
✓
正解：短句管"改一处"，文件管"新东西"。改一个按钮别写文档；做一套系统别只在对话框里说。
案例
三个真实项目，从头到尾
每个案例都是真实发生的，引号里是我当时的原话（含口语病），没有润色。
模板
三段式需求文档（直接抄）
这是我最值钱的一套做法：把需求写成三个 txt，放在项目根目录，然后一句话让它读。
前端开发.txt
# 项目：<一句话>
# 技术栈：<现有工程的栈，别让它自己选>
# 页面清单
1. 今日页 —— 必须解决什么问题
2. 详情页 —— 必须解决什么问题
# 每页硬要求
- 第一眼要看到什么（信息层级）
- 第二个点击能做什么（主操作）
- 不需要什么（明确砍掉，防它自作聪明）
# 视觉基调（写死，别留形容词）
- 参考物：<绝对路径 或 截图>
- 主色 / 圆角 / 字号梯度 / 留白策略
- 禁止：满屏渐变、装饰优先于内容
# 铁律
- 只改这些文件：<清单>
- 每次改完必须自测并给出截图
后端开发.txt
# 数据模型
表名 + 字段 + 类型 + 约束（一条不许省）
# 接口清单
方法 + 路径 + 入参 + 出参 + 错误码
# 权限规则
哪个角色能调哪个接口
# 数据校验
空值 / 重复 / 超长 怎么办
# 不允许的行为
删库 · 静默失败 · 返回假数据
验收标准.txt
# 每条都要能回答"是/否"
[ ] 点"开始"后 1 秒内出现第一题
[ ] 答错时页面不跳动（位置变化 ≤1px）
[ ] 刷新后上一题进度还在
[ ] 手机上连续 30 分钟帧率 ≥50
[ ] 所有按钮点击都有视觉反馈
验收标准里禁止出现这三个词："美观""流畅""好用"。这三个词没法判定，
它写成什么样都能说自己达标。要写"1 秒内""≤1px""≥50 帧"。
对照
同一件事，坏说法 vs 好说法
✕ 坏的
「帮我做个背单词的网站，好看点。」
「这里改一下，感觉不对。」
「做得现代一点、有科技感、高级一点。」
它只能猜：猜功能、猜风格、猜哪里不对。猜完你要解释三轮。
✓ 好的
「UI 直接参考 <路径> 这个文件夹，先给我功能列表，非常详细。」
「[图] 去掉顶部间隙，其它地方不动。」
「高级感来自精准排版、克制留白，不来自满屏渐变。内容优先，装饰让位。」
参考物 + 具体动作 + 边界。它会照着做，你不用解释。
自检
发出去之前，问自己七句
七条里做到五条，返工率下降一半以上。这不是感觉，是一个月几百轮迭代里唯一稳定的规律。