Communitygithub.com

ProdaZhang/aigd

使用AI进行游戏设计头脑风暴,并将输出直接交给另一个AI进行构建——内置确定性一致性检查器。

aigd 是什么?

AIGD(AI Game Design,AI游戏设计)是一个可移植的AI游戏开发方法论包,涵盖从头脑风暴、系统设计、玩法测试迭代到最终交付的完整流程。它生成一个平台无关的“交付包”,使得另一个AI可以直接基于此进行开发。该技能作为编排器,通过读取项目脊柱(项目章程+清单)来路由到六个子技能(概念、系统、迭代、交接、同步、UI捕获),确保所有操作都读写同一份核心文档,保持状态一致性和可重入性。支持非线性状态转换和回滚,包括依赖冲突检测和重新检查机制。适用于Claude Code、Cline等支持Skills的AI代理环境。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add ProdaZhang/aigd

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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

使用方式

  1. 首先读取脊柱(项目章程 + 清单)以判断:项目已进行到哪一步,本次系统处于何种状态,缺少什么。
  2. 没有脊柱 → 先使用 aigd-concept 启动项目(构建脊柱)。
  3. 选择匹配的子技能并通过 Skill 工具 调用执行;每个子技能读写同一个脊柱,保持其一致性和可重入性(可在不同会话/由另一个 AI 继续)。
  4. 典型路径:概念(一次)→ 每个系统 {系统 → 迭代…(重复)→ 最终交接} → 同步(持续)。迭代后不会直接进入同步——同步准入要求系统已是 Final 状态,且只有交接能使其最终确定;顺序不强求,根据需要路由。

当没有脊柱时(首次在项目上使用,项目章程/清单尚不存在):“读取脊柱”返回空 → 直接路由到 aigd-concept 启动脊柱;这是正常行为,不是错误。

打开时的自查(每次进入 /aigd 时执行——主动推进,不要等用户猜测)

  1. 脊柱是否存在? 是 → 读取 project-charter.md + manifest.md;否 → 路由到 aigd-concept 启动项目。
  2. 哪些系统状态 ≠ Final? 列出它们,询问用户本次推进哪个。
  3. 是否有 Recheck 系统? 提醒先重新检查(某些共享项已变更)→ 路由到 aigd-sync 解决(重新检查通过 → 回到 Final / 失败 → 退回)。
  4. 编号范围冲突或依赖图中存在循环? 检查并报告。

状态转换(非线性 · 支持回滚)

概念 ──→ 系统设计 ⇄ 玩法测试迭代 ──→ 最终确定 ──→ 集成
 ▲             │              │            │(退回)
 │             │              │            ▼
 │             └─边界划分错误──┴────→ 回到玩法测试 / 回到概念
 └────────── 集成发现不兼容 / 需要重新拆分 ──────────────────┘
  • 任何退回/重新拆分都会在清单的“回滚日志”中记录一条条目,并根据“退回规则”反向查找 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 可以直接开发的交付包”(平台无关:规则/合约/配置/验收标准/原型/资源需求)。
  • 技术栈选择与客户端/服务器实现 = 下游,不在此包内。

相关技能