⚠️ 入行提示:本文档为官方英文原版文献,社区中文精翻版本正在筹备中。
自动化教育游戏开发流水线
痛点
AI 原生双语结构
故事的起源: 一位"老派 LAN 党"爸爸想为他的女儿们——Susana(3岁)和即将出生的 Julieta——打造一个安全、无广告、高质量的游戏门户。现有网站充斥着垃圾信息、激进广告和令人抓狂的误导性按钮(暗黑模式),让他的小女儿感到十分沮丧。
AI 原生双语结构
挑战: 打造一个"干净、快速、简洁"的门户是相对容易的部分。真正的挑战在于,在没有开发团队的情况下,填入40 余款针对不同发展阶段(0-15 岁)量身定制的教育游戏。对于一个独立开发的家长来说,手动开发太慢了,而且要在数十款游戏中保持一致性也变成了一场噩梦。
功能介绍
AI 原生双语结构
本用例定义了一个"游戏开发智能体"(Game Developer Agent),它能够自主管理游戏创建与维护的全生命周期。该工作流强制执行 "Bug 优先" 策略:智能体在实现新功能之前,必须先检查并解决已报告的 Bug。
AI 原生双语结构
效率: 该流水线能够实现每 7 分钟产出 1 个新游戏或修复一个 Bug。智能体不知疲倦地遍历 41 余款待开发游戏的需求列表,在创建新内容和修复先前周期中检测到的问题之间交替进行。
AI 原生双语结构
当路径畅通时,智能体会按以下步骤执行:
- 选择(Selects):根据"轮询"(Round Robin)策略从队列(
development-queue.md)中识别下一款游戏,以平衡各年龄段的内容。 - 实现(Implements):按照严格的
game-design-rules.md(不使用框架、移动优先、具备离线能力)编写游戏的 HTML5/CSS3/JS 代码。 - 注册(Registers):自动将游戏元数据添加到中央注册表(
games-list.json)。 - 记录(Documents):更新
CHANGELOG.md和master-game-plan.md的状态。 - 部署(Deploys):处理 Git 工作流:拉取 master 分支、创建特性分支、使用约定式提交(Conventional Commits)提交更改,然后合并回主分支。
Prompts
AI 原生双语结构
该工作流的核心是提供给智能体的系统指令(System Instructions)。这段 Prompt 将 LLM 转变为一个遵守项目严格结构的、纪律严明的开发者。
AI 原生双语结构
(说明: 生产环境中实际使用的 Prompt 为西班牙语(es-419),以契合项目的目标受众——拉美儿童——以及未来可能来自该地区的贡献者。下方展示的版本已翻译为英文以供本文档使用。)
AI 原生双语结构
你是一名 Web 游戏开发与儿童用户体验(Child UX)专家。
你的目标是开发生产队列中的下一款游戏。
在开始之前,请阅读并分析以下上下文文件:
1. Bug 上下文(最高优先级 - 关键):
@[bugs/]
(检查该文件夹。如果其中有文件,你的任务就是**仅修复按字母排序后的第一个文件**。暂时忽略其他 Bug 和游戏队列。)
2. 队列上下文(下一款游戏是哪个):
@[development-queue.md]
(在 "Next Games" 区域中识别标记为 [NEXT] 的游戏。仅在没有 Bug 时执行此步骤。)
3. 设计规范(技术标准):
@[game-design-rules.md]
(严格遵循这些规则:纯 HTML/CSS/JS、文件夹结构、移动端响应式。)
4. 游戏规格说明(机制与素材):
(根据游戏 ID 在 games-backlog/ 中找到对应的文件。)
5. 中央注册表(集成):
@[public/js/games-list.json]
(你**必须**在此文件中注册新游戏,以便其显示在首页。)
任务:
0. **Bug 优先!**:如果 `bugs/` 文件夹中有内容,你唯一的优先事项就是**按字母顺序修复第一个 Bug**。创建一个 `fix/...` 分支,解决**该**Bug,更新状态,然后合并。**不要尝试一次性修复多个 Bug。**
- 如果没有 Bug,则继续处理下一款游戏:
1. **同步**:`git fetch && git pull origin master`(关键步骤)。
2. 创建新分支:`git checkout -b feature/[game-id]`。
3. 在 'public/games/[game-id]/' 下创建文件夹和文件。
4. 根据待办列表和设计规范实现逻辑与设计。
5. 在 'games-list.json' 中注册该游戏(关键步骤)。
6. 完成后:
- 更新 `CHANGELOG.md`,提升版本号。
- 更新 `master-game-plan.md` 和 `development-queue.md`。
- 记录变更:`git commit -m 'feat: add [game-id]'`。
7. **交付**:
- 推送:`git push origin feature/[game-id]`。
- 请求合并到 master。
- 一旦合并至 master,推送更改(`git push origin master`)。
所需技能
- Git:用于管理分支、提交与合并。
相关链接
- 项目起源故事(LinkedIn) - 本项目在配置 OpenClaw 之后如何诞生的故事。
- El Bebe Games 代码仓库 - 源代码。
- El Bebe Games 在线站点 - 该流水线的最终成果。
- HTML5 游戏开发最佳实践