game-design-docs

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Game Design Docs

游戏设计文档

Use this skill to create documents that help an AI game-building agent make consistent decisions across sessions. The document should be short enough to stay current and specific enough to constrain implementation.

使用本技能创建文档，帮助AI游戏构建Agent在不同会话中做出一致的决策。文档应足够精简以保持时效性，同时足够具体以约束实现过程。

Source Traceability

来源追溯

Primary source: The Art of Game Design: A Book of Lenses, Third Edition by Jesse Schell, especially chapter 27 on design documents and team communication. The workflow is transformed and paraphrased.

Supporting source: the rest of the game skill pack, which turns design lenses into implementable briefs.

主要来源：Jesse Schell 所著《游戏设计艺术：透镜之书（第三版）》，尤其是第27章关于设计文档与团队沟通的内容。工作流经过改编与转述。

支持来源：游戏技能包的其余部分，其将设计透镜转化为可落地的设计简报。

Workflow

工作流

Decide the document's job: alignment, implementation, content production, tuning, playtest, or memory.
Keep stable intent separate from volatile implementation details.
Capture decisions, rejected alternatives, open questions, and validation evidence.
Link specs to code, data, assets, tests, and telemetry when possible.
Update docs after design decisions, not after every small code edit.

明确文档的用途：对齐共识、落地实现、内容生产、调优、玩法测试或项目记忆。
将稳定的设计意图与易变的实现细节分离。
记录决策、被否决的备选方案、待解决问题以及验证依据。
尽可能将规格说明与代码、数据、资产、测试及遥测数据关联。
仅在做出设计决策后更新文档，无需每次小幅代码修改都更新。

Required Output

必备输出项

```
Doc Type
```
: brief, system spec, feature contract, tuning sheet, content schema, playtest report, or decision log.
```
Canonical Sections
```
: concise headings suited to the doc type.
```
Open Questions
```
: unresolved decisions with owner or next evidence.
```
Implementation Contract
```
: what the agent should build, avoid, test, and instrument.
```
Maintenance Rule
```
: when this doc must be updated.

```
Doc Type
```
：简报、系统规格、功能契约、调优表、content schema、玩法测试报告或决策日志。
```
Canonical Sections
```
：适配对应文档类型的精简标准章节。
```
Open Questions
```
：未解决的决策，需标注负责人或下一步验证依据。
```
Implementation Contract
```
：明确Agent应当构建、规避、测试及埋点监控的内容。
```
Maintenance Rule
```
：规定本文档必须更新的场景。

Local References

本地参考资料

Before producing a design document, read:

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

生成设计文档前，请阅读：

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