麦式参考 MickerBook Reference

怎么跟 AI 说:把想法说成能执行的需求

同一件事,说法不同,结果差十倍。这一页给一个五段式模板,和几组「改造前 / 改造后」的真实对照。

你不需要学会写代码,但你需要学会把「我想要那种感觉」翻译成「改哪里、到什么程度、不许动什么、做完给我看什么」。

为什么「帮我优化一下」几乎必然翻车

「帮我优化一下这个页面」在你脑子里是清楚的:你嫌它挤、字小、按钮不明显。

但这句话交出去,AI 只能自己补齐所有缺口:优化什么?谁的标准?能不能改结构?能不能换配色?要不要动数据?于是它做了一大堆你没要的改动,还顺手改掉了你满意的地方。

不是它不聪明,是你把决策权连同任务一起交出去了。它必须替你决定,只能猜。

五段式:范围、目标、边界、参照、交付

  1. 范围:动哪个页面、哪个文件、哪一块区域。越具体越好。
  2. 目标:改完要达到什么可观察的效果。不是「更好看」,而是「首屏不用滚动就能看到价格」。
  3. 边界(最重要):明确写「不要改什么」。这一句能挡掉八成的意外破坏。
  4. 参照:像什么、用哪个已有组件、沿用哪套配色。有参照就不会即兴创作。
  5. 交付:做完要给我什么——改了哪些文件、怎么自己看到效果、哪里没验证。
【范围】只改首页顶部区域(src/app/page.tsx 的 Hero 部分)
【目标】让人不用往下滚就知道这是什么产品、以及点哪里开始
【边界】不要改配色和字体;不要动下面的列表区;不要新增依赖
【参照】沿用现有的按钮组件和现有的间距节奏
【交付】告诉我改了哪些文件、我打开哪个地址能看到、哪部分你没验证过

改造对照

改造前(会翻车)改造后(能执行)
帮我把这个表单弄好看点只改注册表单的间距和字号:字段之间 16px、输入框高度 44px,标签在上方。不要改字段数量和校验规则。
加一个用户系统先只做「邮箱 + 密码注册和登录」两个页面,成功后跳回首页。暂时不做找回密码、不做第三方登录、不发邮件。数据先存本地库。
这里报错了,你修一下点「保存」时页面白屏,控制台报 xxx。请先告诉我错误发生在哪一步,再改;改完让我用同样的操作复现一次确认。
帮我部署上线先只做构建:在本机执行构建命令,把原始输出给我。确认通过后我再决定要不要部署,部署前告诉我怎么回滚。

三个让 AI 立刻变靠谱的小句子

  • 「不确定就先问我,不要猜。」 放在需求最后,能显著减少它自作主张。
  • 「先说方案,等我说开始再动手。」 大改动必加。省下的是你回滚的时间。
  • 「做不到的部分直接说做不到。」 给它一条诚实的退路,它就不用编。

什么时候该拆小

一次只让它改一个承重的东西。判断标准很简单:如果结果不对,你能一眼看出是哪一处引起的吗?

能,就继续。不能,说明这一步太大了,拆开。

改布局和改数据逻辑分两次;改样式和加新功能分两次;重构和修 bug 永远分两次。这不是效率损失,是让每一步都可验收——这才是你能持续往前的原因。

好的需求不是写得长,是把「不许动的地方」和「做完要给我看什么」写清楚了。