提示词手册：怎么把话说清楚

一条好需求的四个部分、四组好坏对照、五个可以直接抄的模板，以及 AI 答非所问时的三句追加话术——全站教程通用。

这本手册是全站教程的配套工具书：第一课教你写第一份需求说明，项目库里每个项目都要用到它。当你发现 AI 做出来的页面「不是你想要的」，八成不是 AI 的问题，而是需求没说清楚。

一条好需求的四个部分

把这句话记住：对谁、做什么、什么样、怎么算好。

部分	回答的问题	反例	正例
对谁	谁来用这个页面？	—	老师上课用，要投屏
做什么	打开页面后能完成什么？	「做个管理系统」	展示五名学生的昵称、积分和宠物
什么样	大概长什么样？参考什么？	「好看一点」	卡片排列，每行一个学生，字号大
怎么算好	做完怎么验收？	「高级一点」	投屏时后排能看清昵称和积分数字

四个部分不必凑齐才能发——有「做什么」和「怎么算好」就能开工，「什么样」可以在看到第一版之后再补。

① 词太大 → 换成具体的画面

❌ 给我做一个高级的学生管理平台，要有科技感。

✅ 做一个老师上课用的班级积分页面。内容是一个模拟班级，共五名学生，每人显示昵称、积分和宠物。页面要投屏时看得清楚。

「平台」「系统」「科技感」这些词你自己脑子里有画面，AI 脑子里没有。把画面写成文字：几个人、几行、几列、显示什么。

② 要求堆在一起 → 一次说清一件主打的事

❌ 做一个页面，要能记积分、能签到、能看报表、能导出 Excel、能发通知，还要好看。

✅ 先做一个积分展示页：五名学生、昵称、积分、宠物，纯展示。按钮先不接功能，说明哪些还没实现。

一次塞五个功能，AI 会每个都做一半。先让一件事完整跑通，再逐个加。

③ 只有形容词 → 给出可验收的标准

❌ 页面要清晰、大气、简洁。

✅ 正文字号不小于 16px，标题加粗，每行一个学生，投屏时坐最后一排能看清积分数字。

「清晰」没法验收，「字号不小于 16px」可以。把形容词翻译成数字或动作。

④ 默默期待 → 把假设说出来

❌ （什么都不说，做完发现 AI 用了英文界面）

✅ 界面全部用中文。学生名字用中文昵称。

你觉得「理所当然」的事情，AI 不知道。语言、设备、给谁看，都值得说一句。

用的时候把【】里的内容换成你的。

模板一：从零做一个新页面（项目库每个教程的第一步都是它）

帮我做一个【用途，如：活动邀请】页面，给【谁看，如：收到邀请的朋友】用。
页面包含：【内容清单，逐项列出】。
整体风格【风格参考，如：暖色调、字大、手机上也好读】。
怎么算做好：【一条可验收的标准】。

模板二：在现有页面上加一个功能

在我现在的页面【文件名】上加一个功能：【要做什么，如：每个学生后面加 +/− 按钮】。
要求：【边界，如：只改这一处，别动其他部分；点错的能撤销】。
改完告诉我：改了哪些地方，我怎么验证。

模板三：改样式（不动功能）

页面功能保持不变，只改样式：【具体哪里，改成什么，如：正文字号从 14px 调到 18px，标题用深色】。
其他地方一律不动。

模板四：排错（配合排错速查使用）

页面现在的问题是：【你看到的现象，如：点“保存”没反应】。
我做了什么：【操作步骤】。
我期望：【应该发生什么】。
实际：【实际发生了什么】。
先帮我找原因，找到后先告诉我，不要直接大改。

模板五：让 AI 解释给你听

这段代码/这个文件是做什么的？用我能听懂的话解释，不要用专业术语。
如果里面有我需要小心改动的部分，指出来。