人人都能上手的
Vibe Coding

选择清单或游戏案例,从一个想法出发,跟着提示词分步制作、测试,并用 Docker 在本地运行。

3 门课程
45 分钟 / 节
02 个可选项目
COURSE OVERVIEW

从想法,到本地运行

先完成课前准备,学习课程 1 的基础知识和工具;再按顺序完成课程 2 的目标清单与课程 3 的横版游戏。每个案例都有独立、完整的实践步骤。

说清需求生成作品亲手测试反馈修改Docker 运行

课程结束后,学员能够

  • 解释 Vibe Coding 中人和 AI 的分工。
  • 用具体语言描述需求及验收方式。
  • 生成并测试网页,用 Docker 在本地运行。
  • 记录问题,向 AI 求助并复测。
  • 备份作品,识别数据和分享的基本限制。

教学设计

课程 1 认识基础知识和工具;课程 2、3 分别完成目标清单和横版游戏。Docker Desktop 安装及镜像下载安排在课前。教师无需要求学员记忆代码语法,重点培养清晰表达和检查结果的习惯。

你负责提出需求、做决定和验收;AI 协助把需求变成代码。生成结果仍需亲手测试。
BEFORE CLASS

课前准备

学员准备

  • 一台联网电脑与浏览器;横版游戏需要键盘。
  • 一个可用的 AI 对话或 AI 编程工具。
  • 纯文本编辑器:Windows 记事本或 macOS 文本编辑(纯文本模式)。
  • 安装 Git,重开终端运行 git --version;本地管理不需要 GitHub 账号。
  • 会复制、粘贴、保存和查找文件。VS Code 是可选编辑器,系统纯文本编辑器也可以。
  • 课前安装并启动 Docker Desktop,确保 Linux 容器引擎正常运行;用 docker version 检查 Client 和 Server,docker compose version 检查 Compose;首次构建需要联网获取基础镜像。

教师准备

  • 提前跑通全流程,核对工具的账号、额度和收费。
  • 准备成功示例及可运行的备用 HTML 文件。
  • 开启 Windows 文件扩展名显示,准备脱敏报错截图。
  • 演示时放大字号,准备虚构的示例数据。
  • 课前检查 Docker Desktop 系统要求、授权条款、虚拟化及 WSL 2(Windows),预先下载 swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/library/nginx:1.27-alpine 镜像并演练;安装、重启与网络故障不计入 45 分钟;核对 Docker Desktop 与 AI 工具的适用授权和费用。
详细工具清单见同目录的 《课前工具与软件准备》文件。不需要额外安装 Node.js、Python、数据库或游戏引擎。课堂不要求输入真实密码、验证码、身份证号或客户资料。登录、支付、数据库和公开发布不列为必做内容。

开场话术:“这门课不要求大家先学会写代码。我们练习把需求讲清楚,让 AI 帮忙做出来,再用自己的判断检查和改进。”

COURSE 01 · 基础知识与工具

认识 Vibe Coding,准备出发

先理解人与 AI 如何合作,再认识完成案例需要的工具。

学习目标

  • 用自己的话解释 Vibe Coding,并知道 AI 输出需要人工验证。
  • 能打开 AI 工具、编辑器、浏览器和终端,检查 Git 与 Docker。
  • 能用“目标、功能、验收条件”描述一个简单想法。

什么是 Vibe Coding?

你用自然语言说明想做什么,AI 协助生成和修改代码;你亲手运行、检查和反馈,逐步把想法变成可用作品。

描述需求生成作品动手测试反馈修改再次验证
你负责方向和验收;AI 提供实现建议。第一次生成的结果可能有错误,需要逐项测试。

认识工具

工具在课程中的作用课前检查
AI 对话工具理解想法、生成和修改代码能登录并发送中文问题
编辑器保存网页和部署文件能保存 UTF-8 文件并查看扩展名
浏览器打开作品并进行功能测试能打开本地网页
Git记录项目文件的版本终端运行 git --version
Docker Desktop / Compose构建并在本地运行应用启动 Desktop;docker version 显示 Client 和 Server;docker compose version 显示版本

第一次练习:把想法说清楚

在 AI 对话框中粘贴下面的提示词,并根据自己的想法替换方括号。

基础练习 · 复制后填写
我是完全没有编程经验的新手。我想制作【我想做的小工具或游戏】,给【使用者】在【使用场景】使用。请先帮我整理目标、三个最重要的功能,以及每个功能如何测试。请使用简单中文,不要立即生成代码。

完成标志:你能指出使用者、用途和一条可以亲手验证的结果。接下来选择课程 2 或课程 3,按照步骤实践;也可以两门都完成。

课前安装、虚拟化设置、下载镜像和重启可能超过一节课,请提前完成。每个案例建议先安排约 45 分钟的课堂引导,剩余步骤和排错留给课后练习,按个人速度完成。

Vibe Coding 能帮你做什么?

下面四类作品都可以从一个小想法开始。先看视频了解成果,再思考“谁会用、解决什么问题、怎样判断做成了”。视频来自哔哩哔哩中文内容;能否播放取决于平台、网络和账号限制。课程并不要求购买视频中介绍的工具或服务。

观看提示:这些视频用到的产品、界面、功能和费用可能变化。观看重点是想法、操作和测试过程;高级功能不能视为生成后就可安全上线。

① 做网站:展示信息和服务

可以做:个人介绍页、活动介绍页、作品集,或带简单表单的页面。你描述读者、页面内容和风格,AI 帮你搭建网页;你再检查文字、链接和手机显示。

视频样例:《Vibe Coding纯小白教程》展示如何向 AI 说明需求、启动软件并修复问题。先观察作者如何表达需求,再看如何检查生成结果。

在哔哩哔哩打开视频 ↗

新手建议:先做一页个人介绍,包含标题、简介和联系方式占位文字;暂不收集真实用户信息。

② 做生活工具:记录、提醒和整理

可以做:每日目标清单、习惯打卡、购物清单、计时器或简单记账原型。先确定输入什么、如何显示、刷新后是否保留,再用虚构数据测试。

视频样例:《手把手教你用 Codex 学会 AI 编程》展示制作包含待办事项、番茄钟和笔记的效率工具;可留意视频中从约 19 分 50 秒开始的实操。视频使用的工具与本课程可以不同。

在哔哩哔哩打开视频 ↗

新手建议:先实现添加、完成、删除三项,确认可用后再增加分类和筛选。

③ 做互动游戏:把规则变成可玩作品

可以做:答题、猜数字、消除或简单横版跳跃游戏。你先写清操作、获胜、失败和重新开始规则,再逐一试错和调整难度。

视频样例:《纯 Vibe Coding:用自然语言从零做出网页游戏》记录从需求拆解到游戏运行与 Docker 部署;案例涉及后端等进阶内容,初学者先观察游戏规则和迭代过程即可。

在哔哩哔哩打开视频 ↗

新手建议:先做一个短关卡,让角色能移动并重新开始;之后再加入金币、生命和计分。

④ 做数据看板:把数字变成图表

可以做:家庭开支概览、学习进度图表或小团队的虚拟数据展示。先准备少量示例数据,再让 AI 制作表格、统计与图表,并人工核对每个数字。

视频样例:《AI 大屏:Claude Code + 积木报表》展示使用 AI 辅助制作图表和交互数据大屏;它使用额外产品,观看时重点观察图表展示,数据真实性需要另外核验。

在哔哩哔哩打开视频 ↗

新手建议:先用 5 行虚构数据做一张表和一张柱状图,手算总数与图表结果是否一致。

哪些事情需要更多经验?

AI 也可以协助制作带账号、数据库、支付、自动处理数据或移动端应用的原型,但正式交给他人使用时,还需要验证安全、权限、可靠性、数据备份和持续维护。请先从不含真实敏感数据的小项目开始。

01 · AI 如何参与制作

AI 会根据你提供的信息预测合适的回答,也能生成代码。它不知道你脑中的全部细节,还可能生成无法运行或不符合要求的结果。先告诉它“给谁用、解决什么问题、必须有什么、如何验收”,再逐项检查;出现错误时把操作、预期和实际结果一起告诉它。

建议:一次提出一个小改动;把正常版本先保存在 Git 中,再修改。不要把密码、验证码或真实客户资料放进提示词。

02 · 网页由什么组成

HTML 负责页面结构,CSS 负责颜色、布局和文字样式,JavaScript 让按钮、筛选和游戏操作产生反应。课程中的案例把三者放在一个 index.html 文件里。浏览器负责读取并运行这个文件。

文件夹是存放项目文件的地方;扩展名帮助系统识别文件类型。index.html 是网页,Dockerfile 没有扩展名,compose.yaml 是服务配置。保存后要确认位置和完整文件名。

03 · 如何用终端与电脑沟通

终端是输入指令的窗口,并不需要记住所有命令。命令通常只在当前文件夹生效:Windows 的 PowerShell 用 pwd 查看位置,用 dir 查看文件。复制命令前先看清当前文件夹和命令作用;错误信息可以去掉敏感信息后交给 AI 解释。

04 · Git:为项目保留版本

Git 像一份项目修改记录:git init 建立本地仓库,git status 查看变化,git add 选择要记录的文件,git commit 保存一个版本。Git 不等于 GitHub:本地记录不需要远程账号,也不会自动上传。

建议:每完成一个可运行的小阶段就检查并提交;只添加项目文件。首次提交可能需要设置 Git 用户名和邮箱,可以请 AI 指导仅在当前仓库配置。

05 · Docker 和 Compose

Dockerfile 是制作镜像的说明书;镜像是包含应用和运行环境的模板;容器是从镜像启动的运行实例。Compose 用一个配置文件描述服务、构建和端口。浏览器访问 localhost 表示访问自己的电脑,端口用于区分本机服务。

修改被打进镜像的网页后,需重新构建。练习项目每次测试按顺序执行 docker compose down --remove-orphans,再执行 docker compose up -d --build --force-recreate;先用 docker compose config 确认当前目录与项目配置,避免操作其他项目。

06 · 浏览器本地数据和常见误区

localStorage 是保存在当前浏览器的数据,并不会因为用了 Docker 就自动同步到其他电脑。不同地址或端口的数据相互隔离;清理浏览器数据可能导致丢失。示例只使用虚构内容,不应保存重要资料的唯一副本。

07 · 出错时的四步法

  1. 停下并记录刚才的操作,不要连续尝试大量未知命令。
  2. 写出期望与实际现象,必要时截取不含敏感信息的错误。
  3. 告诉 AI 当前文件、完整报错和已尝试操作,请它先解释原因。
  4. 一次修改一处,重新运行原测试,并检查旧功能。

基础知识自检

COURSE 02 · 分步跟做

课程 2:目标清单完整过程

从空文件夹到本地 Docker 运行,完整跟做 22 步。

学习方式:每步先读“操作”,复制提示词给同一 AI 对话,按结果实际操作,再核对“完成标志”。更换对话时,把当前完整 index.html 和需求一起提供。示例为 Windows;macOS 可在终端完成同样步骤。文件必须保存,AI 的回答不会自动写入文件。
01 准备工具

自己操作:确认浏览器、AI 对话工具、纯文本编辑器、Git 和 Docker Desktop 已可用。

发给 AI 的提示词
我是编程零基础。请用通俗语言解释浏览器、HTML、Git、Docker Desktop 和 Docker Compose 分别做什么,每项不超过两句话。

完成标志:能说出浏览器用来查看网页,Git 用来记录版本。

02 确认运行环境

自己操作:启动 Docker Desktop,打开 PowerShell,分别执行 git --version、docker version、docker compose version。

发给 AI 的提示词
请教我在 Windows PowerShell 检查 Git、Docker 和 Docker Compose 是否可用。说明 docker version 中 Client 和 Server 各代表什么,以及看不到 Server 时先检查什么。

完成标志:三条命令可运行,docker version 同时显示 Client 和 Server;如失败先处理,不继续部署。

03 建立项目文件夹

自己操作:在“文档”中建立独立项目文件夹,名称为 goals-practice;在文件夹地址栏输入 powershell 回车。

发给 AI 的提示词
我是 Windows 新手。请一步一步教我新建项目文件夹,并在该文件夹打开 PowerShell;说明怎样用 pwd 和 dir 确认位置,不要替我执行删除命令。

完成标志:终端显示的是自己的项目文件夹。

04 用 Git 开始记录

自己操作:在刚建的项目目录执行 git init,然后执行 git status。项目目录应独立,避免在已有仓库里再次初始化。

发给 AI 的提示词
请解释 git init 和 git status 的作用,并告诉我怎样确认当前目录是我的项目目录。只管理本练习文件,不添加其他目录。

完成标志:git status 能显示当前仓库状态;不要输入密码或提交敏感文件。

05 明确要解决的问题

自己操作:决定给自己制作一个记录每日事项的工具,写下使用者和场景。

发给 AI 的提示词
我想做一个“每日小目标清单”,使用者是没有技术基础的我,场景是每天记录待办。请帮我把想法整理为一句目标、三个核心功能和三个可检查的验收条件,不要直接写代码。

完成标志:需求明确包含添加、勾选、删除。

06 拆分最小功能

自己操作:检查 AI 的方案,确认先做单页、单人、无账号版本。

发给 AI 的提示词
请把刚才的清单需求缩成适合零基础的最小版本:中文界面,添加、勾选、删除,不要登录、数据库或支付。给我逐条验收标准和暂不制作的功能。

完成标志:可以逐条判断是否实现。

07 生成完整网页

自己操作:新建名为 goals-practice 的独立文件夹;与 AI 保持同一对话,复制下面提示词。

发给 AI 的提示词
请按刚才确认的需求,生成一个完整 index.html:HTML、CSS、JavaScript 均放在同一文件,中文界面,输入后添加、勾选完成、删除指定项目,适合电脑和手机;不使用外部依赖和网络。仅使用虚构示例。请输出完整代码及保存、打开、测试步骤。

完成标志:AI 返回从 <!doctype html> 到 </html> 的完整文件。

08 保存并打开

自己操作:把代码完整粘贴到记事本,另存为 index.html;保存类型选所有文件,编码 UTF-8。双击文件。

发给 AI 的提示词
我使用 Windows 记事本。请逐步教我将你刚给的完整代码保存为 UTF-8 的 index.html,如何显示扩展名并确认不是 index.html.txt,怎样在浏览器打开。

完成标志:打开的是网页,而不是代码或空白文件。

09 测试添加

自己操作:输入“喝水”并点击添加,然后再输入“散步”添加。

发给 AI 的提示词
请为我的清单列出添加功能的详细人工测试步骤,分别包含普通输入、连续添加两项和预期结果。

完成标志:两项分别出现,内容与输入一致。

10 测试空输入

自己操作:不输入任何文字点击添加,再输入空格点击添加。

发给 AI 的提示词
请检查我的清单是否阻止空白内容和只包含空格的内容。如果没有,请只做必要修改,返回完整 index.html,并告诉我如何复测原有添加功能。

完成标志:没有空白项目;若 AI 修改了代码,保存后重新打开并复测。

11 测试勾选与删除

自己操作:分别勾选和取消勾选“喝水”,再只删除“散步”。

发给 AI 的提示词
请列出勾选、取消勾选和删除单项的测试步骤,特别检查删除一项不会影响其他项。

完成标志:勾选状态可识别,删除后另一项保留。

12 提出界面改进

自己操作:先复制 index.html 作为备份,再让 AI 修改一项样式。

发给 AI 的提示词
请保留添加、勾选和删除功能,把清单标题改成“我的每日小目标”,输入框文字加大,界面使用清爽的绿色。给我修改后的完整 index.html 和三个回归测试步骤。

完成标志:标题和字号改变;添加、勾选、删除仍正常。

13 增加清除已完成

自己操作:要求 AI 只增加一个按钮。

发给 AI 的提示词
请保留现有功能,增加“清除已完成”按钮:只删除已勾选项,未勾选项必须保留;没有已完成项目时不删除任何项目。请输出完整 index.html 及测试步骤。

完成标志:混合完成和未完成项时,按钮只清除完成项。

14 增加本地保存

自己操作:明确让 AI 增加浏览器本地保存,然后按其步骤保存文件。

发给 AI 的提示词
请保留现有功能,使用浏览器 localStorage 保存任务及完成状态;添加、修改和删除后及时保存;不可用时给出提示。请输出完整 index.html,说明本地数据限制和测试步骤。

完成标志:添加两项并勾选一项,刷新后内容与状态保留。

15 记录并修复问题

自己操作:找到一个测试失败点,或先检查刷新后状态是否正确;填写实际现象。

发给 AI 的提示词
我做了【填写操作】,预期【填写预期】,实际【填写实际】,重复情况【填写】。以下是当前完整 index.html:【粘贴】。请先分析原因,尽量小范围修复,给完整文件和复测步骤。

完成标志:问题能复现、修复后再测,未发生问题时跳过修改。

16 进行完整回归

自己操作:逐项检查添加、空输入、勾选、删除、清除已完成、刷新保存和窄窗口。

发给 AI 的提示词
请根据我的清单功能给我一张测试表:操作、预期结果、实际结果三列,包含空输入、删除单项、清除已完成及刷新。

完成标志:逐项记录通过或失败;失败时返回上一步处理。

17 准备容器文件

自己操作:在 goals-practice 目录准备 Dockerfile 与 compose.yaml。

发给 AI 的提示词
请生成 Dockerfile 与 compose.yaml:Dockerfile 使用 swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/library/nginx:1.27-alpine 并复制 index.html 到 /usr/share/nginx/html/index.html;Compose 顶层 name 为 goals-practice,web 服务从当前目录构建,端口为 127.0.0.1:8091:80,不挂载卷。分别输出完整文件和保存方法。

完成标志:三个文件在同一目录;Dockerfile 无扩展名。

18 检查与提交初版

自己操作:执行 git status;只添加 index.html、Dockerfile、compose.yaml 并提交。

发给 AI 的提示词
请教我查看 git status,然后仅提交 index.html、Dockerfile 和 compose.yaml,提交说明写“清单初版”。如果 Git 提示配置身份,说明如何只为当前仓库设置。

完成标志:版本提交成功,不包含其他项目或个人资料。

19 清理并部署

自己操作:执行 docker compose config;然后 docker compose down --remove-orphans;最后 docker compose up -d --build --force-recreate。

发给 AI 的提示词
请解释下列命令各自用途:docker compose config、docker compose down --remove-orphans、docker compose up -d --build --force-recreate。说明清理范围仅为当前 Compose 项目。

完成标志:构建和启动成功,容器属于 goals-practice。

20 访问容器内清单

自己操作:运行 docker compose ps,访问 http://localhost:8091 并重新测试全部功能。

发给 AI 的提示词
我在 localhost:8091 打开清单,请列出添加、勾选、删除、空输入和刷新保存的验收步骤;如果页面打不开,如何安全查看 docker compose ps 和 logs web?

完成标志:容器状态运行,页面功能正常。file:// 和 localhost 是不同来源,旧清单不会自动迁移。

21 更新并重新部署

自己操作:修改页面标题;先 down,再执行 up -d --build --force-recreate;刷新页面并复测。

发给 AI 的提示词
我修改了 index.html,请给出仅针对当前 Compose 项目的清理和重建命令,并说明为什么要重新构建。不要删除卷或其他项目。

完成标志:新标题出现,原功能仍正常。

22 最终交付与复盘

自己操作:检查 git status,提交本次修改;展示作品并说明限制。

发给 AI 的提示词
请根据我制作清单的过程,帮我生成一分钟演示提纲:需求、功能、遇到的问题、测试方法、Git 记录、Docker 地址和本地数据限制。

完成标志:能够向别人演示并说明数据存于当前浏览器。

进阶挑战:分类、优先级与筛选

在完成基础版本和保存 Git 版本后,把下列提示词发给 AI。修改后重新测试添加、勾选、删除和刷新保存。在自己的项目目录先执行 docker compose down --remove-orphans,再执行 docker compose up -d --build --force-recreate,重新访问并测试,然后提交 Git。

目标清单进阶提示词
请在现有清单基础上增加任务分类(生活、工作、学习)和优先级(普通、重要),添加任务时可选择;列表显示分类和优先级。增加按完成状态和分类组合筛选,并显示总数、已完成数、待完成数。保存到 localStorage,旧任务缺少分类或优先级时分别按生活和普通显示。保留添加、勾选、删除、清除已完成及空输入处理。请返回完整 index.html,列出筛选组合、统计、旧数据兼容与刷新后的测试步骤。

验收:添加不同分类和优先级,组合筛选后仅显示符合条件的项目;勾选、删除后统计更新;刷新后数据仍在,原功能正常。

完成后:直接体验成品

在下方体验每日小目标清单;也可以在新窗口打开每日小目标清单。此演示供你对照,自己的作品仍需按上方步骤制作和部署。

COURSE 03 · 分步跟做

课程 3:设计一个横版游戏

从游戏创意到容器运行,独立完成 23 步。

学习方式:每步先读“操作”,复制提示词给同一 AI 对话,按结果实际操作,再核对“完成标志”。更换对话时,把当前完整 index.html 和需求一起提供。示例为 Windows;macOS 可在终端完成同样步骤。文件必须保存,AI 的回答不会自动写入文件。
01 准备工具

自己操作:确认浏览器、AI 对话工具、纯文本编辑器、Git 和 Docker Desktop 已可用。

发给 AI 的提示词
我是编程零基础。请用通俗语言解释浏览器、HTML、Git、Docker Desktop 和 Docker Compose 分别做什么,每项不超过两句话。

完成标志:能说出浏览器用来查看网页,Git 用来记录版本。

02 确认运行环境

自己操作:启动 Docker Desktop,打开 PowerShell,分别执行 git --version、docker version、docker compose version。

发给 AI 的提示词
请教我在 Windows PowerShell 检查 Git、Docker 和 Docker Compose 是否可用。说明 docker version 中 Client 和 Server 各代表什么,以及看不到 Server 时先检查什么。

完成标志:三条命令可运行,docker version 同时显示 Client 和 Server;如失败先处理,不继续部署。

03 建立项目文件夹

自己操作:在“文档”中建立独立项目文件夹,名称为 jump-practice;在文件夹地址栏输入 powershell 回车。

发给 AI 的提示词
我是 Windows 新手。请一步一步教我新建项目文件夹,并在该文件夹打开 PowerShell;说明怎样用 pwd 和 dir 确认位置,不要替我执行删除命令。

完成标志:终端显示的是自己的项目文件夹。

04 用 Git 开始记录

自己操作:在刚建的项目目录执行 git init,然后执行 git status。项目目录应独立,避免在已有仓库里再次初始化。

发给 AI 的提示词
请解释 git init 和 git status 的作用,并告诉我怎样确认当前目录是我的项目目录。只管理本练习文件,不添加其他目录。

完成标志:git status 能显示当前仓库状态;不要输入密码或提交敏感文件。

05 明确游戏想法

自己操作:选择一个短关卡:角色向右移动、跳过障碍、到达终点。

发给 AI 的提示词
我想做一款零基础能完成的 2D 横版跳跃游戏。请将想法整理成玩家目标、操作、失败、胜利和重新开始五条规则,不要写代码。

完成标志:规则说得清楚,关卡规模适合入门。

06 限定第一版范围

自己操作:确认只做单人、一个短关卡、固定障碍、键盘操作。

发给 AI 的提示词
请帮我规划最小可用游戏:方向键移动、空格跳跃、固定障碍、终点、失败与重开。不要账号、联网、排行榜、外部素材或游戏引擎。列出可验收标准。

完成标志:能判断角色、障碍、胜负和重开是否正常。

07 生成完整游戏

自己操作:新建独立文件夹 jump-practice,在同一 AI 对话输入提示词。

发给 AI 的提示词
请用一个完整 index.html 制作刚才规划的 2D 横版游戏,HTML、CSS、JavaScript 全放在一个文件。使用 Canvas 和简单几何图形,不依赖外部资源。中文说明,左右键移动,空格跳跃,落地后才能再跳,碰障碍失败,到终点胜利,按钮重开并重置状态。键盘操作时页面不滚动。请输出完整文件与测试步骤。

完成标志:AI 给出完整代码及运行说明。

08 保存并运行

自己操作:把完整代码保存为 UTF-8 的 index.html,双击打开;点击游戏画面获得焦点。

发给 AI 的提示词
请教我用 Windows 记事本将完整游戏代码保存为 index.html,检查不是 .txt,并在浏览器运行。解释为什么可能需要先点击游戏区域。

完成标志:画面可见,点击后可进行键盘操作。

09 测试左右移动

自己操作:按住右键再按左键,检查角色是否按预期移动。

发给 AI 的提示词
请列出测试 2D 游戏左右移动、松键停止、边界限制和页面不滚动的人工步骤及预期结果。

完成标志:移动方向正确,角色不离开画面。

10 测试跳跃和落地

自己操作:按空格跳起,观察落地,再尝试连续按空格。

发给 AI 的提示词
请检查游戏跳跃和重力逻辑:空格跳起、落地停止下落、空中不能无限跳。若不符合请给完整修复代码和测试方法。

完成标志:角色落回地面,不穿地,也不能无限空中跳。

11 测试失败

自己操作:让角色直接碰到第一个障碍。

发给 AI 的提示词
请为碰撞失败功能设计测试,要求碰障碍后显示失败,游戏不再继续移动或获胜,并能重新开始。

完成标志:失败提示出现,停止正常游戏。

12 测试胜利与重开

自己操作:重新开始,跳过所有障碍并抵达终点;再次点击重新开始。

发给 AI 的提示词
请给我测试游戏胜利和重新开始的步骤,确认重开后角色位置、速度、按键状态及胜负提示都恢复。

完成标志:成功抵达终点;重开后状态重置。

13 调整关卡难度

自己操作:先复制 index.html 备份,要求 AI 只调整一项难度。

发给 AI 的提示词
保留当前功能,只让第一个障碍稍低,让跳跃更容易。请给完整 index.html,并说明如何测试碰撞和通关没有被破坏。

完成标志:新手可以尝试通关,原有功能仍可用。

14 改进画面与说明

自己操作:让 AI 增加清晰的中文提示,保持功能不变。

发给 AI 的提示词
保留游戏规则和操作,仅改善视觉:清楚区分地面、角色、障碍与终点,在画面旁显示中文键位说明;输出完整 index.html 和回归测试。

完成标志:画面要素可辨,操作说明清晰。

15 处理失焦和卡键

自己操作:按住方向键时点击画面外,再点击画面内测试。

发给 AI 的提示词
请检查浏览器窗口或游戏画面失去焦点时是否会导致按键卡住。请以最小修改清除按键状态,返回完整代码和验证步骤。

完成标志:失焦后角色不会持续移动,重新聚焦后可操作。

16 描述并排查问题

自己操作:选一个失败测试,或确认当前测试均通过;记录操作、期望和实际。

发给 AI 的提示词
我做了【操作】,期望【结果】,实际【结果】;是否稳定复现【填写】。以下是当前完整 index.html:【粘贴】。请先解释可能原因,最小修改并提供完整文件和复测步骤。

完成标志:如无问题可跳过修改;有问题先复现、再修复和复测。

17 全面游戏测试

自己操作:检查移动、跳跃、碰撞、胜利、重开、失焦和窗口变化。

发给 AI 的提示词
请按操作、预期、实际三列生成横版游戏测试表,覆盖移动、跳跃、碰撞、胜利、重新开始、失焦以及较窄窗口。

完成标志:所有关键功能有明确测试结论。

18 准备容器文件

自己操作:在 jump-practice 目录准备 Dockerfile 和 compose.yaml。

发给 AI 的提示词
请生成 Dockerfile 与 compose.yaml:Dockerfile 使用 swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/library/nginx:1.27-alpine 并复制 index.html 到 /usr/share/nginx/html/index.html;Compose 顶层 name 为 jump-practice,web 服务从当前目录构建,端口为 127.0.0.1:8092:80,不挂载卷。分别输出完整文件和保存方法。

完成标志:三个文件位于同一文件夹,Dockerfile 没有扩展名。

19 用 Git 保存初版

自己操作:执行 git status;只添加 index.html、Dockerfile、compose.yaml 并提交。

发给 AI 的提示词
请教我在当前游戏仓库检查 git status,并只提交 index.html、Dockerfile、compose.yaml,提交信息写“游戏初版”。如果没有配置身份,说明如何仅对本仓库配置。

完成标志:提交成功,未包含其他文件。

20 清理并部署

自己操作:执行 docker compose config;docker compose down --remove-orphans;docker compose up -d --build --force-recreate。

发给 AI 的提示词
请解释上述三个 Compose 命令,并说明为什么每次先清理本项目旧组件再重建。不要删除卷或其他项目。

完成标志:游戏镜像构建成功,容器启动。

21 访问容器里的游戏

自己操作:执行 docker compose ps,打开 http://localhost:8092,点击画面后使用键盘。

发给 AI 的提示词
我在 localhost:8092 玩游戏。请列出检查容器状态、移动、跳跃、失败、胜利、重开与失焦的步骤,页面打不开时如何查看 logs web。

完成标志:页面可访问,关键游戏操作正常。

22 修改并重新部署

自己操作:修改标题;先 down,再执行 up -d --build --force-recreate;刷新并重新玩一遍。

发给 AI 的提示词
我的游戏 index.html 已修改。请给出先清理当前 Compose 项目再重建并启动的命令,并解释改代码后为何需要重新构建。

完成标志:标题已更新;游戏仍可通关和重开。

23 最终交付与复盘

自己操作:检查 git status,提交本次修改,演示游戏并说明已知限制。

发给 AI 的提示词
请帮我生成一分钟游戏演示稿:创意、操作、胜负规则、一次问题修复、Git 版本记录、Docker 本地地址,以及键盘操作限制。

完成标志:能独立演示游戏与重新部署过程。

进阶挑战:金币与生命值

基础游戏可运行并已保存 Git 版本后,增加规则。修改后重新测试碰撞、通关和重新开始。在自己的项目目录先执行 docker compose down --remove-orphans,再执行 docker compose up -d --build --force-recreate,重新访问并测试,然后提交 Git。

横版游戏进阶提示词
请保留现有横版游戏操作,增加 3 条生命和 3 枚固定金币。碰到障碍扣 1 条生命并回到起点,生命为 0 显示失败;已收集金币在本局保持。角色碰到金币时收集并显示进度,只有收集全部金币后到终点才胜利;未集齐时给出提示。重新开始重置生命、金币、位置和按键状态。请返回完整 index.html,并列出生命耗尽、金币收集、未集齐到终点、胜利及重开测试。

验收:依次测试三次碰撞失败;新游戏收集金币,未集齐到终点有提示,集齐后到终点胜利;重开后所有状态恢复。

完成后:直接体验成品

在下方体验2D 横版跳跃游戏;也可以在新窗口打开2D 横版跳跃游戏。此演示供你对照,自己的作品仍需按上方步骤制作和部署。

TEACHER NOTES

新手可能遇到的问题

以下为教学设计推演,非真实学员测试。教师可提前准备备用文件和脱敏截图。

现象下一步
AI 返回一大段代码解释代码需要保存为 HTML;带学员完成保存和打开。
双击后显示文字显示文件扩展名,检查是否误存为 .html.txt。
按钮没有反应记录操作、期望和实际;提供完整代码请 AI 排查。
刷新后内容消失确认是否要求保存;增加本地保存并实际验证。
修改后原功能坏了恢复备份,一次只改一项,再测试新旧功能。
AI 的解释看不懂追问:“请用零基础能理解的语言说明下一步。”
工具提示付费停止并核对实际费用;使用教师备用文件继续。
PROMPT TOOLKIT

随时可用的提示词工具箱

描述需求
我想做一个【名称】。使用者是【谁】,使用场景是【何时、为什么用】。
最重要的功能:1.【功能一】2.【功能二】3.【功能三】。
界面希望:【语言、风格、设备】。
完成后,请告诉我如何使用、应该测试什么,以及目前有哪些限制。
提出修改
请保留目前正常工作的功能,只修改:【具体修改】。
我希望修改后的效果是:【可观察、可测试的结果】。
请说明改了什么,并列出需要重新测试的步骤。
描述问题
我是零基础用户,请用简单语言帮助我。
我刚才做了:【操作】;我期望看到:【期望】;实际看到:【结果】;我尝试过:【方法】。
请先解释可能原因,再告诉我下一步。如果需要修改,请尽量只改与问题有关的内容。