## 阅读说明

<p>
本说明帮助你快速了解《游戏开发图谱》的内容结构、文档格式和推荐阅读路径，以便更高效地使用这份资料。
</p>

**关键词:**<br/>
*阅读指南,内容结构,学习路径,文档格式*

---

## 目录

- [内容定位](#内容定位)
- [AI Coding 总览](#ai-coding-总览)
- [文档结构](#文档结构)
- [文档格式说明](#文档格式说明)
- [推荐阅读路径](#推荐阅读路径)
- [如何配合 AI 使用](#如何配合-ai-使用)
- [快速导航](#快速导航)

---

## 内容定位

> 🎯 **这份图谱包含什么？**
>
> - **是做什么的？在哪用？** — 快速理解概念和应用场景
> - **会遇到哪些问题？用什么解决？** — 常见坑与解决方向
> - **要点和思考方向** — 提炼关键点，便于记忆和扩展
>
> **这份图谱不包含什么？**
>
> - 系统化的知识讲解（需结合教材、课程）
> - 具体的实现细节（需查阅官方文档、源码）
> - 完整的一套解决方案（需根据项目实际情况裁剪）

---

## AI Coding 总览

> 💡 **为何要掌握知识才能更好操作 AI？**  
> 要想更好地使用 AI 编程，就需要有丰富的知识和经验，才能准确告诉 AI「要做什么」「在什么约束下做」「如何验证结果」。掌握这些基础概念，有助于你写出更精准的提示词、判断 AI 输出是否正确、在出错时快速纠正。

各技术点下的 **AI Coding 指南** 包含三类内容：

| 类型 | 说明 | 示例 |
|------|------|------|
| **交互提示** | 如何向 AI 描述需求，让输出更符合预期 | 「把魔法数字提取为常量，并说明用途」 |
| **方法** | 与 AI 协作的流程和注意事项 | 提供语言、平台、业务上下文 |
| **应用** | 可交给 AI 的具体任务场景 | 批量重构、生成代码骨架、检查规范 |

---

## 文档结构

```
mds/
├── 阅读说明.md                    ← 你正在阅读的文档
├── 1.基础能力/                     # 编程语言、程序设计、通用基础
├── 2.技术能力/                     # 客户端技术、服务端技术、开发者工具箱
├── 3.研发能力/                     # 客户端研发、服务端研发、业务层功能
├── 4.生产能力/                     # 游戏生产、工具开发、技术中台
├── 5.管理能力/                     # 工作流、质量保障、项目管理
├── 6.运营能力/                     # 运维技术、产品运营支持、产品商业化
├── topics/                         # 专题内容（新人指南、职业发展等）
├── 游戏研运资产样例-SLG手游（2D）.md
├── 游戏创业-手机网络游戏.md
├── 一站式手游创业/
└── x-*.md                          # 其他专题
```

### 六大能力模块

| 模块 | 说明 | 入口文档 |
|------|------|----------|
| **1.基础能力** | 编程语言、设计模式、数据结构、算法、数学、操作系统等 | [1.基础能力.md](1.基础能力/1.基础能力.md) |
| **2.技术能力** | 图形渲染、物理、UI、引擎、网络、数据库、工具等 | [2.技术能力.md](2.技术能力/2.技术能力.md) |
| **3.研发能力** | 客户端研发、服务端研发、网络同步、业务功能等 | [3.研发能力.md](3.研发能力/3.研发能力.md) |
| **4.生产能力** | 数字内容生产、编辑器、工具链、DevOps 等 | [4.生产能力.md](4.生产能力/4.生产能力.md) |
| **5.管理能力** | 工作流、质量保障、项目管理、团队管理等 | [5.管理能力.md](5.管理能力/5.管理能力.md) |
| **6.运营能力** | 运维、GM 后台、数据分析、热更新、商业化等 | [6.运营能力.md](6.运营能力/6.运营能力.md) |

---

## 文档格式说明

### 通用结构

多数文档采用以下结构，便于快速定位信息：

| 区块 | 说明 |
|------|------|
| **是什么？在哪用？** | 概念定义、作用、应用场景 |
| **会遇到哪些问题？用什么解决？** | 常见问题及解决方向 |
| **要点和思考方向** | 关键点总结、延伸思考 |
| **更多资料** | 在线资料、视频等扩展链接 |

### 元信息

- **关键词**：便于搜索和关联
- **标签**：等级、阶段、分类、角色，用于筛选和路径推荐

### AI Coding 指南（部分文档）

部分文档（如 [1.1.1.编程语言基础概念](1.基础能力/1.1.1.编程语言基础概念.md)）包含 **AI Coding 指南**，说明如何与 AI 协作完成相关任务：

- **交互提示**：如何向 AI 描述需求
- **方法**：协作流程和注意事项
- **应用**：可交给 AI 的具体任务场景

---

## 推荐阅读路径

### 按角色

| 角色 | 推荐入口 | 说明 |
|------|----------|------|
| **游戏开发新人** | [游戏开发新人](topics/游戏开发新人.md) | 打好基础 → 岗位相关能力 → 实践 |
| **客户端开发** | [2.1.客户端技术](2.技术能力/2.1.客户端技术.md) | 图形、物理、UI、引擎、平台等 |
| **服务端开发** | [2.2.服务端技术](2.技术能力/2.2.服务端技术.md) | 网络、数据库、中间件等 |
| **技术管理** | [5.管理能力](5.管理能力/5.管理能力.md) | 工作流、质量、项目、团队 |
| **职业规划** | [游戏程序员职业发展路径](topics/游戏程序员职业发展路径.md) | 各职级能力要求与学习资源 |

### 按阶段

| 阶段 | 建议 |
|------|------|
| **学习** | 从 [1.基础能力](1.基础能力/1.基础能力.md) 开始，打好编程与计算机基础 |
| **开发** | 结合 [2.技术能力](2.技术能力/2.技术能力.md)、[3.研发能力](3.研发能力/3.研发能力.md) 按需查阅 |
| **生产** | 参考 [4.生产能力](4.生产能力/4.生产能力.md) 提升工具链与效率 |
| **管理/运营** | 查阅 [5.管理能力](5.管理能力/5.管理能力.md)、[6.运营能力](6.运营能力/6.运营能力.md) |

### 按需求

| 需求 | 推荐 |
|------|------|
| 快速了解某技术 | 直接进入对应文档，看「是什么？在哪用？」和「要点」 |
| 遇到具体问题 | 在相关文档中查找「会遇到哪些问题？用什么解决？」 |
| 系统学习某领域 | 从模块入口文档进入，按目录逐级深入 |
| 项目评估参考 | [游戏研运资产样例-SLG手游（2D）](游戏研运资产样例-SLG手游（2D）.md) |

---

## 如何配合 AI 使用

1. **用图谱指导提示词**：文档中的「是什么？在哪用？」和「要点」可帮助你向 AI 准确描述需求和约束。
2. **用图谱验证输出**：AI 生成的代码或方案，可对照「会遇到哪些问题？用什么解决？」检查是否遗漏。
3. **利用 AI Coding 指南**：有该区块的文档，可直接参考其中的交互提示、方法和应用场景。
4. **结合更多资料**：文档末尾的「更多资料」链接可交给 AI 作为上下文，或用于进一步学习。

---

## 快速导航

### 专题入口

- [游戏开发新人](topics/游戏开发新人.md)
- [游戏程序员职业发展路径](topics/游戏程序员职业发展路径.md)
- [游戏研运资产样例-SLG手游（2D）](游戏研运资产样例-SLG手游（2D）.md)

### 六大能力入口

- [1.基础能力](1.基础能力/1.基础能力.md)
- [2.技术能力](2.技术能力/2.技术能力.md)
- [3.研发能力](3.研发能力/3.研发能力.md)
- [4.生产能力](4.生产能力/4.生产能力.md)
- [5.管理能力](5.管理能力/5.管理能力.md)
- [6.运营能力](6.运营能力/6.运营能力.md)

---

> 💡 **提示**：图谱是索引和导航，不是教材。遇到需要深入的内容，请结合官方文档、书籍和实战项目学习。