STEP 1写规格书只出方案、不写代码 · 约 15 分钟
1
第一步:让方案模式先产出一份「课件规格书」
这一段不写一行代码,只把"要做成什么"定死
STEP 1 · 想清楚
先说反面。大多数老师是这样起手的——一句话把活儿交出去:
请帮我做一个网页,演示冷锋过境的天气变化过程。画面里有一个小镇,冷锋从左边慢慢移过来,过境前晴朗、过境时刮风下雨、过境后转晴降温。用简单的动画表示。
❌ 这样一句,通常错在这四处
- 锋面方向可能画反(冷锋是冷气团主动推进)
- 雨区位置可能落到锋前(冷锋雨区在锋后)
- 没有气温、气压变化,看不出"过境前后"
- 不能调参数、不能出题,进不了课堂
✅ 根子不在提示词长短,在"没写规格"
- 它不知道这一屏给谁看、看多久
- 它不知道哪些参数必须可调
- 它不知道哪条是科学红线
- 你手上也没有对照物,只能整篇重来
所以第一步不是"换个更长的一句话",而是换模式:进 plan 模式,只要方案、不给代码。让 AI 先把这份课件写成一份能照着施工的规格书。
你是教学课件产品经理,不是程序员。(角色)
# 任务
为高一地理《锋与天气》做一份课堂大屏用的互动课件规格书:一课时 40 分钟,核心是冷锋过境前后的天气变化,学生初次接触锋面概念。(任务)
# 约束
1. 先只输出方案,不要写任何代码;我确认规格书之后,你再开始写;
2. 这一轮只给规格书,不要直接给课件内容。(约束)
# 输出
规格书分四部分:
1. 屏幕结构:一共几屏/几个区域,每块放什么,学生一进来先看到什么;
2. 交互规则:哪些能点、哪些能拖、点了发生什么;教师的播放/暂停/重置/倍速放在哪;
3. 数据参数:需要哪些可调参数(名称、范围、步长),哪些只能标「示意值」;
4. 验收标准:做完后我按哪几条判断「能不能进课堂」,写成可勾选的清单。(输出)
# 自检
最后另起一段:列出你认为最容易做错的 3 个地方(例如雨区在锋前还是锋后),并说明规格书里的哪一句能防住它。(验收)
这份案例最终定下来的规格书(节选)
| 四件套 | 这份课件写成了什么 |
| 屏幕结构 | ① 主舞台:剖面视角里的冷气团 / 暖气团 / 锋面 / 雨区 / 云系 ② 教师控制条:播放、暂停、重置、倍速、时间轴 ③ 参数面板:冷气团温度、相对湿度、锋面移速 ④ 观测数据卡:气温、气压、风向风速 ⑤ 游戏层:剧情、七关地图、授勋证书 |
| 交互规则 | 时间轴第 1~10 天可拖动;过境前 / 时 / 后可单步播放;拖参数时雨区、降水类型、过境天数实时响应;答错只给定位提示、不给答案;进度存本机 |
| 数据参数 | 冷气团温度 5~25℃、相对湿度 30%~95%、移速 0.5×~3×;所有曲线与数值标注「示意,非实测」,并给出「模型简化说明」折叠区 |
| 验收标准 | 冷气团主动推进、雨区在锋后、三阶段天气特征正确;单文件零外链、断网可跑;正文 ≥18px、按钮 ≥44px;快速连点不乱、重置彻底 |
规格书是给 AI 的施工图,不是给你自己看的笔记。写完先自检一句:换一位老师拿着它,能不能做出同一份课件?能,才进第二步。
2
规格书的压缩写法:五件套直接写进提示词
不想单列一张表时,用它一步到位
STEP 1 · 想清楚
如果你已经把规格书想清楚了,也可以不再分两步——把角色、任务、约束、输出、验收五件套直接写进一条提示词,相当于把规格书压缩成五段。这份案例的第二版就是这么写的:给 AI 地理教师的身份,把易错点写成红线。
你是一位高中地理特级教师,熟悉《普通高中地理课程标准》。(角色)
# 任务
为「冷锋过境」制作一个单文件 HTML 互动演示页,投影到教室大屏使用。(任务)
# 科学性约束(红线)
1. 冷锋=冷气团主动推进,雨区在锋后,锋面坡度陡;
2. 过境前:暖气团控制,晴暖;过境时:阴雨大风;过境后:气温下降、气压升高、天气转晴;
3. 不确定的表述标注「示意」,不编造数据。(约束)
# 输出规范
① 单文件 HTML,CSS/JS 全内联,断网可运行;② 正文字号≥18px,按钮≥44px;③ 顶部有「播放/暂停/重置」教师控制按钮;④ 动画分「过境前/过境时/过境后」三阶段,可分步播放。(输出)
# 自检
输出前逐条核对:锋面方向?雨区位置?三阶段天气特征?(验收)
❌ 只有一句话时
- 锋面方向可能反
- 雨区位置随机
- 不能控制播放
- 没写数据来源
✅ 五件套写全后
- 科学性有红线兜底
- 三阶段分步播放
- 教师控制按钮齐全
- 断网教室可用
省力技巧:这一步不用从零写——提示词库「互动课件生成」门类的 h5-01 互动课件生成总纲 就是这条提示词的完全体,直接复制填空即可。
STEP 2按规格书生成一次只加一屏 · 每屏先跑通再加下一屏
3
第一轮:只搭骨架 + 第 1 屏
这一轮的目标是"能跑",不是"做完"
STEP 2 · 搭起来
有了规格书,最容易犯的错反而变成"一次要五屏"。别。第一轮只要外壳和第 1 屏,其余屏留空占位——先把"这套规格能不能落地"验证掉,后面每加一屏都是在跑通的基础上加。
沿用上一轮的角色设定。(角色)
# 任务
按刚才确认的规格书开工:这一轮只做外壳和第 1 屏。(任务)
# 约束
1. 其余屏先留空占位(写上「待做:参数屏 / 游戏层」);
2. 这一轮不做参数面板、不做观测数据卡、不做游戏层;
3. 单文件 HTML,CSS/JS 全内联,断网可运行。(约束)
# 输出
1. 顶部控制条:播放/暂停、重置、倍速(0.5×/1×/2×/4×)、时间轴(第 1~10 天可拖);
2. 主舞台:剖面视角,画出冷气团、暖气团、锋面线、雨区、云系;
3. 第 1 屏:冷锋过境的三阶段动画,能随时间轴推进。(输出)
# 自检
交付时告诉我:哪几处是按规格书第几条做的,哪一处你做了简化。(验收)
❌ 一次要五屏
- 出错了不知道是哪一屏的问题
- 改一处坏三处
- 跑了五分钟才看到结果
✅ 只搭骨架 + 第 1 屏
- 打开就能判断"规格可不可行"
- 每加一屏都有可回退的版本
- 问题能定位到具体某一屏
跑通的判据只有三条:打开能看到主舞台、点播放锋面会动、点重置能回到第 1 天。三条都成,才进下一屏。
4
第 2 屏:演示屏——让锋面沿时间轴动起来
对应库内 h5-02 · 先出"要素-运动表"再写代码
STEP 2 · 逐屏长肉
案例页面的核心亮点是锋面随时间轴演化的连续动画(10 天时间轴、0.5×~4× 倍速)。这对应库里 h5-02「过程演示动画课件生成器」的思路:先让 AI 写"要素运动表",再写代码。
沿用上一轮的角色设定。(角色)
# 任务
继续升级上面的冷锋课件,改为分步动画。(任务)
# 约束
1. 先输出「要素-运动表」,我确认后再写代码;
2. 时间轴为第 1 天~第 10 天,倍速按钮为 0.5×/1×/2×/4×,支持暂停。(约束)
# 输出
1. 要素-运动表:冷气团/暖气团/锋面/雨区/云系,各自在过境前/中/后的位置与运动方向;
2. 每个阶段配一句旁白字幕(学生可读)+一段教师讲稿(折叠区,含引导提问);
3. 结尾加「预测-验证」环节:先让学生预测丙城过境后气温变化,再切换验证。(输出)
# 自检
交付时说明:动画的阶段划分是否与要素-运动表一一对应。(验收)
Q为什么先要"要素-运动表"再要代码?表格先行,你可以在写代码前就发现"箭头方向反了"这种错误——改表格 1 分钟,改代码 10 分钟。
Q案例里的"画中画"是怎么来的?就是继续追问:"请加一个可切换的剖面视角小窗,同时展示锋面侧视结构"——一个功能一次追问,不要一次提五个。
5
第 3 屏:探究屏——把参数交给学生
对应库内 h5-05 · 从"看动画"升级为"控变量"
STEP 2 · 逐屏长肉
案例页面最"贵"的功能是气团参数调节(冷/暖气团温度、湿度、移速滑块)——学生拖滑块,天气系统实时响应。这在教学上的价值是从"看演示"升级为"控变量做探究"。
沿用上一轮的角色设定。(角色)
# 任务
继续升级,为课件增加「变量探究」模式。(任务)
# 约束
1. 三个滑块范围固定:冷气团温度 5~25℃、相对湿度 30%~95%、锋面移速 0.5×~3×;
2. 参数区上方放「模型简化说明」折叠区,写清哪些是真实关系、哪些是教学简化;
3. 参数推到极端时给出边界说明,不出现无意义结果。(约束)
# 输出
1. 三个滑块:冷气团温度(5~25℃)、相对湿度(30%~95%)、锋面移速(0.5×~3×);
2. 参数变化实时影响:雨区强度、降水类型(雨/雪)、过境天数;
3. 配探究任务单 3 级:①单变量:只调温度,观察降水类型变化;②双变量:温度+湿度组合;③开放:找出「变成暴雪」的参数组合。(输出)
# 自检
检查:每个滑块推到边界时是否有提示,画面是否稳定。(验收)
诚实红线:案例页面顶部写着"气团性质调节"并给了恢复默认按钮——AI 简化的模型必须明示简化了什么,不能冒充真实气象模拟。这句"模型简化说明"就是科学课件的体面。
6
第 4 屏:游戏壳——把课件包进闯关里
对应库内 game-03 · 糖衣是游戏,药芯是知识
STEP 2 · 逐屏长肉
案例页面外层套了一整层游戏:见习预报员剧情 → 七关任务地图 → 探究+答题计星级 → 全通关授勋证书。这一步用 game-03「单元知识 RPG 闯关生成师」的思路,把已经做好的课件包进游戏壳。
沿用上一轮的角色设定。(角色)
# 任务
把上面的冷锋课件包装成闯关游戏。(任务)
# 约束
1. 计分:每关任务分+答题分,≥80% 得 3 星,达标解锁下一关;
2. 答错给定位提示,不直接给答案;
3. 进度自动保存在本机浏览器,刷新不丢。(约束)
# 输出
1. 剧情:我是见习气象预报员,要跟随凌站长通过试炼成为正式预报员,给我一个搭档(如气象精灵「云朵朵」)在每关给提示;
2. 关卡:把课件内容拆成 3 关——第1关「认识锋面」(看动画答 2 题)、第2关「调参数」(完成探究任务单第①级)、第3关「预报员上岗」(综合预测题);
3. 结算:全部通关显示「授勋证书」,可输入姓名保存。(输出)
# 自检
检查:三关是否都调用了课件里的知识、刷新后进度是否恢复。(验收)
教育红线:游戏壳是糖衣,知识是药芯。注意案例的设计细节——答错给定位提示而非直接答案、星级与探究行为挂钩、进度保存但不设排行榜。这些细节在 game-03 的质量红线里都有,照做即可。
STEP 3观察优化照清单看 → 对到哪一句 → 只改那一句
7
第三步:照六看清单观察,把"感觉不对"变成"改哪一句"
对应库内 h5-11 / h5-12 · 这一步最值钱
STEP 3 · 看清楚
功能齐了不等于能用。课件能不能进课堂,靠的是这一段:不是"再看看哪里别扭",而是拿清单逐项过,把每个症状对回规格书里缺的那句话。先把六看走一遍:
| 六看 | 具体查什么 | 谁来把关 |
| ① 能打开吗 | 双击不白屏,控制台没有红色报错 | 你(30 秒) |
| ② 点得动吗 | 播放、暂停、重置、倍速、滑块,逐个亲手试,没有死点 | 你(2 分钟) |
| ③ 数对得上吗 | 参数拖到两端:雨区、降水类型、过境天数是否符合规格书写的范围 | 你(3 分钟) |
| ④ 知识对吗 | 锋面方向、雨区位置、三阶段天气特征、气压变化有没有错 | 只能你自己,逐条对教材课标 |
| ⑤ 挤不挤 | 按教室投屏尺寸看:字号、按钮、有没有横向滚动条 | 你(投屏试一次) |
| ⑥ 学生能自己走完吗 | 不给口头提示,让学生独立点一遍,看他卡在哪 | 学生(一次试上) |
六看里发现的问题,绝大多数不用重做,只要回第一步补一句话。可以直接让 AI 当验收官,把问题连证据一起列出来:
你是课件质量总监。(角色)
# 任务
验收这份冷锋闯关课件(粘贴代码),逐项检查并给证据。(任务)
# 约束
1. 每一项都要给证据,不许只下结论;
2. 按科学性、教学性、技术性三块逐项检查。(约束)
# 输出
1. 【科学性】锋面方向/雨区位置/三阶段天气特征/参数联动是否符合地理原理?有无编造数据?
2. 【教学性】游戏是否真的调用知识?答错反馈是否指向原因?教师控制区是否完整?
3. 【技术性】是否单文件零外链?断网可运行?触屏可点?字号达标?快速连点会不会乱?重置是否完整?
4. 验收结论表(项|通过|证据|严重度)+必改项清单+每条可直接粘贴的修改指令。(输出)
# 自检
最后确认:必改项是否每条都配了一句可直接粘贴的修改指令。(验收)
修改时守住一条纪律
验收会发现问题,修的时候用 h5-12 的规矩:计划先行、最小改动——让 AI 先复述"你理解的修改点+会触及哪些部分",你确认后它才准动代码,并且每次只改相关的部分。这是防止"越修越坏"的关键。
问题 → 改哪一句(这份案例实际踩过的)
| 看到的症状 | 多半是规格书缺了 | 回第一步补这一句 |
| 锋面箭头反了 | 没写死冷暖气团的主动/被动关系 | "冷锋=冷气团主动推进、暖气团被迫抬升;箭头一律由冷气团指向暖气团。" |
| 雨落在锋前 | 没写雨区与锋线的相对位置 | "冷锋雨区在锋后,暖锋雨区在锋前,两者不得混用。" |
| 温度拖到最低画面就乱 | 参数没写范围与越界处理 | "冷气团温度 5~25℃;越界停在上限并提示,画面不得变形。" |
| 过境前后看不出差别 | 没定每阶段必须出现的观测要素 | "过境前/时/后每段必须同时给出气温、气压、风向,并与前一段做对比。" |
| 投屏下字太小 | 没定字号下限与画布尺寸 | "正文 ≥18px、标题 ≥28px,1024×768 下不出现横向滚动条。" |
| 答错直接给答案 | 没写反馈规则 | "答错只给定位提示,连续两次错才给解析。" |
完整复盘:回看案例页面,所有功能都能对回这三段——规格书里定下的五块屏幕(第一步)、逐屏做出来的动画 / 参数 / 游戏(第二步)、清单里挑出来的字号与反馈问题(第三步)。没有一步是魔法。
| 案例中的功能 | 来自哪一段 | 对应库内提示词 | 迁移到你的学科 |
| 锋面演示动画 | 第二步 · 演示屏 | h5-02 过程演示动画 | 化学化学方程式配平过程 生物细胞分裂 |
| 气团参数滑块 | 第二步 · 探究屏 | h5-05 变量探究模拟器 | 物理斜坡角度与摩擦 数学函数参数变换 |
| 气象观测数据卡 | 第一步定、第二步做 | h5-03 交互地图判读 | 地理等高线判读 物理电路读数 |
| 闯关剧情+授勋 | 第二步 · 游戏壳 | game-03 RPG 闯关生成师 | 通用任何单元的复习课 |
| 大屏稳定运行 | 第三步 · 六看清单 | h5-11 验收检查官 | 通用所有课件进课堂前 |
🎓 学完本篇,建议去 提示词库 把 h5-01 / h5-02 / h5-05 / game-03 / h5-11 这五条收藏起来——它们就是这套"三段法"的武器库。也可以先看 三步法教程 把流程本身弄熟。