AIGD · 编排器
AIGD = AI 游戏设计。一个可移植的 AI 游戏开发方法论包:涵盖头脑风暴 → 系统设计 → 玩法测试迭代 → 最终交付与交接,生成一个交付包(平台无关),供“另一个 AI 直接开发”;落地实现(选择技术栈编写客户端/服务器)不在本包内,留待后续专门的落地技能处理。
状态:v0(预发布)——已端到端验证(真实运行演示 + 仓库 README 中可运行的
examples/指南)。patterns/是一个入门包,持续增长中(参见references/README.md)。
核心模型(详情请参考 references/)
- 两层结构:① 实时项目层(脊柱)——
项目章程(概念/平台/目标用户/类型/风格/命名约定)+清单(系统列表 + 依赖图 + 跨层索引 + 冻结台账 + 编号范围注册表),持续修订;② 每个系统的生产循环。 - 集中式真实来源:枚举/编号/接口合约/配置表属于项目层;双重副本(系统 + 全局):验收标准/资源需求/原型;仅系统层:规则/后端算法。
- 每次操作:读取脊柱 → 执行工作 → 写回脊柱。下层发现(新系统/新依赖/新枚举/变更的概念)向上写回上层。
- 方法论真实来源:
references/methodology.md、references/README.md。
路由:根据“你本次想做什么”分配子技能
| 你想做什么 | 子技能 |
|---|---|
| 概念/核心循环/平台/目标用户/拆分为系统 | aigd-concept |
| 设计一个系统(规则 + 配置测试数据 + HTML 原型) | aigd-system |
| 玩法测试后优化系统(规则/配置/原型,可重复) | aigd-iterate |
| 最终确定一个系统 → 合约/验收标准/客户端-服务器文档/面向设计师的验收清单 | aigd-handoff |
| 同步回全局规格/整体原型/实现主指南;标记共享项变更的重新检查 | aigd-sync |
| UI截图 → UI DSL(构建 UI 范式知识库,用于设计时检索和参考) | aigd-ui-capture |
使用方式
- 首先读取脊柱(项目章程 + 清单)以判断:项目已进行到哪一步,本次系统处于何种状态,缺少什么。
- 没有脊柱 → 先使用
aigd-concept启动项目(构建脊柱)。 - 选择匹配的子技能并通过 Skill 工具 调用执行;每个子技能读写同一个脊柱,保持其一致性和可重入性(可在不同会话/由另一个 AI 继续)。
- 典型路径:概念(一次)→ 每个系统 {系统 → 迭代…(重复)→ 最终交接} → 同步(持续)。迭代后不会直接进入同步——同步准入要求系统已是
Final状态,且只有交接能使其最终确定;顺序不强求,根据需要路由。
当没有脊柱时(首次在项目上使用,
项目章程/清单尚不存在):“读取脊柱”返回空 → 直接路由到aigd-concept启动脊柱;这是正常行为,不是错误。
打开时的自查(每次进入 /aigd 时执行——主动推进,不要等用户猜测)
- 脊柱是否存在? 是 → 读取
project-charter.md+manifest.md;否 → 路由到aigd-concept启动项目。 - 哪些系统状态 ≠
Final? 列出它们,询问用户本次推进哪个。 - 是否有
Recheck系统? 提醒先重新检查(某些共享项已变更)→ 路由到aigd-sync解决(重新检查通过 → 回到Final/ 失败 → 退回)。 - 编号范围冲突或依赖图中存在循环? 检查并报告。
状态转换(非线性 · 支持回滚)
概念 ──→ 系统设计 ⇄ 玩法测试迭代 ──→ 最终确定 ──→ 集成
▲ │ │ │(退回)
│ │ │ ▼
│ └─边界划分错误──┴────→ 回到玩法测试 / 回到概念
└────────── 集成发现不兼容 / 需要重新拆分 ──────────────────┘
- 任何退回/重新拆分都会在清单的“回滚日志”中记录一条条目,并根据“退回规则”反向查找
depended-on-by,将已最终确定的下游系统标记为Recheck(参见aigd-handoff/aigd-sync)。 - 模板:
references/templates/(项目章程/清单/实现主指南,强类型)。
包结构(安装整个包,不要拆开)
aigd(本编排器,包含 references/ 方法论和模板)+ 6 个子技能 aigd-concept / system / iterate / handoff / sync / ui-capture,安装在此环境技能目录的同一层级(遵循宿主代理,例如 Claude Code 的 .claude/skills/)。子技能主体使用 ../aigd/references/ 获取方法论 → aigd/ 必须存在于同一层级(aigd-ui-capture 同样通过 ../aigd/references/ui-dsl-spec.md 和 scripts/)。单一真实来源,不要单独复制;如果以后想独立分发,请升级为插件(参见 references/README.md“打包与可移植性”)。
项目环境建议
- 脊柱文件(
项目章程/清单)和设计制品建议置于 Git/SVN 管理下;编排器应在每次操作前查看版本状态。 - CHANGELOG(变更日志)补充版本控制:VCS 记录“变更了什么”,CHANGELOG 记录“为什么变 + 哪个模型变的”(此方法论是 AI 辅助流程,记录模型有助于追溯变更来源)。
边界
- 范围仅限于“另一个 AI 可以直接开发的交付包”(平台无关:规则/合约/配置/验收标准/原型/资源需求)。
- 技术栈选择与客户端/服务器实现 = 下游,不在此包内。