🎮 第二站 · 游戏化教学整站案例

用提示词,把一句话长成一座游戏化学习站

以开源项目 chuanyue(穿越 PLUS · 中华地理历史探索平台)为样本,逐轮还原它是怎么从「主页 + 地理 + 历史」三个页面,被一轮轮提示词扩成 5 大模块、6 款游戏、10 章分支故事、16 项成就 的整站的。这一篇不教你怎么点按钮,讲的是背后的生成原理:为什么要分层、每一轮该扩大什么、数据和引擎怎么分开。

原话 · 这套方法的骨架

制作交互课件的方案是先使用 plan 模式生成方案提示词,
第二步按照方案提示词生成互动课件,
第三步观察生成的课件继续优化。

① 整站规格书→ ② 分模块生成→ ③ 试玩 + 扩充
1

先看成品:一座「穿越」主题的游戏化学习站

理解终点,才能看懂每一轮提示词在往哪里使劲
成品全景

这个站点叫 穿越 PLUS,是一个纯前端的地理历史沉浸式学习平台。它有五个入口:地理传送门、历史穿越器、时空信使(故事)、时空游乐场(游戏)、时空图鉴(成就)。全部数据存在浏览器本机,不依赖后端。

穿越PLUS首页
图 1 · 首页:深空主题 + 实景传送门卡片。注意顶部导航、数据统计条、三张主卡片——这是「第一屏就能讲清整个站干什么」的典范。
地理传送门
图 2 · 地理传送门:20 个地理区域,每区 5 个区位因素 + 小测。它是「数据驱动」页面的代表——换一批数据就是另一个学科的站点。
历史穿越器
图 3 · 历史穿越器:17 个历史事件,每事件 3 幕剧情 + 人物对话 + 5 题测验 + 徽章。与地理页共用同一套「剧情引擎」。
时空游乐场游戏列表
图 4 · 时空游乐场:6 款游戏以 3×2 网格排列,每卡有分类标签、规则、最佳成绩。这是「游戏机制库」——六款游戏共用一套成绩存储。
时空信使分支故事
图 5 · 时空信使:分支叙事游戏,10 章 × 3 结局 = 30 种走向,打字机演出 + 自动存档。难度最高的一块,被放在第四轮才做。
时空图鉴成就系统
图 6 · 时空图鉴:总完成度环 + 地理足迹 / 历史徽章 / 游戏档案 / 故事卷宗 / 成就殿堂。它把前四个模块的数据串了起来。
先记住这张清单:一个能称为「整站」的游戏化学习作品,至少要具备——① 一个内容模块(地理 / 历史)、② 一个游戏模块、③ 一个进度系统、④ 一个总入口。缺任何一个,都只是「一个页面」而不是「一座站」。
2

生成原理:整站 = 数据 × 引擎 × 外壳

这是全篇最重要的一节——搞懂它,你就知道每一轮提示词该写什么
核心原理

很多人做游戏化课件失败,是因为把「内容」「玩法」「界面」混在一句话里交给 AI。结果要么游戏不好玩,要么知识是硬塞进去的,改一处就全崩。这个站点能长起来,靠的是一开始就分了三层:

DATA · 数据层

知识点、题库、剧情文本

20 个区域、17 个事件、80 道问答题、20 句诗词——都是结构化数组。它决定「教什么」。

ENGINE · 引擎层

判定规则、计分、存档

排序是否正确的比较逻辑、配对步数、localStorage 读写。它决定「怎么玩」。

SHELL · 外壳层

配色、卡片、转场、PWA

深空主题、金色标题、响应式栅格、离线缓存。它决定「看起来像什么」。

原理一:数据要先定「形状」,AI 才能往里填

看这个站点里的真实代码结构——`youxi/index.html` 把六款游戏的最佳成绩统一交给两个小函数管理:

// 统一的存档协议:所有游戏共用,不各写各的 function getBest(k){ try{ return JSON.parse(localStorage.getItem(k)||'null') }catch(e){ return null } } function setBest(k,v){ try{ localStorage.setItem(k,JSON.stringify(v)) }catch(e){} } // 六个键名固定,图鉴页才能跨模块读取 best-sort / best-pairs / best-speed / best-guess / best-audio / best-poem

▲ 摘自 youxi/index.html(已简化显示)

这就是「先定数据形状」的好处:游戏模块不知道图鉴模块存在,但图鉴能读到它的成绩。每一轮加新游戏,只要往这个协议里加一个键,不用改前面任何代码。这就是站点能从 3 页长到 5 模块而不崩的原因。

原理二:新功能用「追加」而不是「重写」

README 里那张「原版 / 本版」对照表,其实就是一份迭代日志:

轮次在原版之上追加了什么有没有动原有代码
第 1 轮8 大区域 → 20 大区域;8 大事件 → 17 大事件只加数据条目
第 2 轮新增「时空游乐场」6 款游戏新增一个目录
第 3 轮新增《时空信使》分支叙事(10 章 × 3 结局)新增一个目录
第 4 轮新增「时空图鉴」成就系统(16 项成就)读取既有数据
第 5 轮PWA 离线、View Transitions 转场、数据校验器只加外壳
这给你的启示:提示词里要说清「在现有基础上增加 X,不要改动 A/B/C」。AI 最擅长增量,最不擅长推倒重来。允许它改的范围越小,站越稳。

原理三:难的东西放到后面做

分支叙事(时空信使)是全站最难的一块——10 章、30 种结局、自动存档。它被放在第四轮,而不是第一轮。原因很简单:分支叙事需要「读档」,而读档依赖前面已经建好的 localStorage 协议;如果一开始就做故事,存档格式会和后面加的游戏打架。

这条原理翻译成提示词就是:先做能被复用的地基,再做依赖地基的上层。地基是数据协议和页面骨架,上层是具体玩法。

3

五轮提示词,怎么把这个站一步步做出来

每一轮都给:提示词要点 → 生成了什么 → 为什么要这样写
实操路线
ROUND 01

先立骨架:一个主题、三个页面、一套数据格式

产出:主页 + 地理 + 历史

原版只有三页。第一轮要做的不是加功能,而是把「这个站是什么」定死:主题、视觉语言、数据长什么样、页面怎么跳转。提示词里必须出现「纯静态、无后端、数据用数组、localStorage 存档」这几个约束。

你是前端工程师。(角色) # 任务 做一个纯前端的「中华地理历史探索站」,无后端、无需构建,双击就能跑。(任务) # 约束 1. 技术约束:单目录静态 HTML;内容全部写成 JS 数组;进度用 localStorage,键名统一前缀; 2. 先输出目录结构与数据数组字段定义,我确认后再写代码。(约束) # 输出 页面: ① 主页:深空主题 + 传送门卡片 + 数据统计条; ② 地理页:N 个区域卡片,每区 5 个区位因素 + 3 题小测; ③ 历史页:N 个事件卡片,每事件 3 幕剧情 + 人物对话 + 5 题测验 + 徽章。 视觉:深蓝底 + 金色标题 + 青色高亮,桌面三列、窄屏单列。(输出) # 自检 检查:字段定义是否覆盖三个页面所需、键名是否统一前缀。(验收)

▲ 可复制;把 N 换成你的学科条目数

为什么这样写:最后那句「先输出目录结构与字段定义,我确认后再写代码」就是三步法的第一步——只要规格,不要成品。没有这一步,后面四轮都会建立在随意生成的结构上。

ROUND 02

加游戏层:先做「机制库」,再做具体游戏

产出:6 款游戏 + 统一成绩协议

第二轮不是「做六个游戏」,而是先定六种机制,再各填一批数据。看懂这六款游戏的分类,你就看懂了游戏化设计的全貌:

游戏知识动作机制内核
时空排序师把事件按年代排序顺序判定 + 4 回合
山河配对地名与图像对应32 卡翻牌 + 步数计分
极速问答快速回忆知识点80 题 + 60 秒连击
名人竞猜由线索推人物16 人 × 每局 6 题
闻声识城听音频线索猜城市TTS 音频 + 12 城
诗话山河名句填空 + 判断所咏地20 句 × 每局 14 句
你是前端工程师。(角色) # 任务 在现有站点上追加一个 youxi/ 游戏目录,不要改动主页/地理/历史的已有代码。(任务) # 约束 1. 先定协议:所有游戏成绩用 best-<游戏名> 作 localStorage 键,统一 getBest(key)/setBest(key,value) 两个函数,成绩显示成「最佳 X」; 2. 交付顺序:先做第 1 款跑通协议,确认后再批量做其余 5 款。(约束) # 输出 列出 6 种机制:① 排序 ② 配对 ③ 限时问答 ④ 竞猜 ⑤ 听音辨识 ⑥ 填空。每款游戏写清:知识点来自哪类数据、玩家做什么动作、AI 怎么判对错、失反馈给什么提示。(输出) # 自检 检查:6 款游戏是否都走同一套存档协议、是否都没动已有模块。(验收)

▲ 关键在「先做第一款跑通协议」

为什么这样写:六款游戏看着多,其实只用了同一套存档 + 六种判定。先跑通一款,等于验证了「数据→动作→判定→存档」这条链路,后面五款只是换数据。这就是「慢就是快」——一轮只解决一个新机制。

ROUND 03

加故事层:最难的放这里,因为它要「读档」

产出:10 章 × 3 结局分支叙事

第三轮做《时空信使》。它和其他游戏不一样:玩家的选择会累积成「历史契合度」,结局由整个过程决定,还能关掉页面下次接着玩。这依赖前面已经建好的存档协议——这就是为什么它不能放在第一轮。

你是前端工程师。(角色) # 任务 在现有站点上追加 gushi/ 目录,做一个分支叙事历史游戏,不改已有模块。(任务) # 约束 1. 存档:复用现有 localStorage 协议,加一个 cyplus:story:* 前缀,存「已解锁章节 / 当前结局 / 已收集思绪卡」,刷新和关闭都能续上; 2. 演出:打字机逐字显示对话;切换章节用淡入;提供「继续上次」入口。(约束) # 输出 结构:10 章旅程,每章 3 个选择,每个选择影响「历史契合度」分数;每章 3 种结局,全站共 30 种走向;配 20 张「思绪卡」收集品。(输出) # 自检 我随便选一条分支走到底,结局要和我每次的选择对得上。(验收)

▲ 注意「复用现有 localStorage 协议」这句

为什么这样写:「复用」两个字省掉了最大的隐患。如果这里让 AI 另写一套存档,前面六款游戏的成绩和故事进度就会互相覆盖——这类 bug 在整站项目里最难查。约束它复用,是把风险锁死在地基里。

ROUND 04

回收数据:做一个把前面所有模块串起来的图鉴

产出:完成度环 + 16 项成就

到第三轮为止,四个模块各存各的数据,玩家看不到全貌。第四轮做「时空图鉴」——它不产生新内容,只读取前面所有模块的存档并汇总。这是整站从「几个页面」变成「一个产品」的关键一步。

你是前端工程师。(角色) # 任务 在现有站点上追加 tujian/ 目录,做「时空图鉴」,只读不写,不改任何现有模块。(任务) # 约束 1. 只读不写,不改任何现有模块; 2. 成就由全站行为实时推导,不设「领取」按钮;数据变了图鉴自动变。(约束) # 输出 1. 读取这些已有的键: history_traveler_badges_v1 → 历史徽章 best-* → 六款游戏最佳成绩 cyplus:story:* → 故事章节与思绪卡; 2. 展示:总完成度百分比环 + 四个分栏(足迹 / 徽章 / 档案 / 卷宗)+ 成就殿堂。(输出) # 自检 我在任一模块完成一个动作,回到图鉴对应数字必须已经变化。(验收)

▲ 「只读不写」是这一轮的灵魂

为什么这样写:图鉴是最容易写出 bug 的地方——因为它要碰所有模块。明确告诉 AI 只读不写,等于给它画了红线:你只能看,不能改。这一轮之后,站点就有了「整体感」,学生会为了填满图鉴回头去玩前面的模块。

ROUND 05

上外壳:PWA、转场、校验器——让它像产品而不是作业

产出:可安装 + 离线 + 1100 项自检

最后一轮不动内容,只提升工程质量:让它能被安装到桌面、断网也能打开、页面切换有转场、数据有自动校验。这些都不改变教学内容,但决定了作品能不能真正拿去用。

你是前端工程师。(角色) # 任务 保持现有五个模块的内容和数据完全不变,只做工程化增强。(任务) # 约束 1. 内容与数据完全不变,只提升工程质量; 2. 转场用 View Transitions API 做跨页淡入,不支持的浏览器自动回退; 3. 可达性:键盘焦点可见;尊重 prefers-reduced-motion,用户关动画就不播。(约束) # 输出 1. PWA:生成 manifest.json(名称/图标/主题色)+ sw.js,缓存核心 HTML、图片、音频,断网可打开,可安装到桌面; 2. 校验器:写一个 tools/validate.js,检查所有数据数组:条目数、ID 唯一、图片路径存在、题目答案在选项里——输出通过/失败清单。(输出) # 自检 断网打开一遍;跑一遍 validate.js,失败项必须为 0。(验收)

▲ 最后一轮让作品「能交付」

为什么这样写:校验器看着和教学无关,其实是最值钱的一件工具。当站点有 240 个文件、上千条数据时,人眼查不过来;一个能自动报错的脚本,等于给 AI 的每次扩充装了安全网。

📌 五轮的共同结构:每一轮都是「在现有基础上追加 X,不改动 A/B/C」+「先做一个跑通,再批量」+「写验收条件」。这三句话就是整站级提示词的通用骨架,和你做的是地理还是语文无关。
4

迁移到你的学科:把「穿越」换成你的教学内容

原理通用,只需要换掉数据层和外壳的命名
迁移方法
原站模块机制换成语文 / 数学 / 英语时
地理传送门条目卡片 + 属性 + 小测作家作品卡 / 公式定理卡 / 语法点卡
历史穿越器3 幕剧情 + 对话 + 测验课文情境再现 / 解题过程分幕
时空排序师按时间排序按情节先后 / 按解题步骤排序
山河配对图与名对应字形与字义 / 图形与公式配对
闻声识城听音频线索猜答案听单词辨拼写 / 听古诗猜作者
时空图鉴跨模块成就汇总学习档案 + 知识点掌握度总览
三条边界,别让 AI 越过去:① 数据要你来定——知识点和答案必须来自教材与你的教学判断,不能让 AI 自己编历史事实或学科结论;② 图片与音频有版权——示例站用的是 Pexels 免费摄影和 TTS 合成,你也要用可商用素材并署名;③ 成绩只存本机——不上传学生姓名、班级、成绩,localStorage 属于浏览器本地,别改成联网提交。

和本站「三步法」的关系

这一篇讲的是整站级的三步法:第 1 轮就是「写规格书」,第 2–4 轮是「按规格书分模块生成」,第 5 轮是「观察优化」。和单课件三步法完全同构,只是把「一屏」换成了「一个模块」,把「六看清单」换成了「数据校验器 + 试玩验收」。

如果你还没读过单关卡的做法,先看《三个课堂小游戏》;如果要看方法总纲,看《交互课件三步法》。

5

可复制的整站规格书提示词

把这一篇的原理压缩成一条能直接用的提示词
带走就用
你是教学游戏产品设计师。(角色) # 任务 我要为【学科 + 学段】做一个纯前端的游戏化学习站,学生打开就能用,老师课堂可演示。请先只输出规格书,不要写代码。(任务) # 约束 一、分层约束(不可混写) - 数据层:所有知识点、题目、剧情写成 JS 数组,字段先定义好给我确认; - 引擎层:判定与计分逻辑集中写,成绩统一用 getBest/setBest 读写 localStorage; - 外壳层:配色、栅格、转场、PWA 独立写,不许把样式混进数据数组。 二、硬红线 - 学科事实、答案、数据由我提供或确认,你不得自行编造; - 学生姓名/班级/成绩不上传,只存浏览器本机; - 图片音频用可商用素材并署名; - 每轮结束给我一份「本轮改了哪些文件」清单,方便我回滚。(约束) # 输出 三、模块清单(分批做,不是一次做完) 1. 内容模块:N 个条目卡,每条含 5 个属性 + 3 题小测; 2. 游戏模块:先做 1 款跑通「数据→动作→判定→存档」,确认后再做其余 5 款; 3. 故事模块:分支叙事,复用第 2 步的存档协议,加自己的前缀; 4. 成就模块:只读汇总前三个模块的数据,不产生新内容,不设领取按钮。 四、每轮的固定写法 每轮提示词都要写清:① 在现有基础上追加什么;② 不改动哪些已有模块;③ 先做一个跑通再批量;④ 验收条件是什么(可观察、可核对)。(输出) # 自检 我确认这份规格书后,再从第 1 轮开始逐轮生成。(验收)

▲ 复制后把【】里的内容换成你的学科即可

讲课建议:这条提示词最好投屏逐段讲——先讲「分层约束」,再讲「分批做」,最后才讲红线。老师最容易被「6 款游戏」吸引,但真正值钱的是「先做 1 款跑通协议」这句话。
章节目录 点击跳转 · 再按 ☰ 收起