mcpField
G
game-design-docs

game-design-docs

github.com/lvtd-llc开发166 次安装7 周前更新
代码仓库

关于 game-design-docs

用于编写简洁、易维护的设计文档,帮助 AI 游戏构建 Agent 在不同会话中保持决策一致。它组织设计决策、未决问题、实现约束和验证依据。

主要功能

  1. 01选择文档类型
  2. 02区分设计意图与实现细节
  3. 03记录决策和未决问题
  4. 04将规格关联项目产物
  5. 05制定实现与维护规则

适用场景

  1. 01统一游戏团队的设计意图
  2. 02为 Agent 准备实现简报
  3. 03记录试玩发现或设计决策

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/lvtd-llc/skills --skill game-design-docs

安装后在 Claude Code 中输入/game-design-docs确认已加载。

附带文件references/core/guide.mdworkflows/living-design-doc.md

详细介绍

游戏设计文档

使用此技能创建文档,帮助 AI 游戏构建 Agent 在不同会话中做出一致的决策。文档应足够简短,以便保持最新;也应足够具体,以约束实现。

来源追溯

主要来源:Jesse Schell 所著的 The Art of Game Design: A Book of Lenses, Third Edition,尤其是关于设计文档和团队沟通的第 27 章。此工作流经过改编和转述。

辅助来源:游戏技能包的其余部分,它将设计视角转化为可执行的简报。

工作流

  1. 确定文档的用途:对齐、实现、内容制作、调优、试玩或记忆。
  2. 将稳定的设计意图与易变的实现细节分开。
  3. 记录决策、被否决的方案、未解决的问题和验证证据。
  4. 尽可能将规范关联到代码、数据、资源、测试和遥测。
  5. 在做出设计决策后更新文档,而不是每次进行小幅代码修改后都更新。

必需输出

  • Doc Type:简报、系统规范、功能契约、调优表、内容架构、试玩报告或决策日志。
  • Canonical Sections:适合该文档类型的简洁标题。
  • Open Questions:尚未解决的决策,并注明负责人或下一步所需证据。
  • Implementation Contract:Agent 应构建、避免、测试和检测的内容。
  • Maintenance Rule:必须更新此文档的时机。

本地参考资料

编写设计文档前,请阅读:

  • references/core/guide.md
  • workflows/living-design-doc.md

评论

支持 Markdown