用 Qoder 从零开发并发布一款在线赛车游戏：全流程提示词实录

线上地址：彩虹卡丁车 Rainbow Kart Rush —— 浏览器打开即可试玩，无需安装任何东西。

这篇文章完整记录我是如何用 Qoder（AI 编程助手）从一句话需求出发，多 Agent 协作开发出一款马里奥赛车风格的 3D 卡丁车网页游戏，并直接发布成在线站点的。所有提示词均为实录，希望给想做「一句话出产品」的朋友一些参考。

一、起点：一条结构化需求提示词

整个项目的第一条提示词是这样的：

1.帮我通过多Agents协作，参考马里奥赛车开发一个炫酷的赛车游戏，并发布在线站点
2.要求赛车物理效果合理,加速、刹车、碰撞、转弯、速度等符合物理条件,赛车不能穿越墙壁，
  场景是白天天气晴朗蓝天白云
3.预期效果：一个可直接交互的赛车游戏，任何人都可以访问这个网址互动
4.代码在本地 D:\Projects\Gitea 目录下创建调试完成后再进行发布。

同时我在提示词里 @ 了两个技能：game-designer-toolkit（游戏策划：GDD、系统、关卡设计）和 minigame-dev-pro（小游戏开发全链路专家）。

复盘下来这条提示词有效的原因有四点：

明确了协作方式——「多 Agents 协作」，让 Qoder 拆出专职 Agent 并行开发，而不是单线程慢慢磨；
给出了可验收的硬指标——「不能穿墙」「白天蓝天白云」「可直接交互」，这些都是 AI 能在浏览器里自动验证的条件，避免交付时扯皮；
指定了发布形态——「发布在线站点、任何人可访问」，开发-调试-发布的完整链路一开始就定下了；
约束了工程位置——「本地目录创建、调试完成后才发布」，防止 AI 拿半成品直接上线。

二、Qoder 实际做了什么

1. 先设计，后编码

Qoder 借助游戏设计技能先产出了两份文档：

docs/GDD.md：游戏设计文档（核心玩法循环、道具系统、排名规则、美术方向）；
docs/SPEC.md：模块接口契约（每个源文件的导出函数、数据结构、物理参数）。

这一步是多 Agent 并行的前提：先冻结接口，再分工编码，各 Agent 写的模块之间才不会打架。

2. 多 Agent 并行开发

按接口契约，多个 Agent 并行认领了互不重叠的文件：

模块	内容
物理引擎 `physics.js`	自行车模型转向、引擎曲线加速、空气阻力、手刹漂移、子步长碰撞检测（保证高速不穿墙）
赛道与场景 `track.js` / `scene.js`	Catmull-Rom 闭环赛道、护栏、蓝天大球穹顶、太阳光晕、体积云、阴影
AI 车手 `ai.js`	循迹 + 速度前瞻 + 卡住自救 + 道具使用的 5 个机器人对手
道具系统 `items.js`	加速蘑菇、金币、护盾星等
HUD 界面 `ui.js`	时速/圈数/名次/倒计时/小地图/结算面板
主循环 `main.js`	固定步长累加器、相机跟随、比赛流程（由我本人盯整合）

技术选型上全程零构建：Three.js 走 CDN importmap + 原生 ES Module，静态托管即可运行，这也是能「一键发布」的关键。

3. 浏览器实测，不是嘴上说说

调试阶段 Qoder 直接操作本地浏览器做验收：跑满油门测极速（80.9 km/h）、0→10m/s 加速耗时、以 39 m/s 撞墙验证不穿模、检查道具拾取与 HUD 刷新，全程读控制台错误。期间还揪出过一个隐蔽的几何 bug——四边形第二个三角形顶点顺序写反，导致一半路面被背面剔除，修复后重新全量回归。

4. 发布上线

验证通过后发布到 Qoder Sites，拿到公开访问地址：

https://rainbow-kart-rush-hwj5ichcz0e.qoder.zone/

任何人打开链接、按 WASD/方向键就能玩。

三、第二轮迭代：一条「挑毛病」提示词

上线试玩后，我发了一条非常口语化的优化提示词：

当前游戏还需要优化，例如，无法暂停，没有游戏音乐，玩家启动明显比电脑慢等

关键是这个「例如」——它授权 AI 不止修复列出的三项，而是按同样标准主动排查体验问题。结果：

暂停：P / Esc 暂停并弹出提示面板，M 键静音开关；
音乐：新增 audio.js，用 Web Audio 程序化合成 138 BPM 芯片风 BGM、引擎轰鸣声和起步/撞击/道具/过圈音效，零音频文件体积；
起步公平：排查发现真正的坑是倒计时期间 AI 在全速跑而玩家被冻结——改为 AI 发车间置锁、GO 瞬间同时释放，并加入马里奥赛车式「完美起步」：GO 时按住油门可获得火箭起步。

修完后重新构建、重新发布，全程一条提示词驱动。

四、可复用的提示词模板

把这次经验浓缩成一个通用模板：

【做什么 + 怎么做】帮我通过多Agents协作，参考<成熟产品>开发一个<产品>，并发布在线站点
【验收硬指标】核心体验必须满足：<物理/视觉/交互等可验证的条件>
【交付形态】预期效果：一个<使用者能直接上手互动>的成品，任何人都可以访问这个网址
【工程约束】代码在本地<目录>创建，调试完成后再发布

两条追加心法：

迭代时大胆用「例如……等」：列出最刺眼的问题即可，把主动排查同类问题的权限交给 AI；
让 AI 拿证据交付：要求它在真实浏览器里交互验证（性能数据、不穿墙、控制台零报错），而不是只看代码说「应该没问题」。

五、结语

从第一条提示词到公网可玩的 3D 赛车游戏，整个流程没有出现一行手写工程代码——人负责提需求和试玩挑毛病，AI 负责设计、并行开发、浏览器实测和发布运维。感兴趣的话，直接去彩虹卡丁车跑一圈，也欢迎把你玩出来的问题丢给你的 AI 试试「例如……等」句式。

最后坦白一句：当然，这篇博文本身也是 AI 生成的——由 Qoder 整理本次开发全程的提示词实录成文，再经博客后台 API 自动发布上线。连「记录 AI 工作流」这件事，都成了 AI 工作流的一部分。😄

这篇文章上面全都是AI写的，该说不说现在的AI写作，AI味还是太重了，不过随着AI能力的不断提升，最后会变得越来越难分辨的。