Echo Forge

Echo Forge 是面向独立游戏创作者的游戏创作智能体工具。它用三个可运行的薄 Agent 分别调用体验设计、Apple 游戏原型实现和 Demo 验收 Skills，让设计、代码与验证结果保持可追溯。

适用范围

这套工具主要面向操作简单、以长期成长为核心的 2D/2.5D 放置升级游戏，例如通过按钮、菜单和资源分配完成建设、养成、阶段解锁与离线积累的游戏。它适合处理以下问题：

• 设计资源来源、消费、产出、升级和阶段解锁规则；
• 将低频玩家操作映射为稳定、可恢复的永久进度；
• 使用 SwiftUI 承载菜单与管理界面，使用 SpriteKit 接入已有素材并播放基础场景反馈；
• 验证离线结算、重复操作、重启恢复和动画中断不会破坏权威状态。

它不负责生成高品质美术资产，也不保证最终画面达到特定美术水准；角色、场景、UI、音频和高级动效需要由独立的美术与视听流程提供。本工具也不以复杂动作操作、开放世界、实时多人、重度物理模拟或复杂 3D 游戏为目标。

立即体验

项目需要 Python 3.12+ 和 Codex CLI。首次运行：

uv venv .venv
source .venv/bin/activate
python agents/agent.py designer "把回声纪元构想整理成可验收体验规格"

默认只输出将交给宿主的完整 Prompt，便于检查 Agent 如何加载 Skill。加入 --execute 才实际调用 Codex：

source .venv/bin/activate
python agents/agent.py designer "整理现有游戏设计并写出验收场景" --execute
python agents/agent.py builder "按已确认规格实现最短可玩闭环" --execute
python agents/agent.py reviewer "按 spec.md 验收当前游戏 Demo" --execute

Agent 与 Skill

Agent 参数	明确调用的 Skill	作用
designer	$design-game-experience	收口目标玩家、核心循环、状态模型和验收场景
builder	$build-apple-game-prototype	实现 SwiftUI、SpriteKit、SwiftData 原型
reviewer	$validate-game-demo	建立 Specs 与构建、测试、演示证据的对应关系

统一入口是 agents/agent.py。Agent 只负责选择、加载和点名 Skill；专业工作流只存在于各 SKILL.md，避免两套 Prompt 漂移。

测试

source .venv/bin/activate
python -m unittest discover -s tests -v

项目材料

• Specs 与评测标准
• Agent 交互与输入输出样例
• 能力验证报告
• 项目 Demo：实际效果通过项目 Demo 链接展示；链接可在验证报告中补充

当前边界

Agent 程序、Skills、样例与自动测试已提供。游戏源码位于参考项目 Echo，不在本仓库复制；游戏画面、核心闭环和恢复行为等实际效果通过项目 Demo 链接展示。基础画面表现依赖项目已有素材，本工具不承诺生成高品质美术。仓库不会把未实际运行的游戏构建写成已经通过。