# Unity 2D Agent Coding Onboarding Resources

## Knowledge

- [Unity Manual: GameObjects](https://docs.unity3d.com/Manual/class-GameObject.html)
  Unity 官方对 GameObject 的定义。Use for: 解释“对象容器 + 组件组合”的心智模型。
- [Unity Manual: Prefabs](https://docs.unity3d.com/6000.5/Documentation/Manual/Prefabs.html)
  Unity 官方 Prefab 文档。Use for: 说明 Prefab Asset、Instance、Override、Apply / Revert 以及为什么 agent 不应大规模手写 Prefab YAML。
- [Unity Manual: The Unity Editor](https://docs.unity3d.com/Manual/UsingTheEditor.html)
  Unity 编辑器基础。Use for: 解释 Hierarchy、Project、Inspector、Scene / Game、Play Mode 和 Prefab Mode 的最低用法。
- [Unity Manual: Console window](https://docs.unity3d.com/Manual/Console.html)
  Console 官方说明。Use for: 解释红错、warning、日志和 stack trace 是 Unity 验证的第一入口。
- [Unity Scripting API: MonoBehaviour](https://docs.unity3d.com/ScriptReference/MonoBehaviour.html)
  MonoBehaviour 官方 API。Use for: 解释脚本挂载、生命周期入口和 Unity Runtime 约束。
- [Unity Manual: How Unity uses serialization](https://docs.unity3d.com/Manual/script-serialization-how-unity-uses.html)
  Unity 序列化机制。Use for: 解释 Inspector 字段、引用丢失、字段重命名风险。
- [Unity Manual: Edit mode and Play mode tests](https://docs.unity3d.com/6000.3/Documentation/Manual/test-framework/edit-mode-vs-play-mode-tests.html)
  Unity Test Framework 官方说明。Use for: 区分普通 C# 逻辑测试和 Runtime / Scene / Prefab 行为测试。
- [HappyMahjong Project Facts](./source/happymahjong-project-facts.md)
  本课程对真实项目扫描得到的事实：项目路径、Unity 版本、`AppMainScene`、`LoadDll`、StrangeIoC、当前 UI 系统、`UIEventListener` 与 `Empty Click` 点击绑定。Use for: 讲课时避免泛泛而谈。
- [HappyMahjong Docs: Project Overview](/Users/lionqu/Github/NewHappyMahjongClient/HappyMahjongClient/Docs/00-overview/project-overview.md)
  项目技术栈和三层 Context 架构。Use for: 解释 HappyMahjong 不是普通小型 Unity 项目。
- [HappyMahjong Docs: Architecture Map](/Users/lionqu/Github/NewHappyMahjongClient/HappyMahjongClient/Docs/00-overview/architecture-map.md)
  AppContext / SelectionContext / GameContext、ModuleRegistry、关键目录。Use for: StrangeIoC 和模块定位。
- [HappyMahjong Docs: Startup Flow](/Users/lionqu/Github/NewHappyMahjongClient/HappyMahjongClient/Docs/01-flows/startup-flow.md)
  Boot、DLL、资源热更、AppContext 启动流程。Use for: 解释 `AppMainScene` 之后发生什么。
- [HappyMahjong Docs: Login Flow](/Users/lionqu/Github/NewHappyMahjongClient/HappyMahjongClient/Docs/01-flows/login-flow.md)
  登录模块完整链路。Use for: 项目真实链路参考，可作为现场选功能的候选背景。
- [HappyMahjong Docs: UI System](/Users/lionqu/Github/NewHappyMahjongClient/HappyMahjongClient/Docs/02-systems/ui-system.md)
  项目 UI 系统、UIUtil、PopUpManager、点击绑定和历史兼容风险点。Use for: 纠正“看到 UIEventListener 就是 NGUI”的误解。
- [HappyMahjong Docs: Network System](/Users/lionqu/Github/NewHappyMahjongClient/HappyMahjongClient/Docs/02-systems/network-system.md)
  TSDK、协议通道、消息发送/接收入口。Use for: 后台同学理解接口接入不能绕过项目网络层。
- [HappyMahjong Docs: Code Map](/Users/lionqu/Github/NewHappyMahjongClient/HappyMahjongClient/Docs/04-ai-index/code-map.md)
  目录职责与入口类。Use for: agent 查找文件前先建立地图。
- [HappyMahjong Docs: Risky Files](/Users/lionqu/Github/NewHappyMahjongClient/HappyMahjongClient/Docs/04-ai-index/risky-files.md)
  超大文件、敏感文件、生成代码索引。Use for: diff review 和禁止项。
- [Unity Project Agent Rules.docx](../Unity%20Project%20Agent%20Rules.docx)
  本课程的内部规则来源。Use for: 团队 agent 编码规范、后台开发者迁移心智模型、安全清单。
- [Extracted source: unity-project-agent-rules.md](./source/unity-project-agent-rules.md)
  从 docx 提取的 Markdown 版本。Use for: 快速检索课程依据。
- [Feature Development Lanes](./reference/0011-feature-development-lanes.html)
  Green / Yellow / Red 车道、产品实现者、后台/全栈实现者、PR 标准。Use for: 定义非客户端成员可以开发哪些 Unity 功能。
- [Module Development Rules](./reference/0012-module-development-rules.html)
  新增模块模板、现有模块边界、跨模块架构审核。Use for: 防止非客户端成员绕过模块体系开发。
- [Visual Cheatsheets](./reference/0010-visual-cheatsheets.html)
  编辑器五区图、启动地图、StrangeIoC 链路、agent loop、diff 红绿灯。Use for: Unity 新手先建立画面。
- [Lesson 2: Unity Editor 生存指南](./lessons/0002-unity-editor-survival.html)
  Hierarchy、Project、Inspector、Console、Play Mode、Prefab Mode、Apply / Revert、`.unity` / `.prefab` / `.meta` 风险。Use for: 补齐 80/20 Unity 日常开发能力。
- [Guided mission: 第一个可自研功能](./lessons/0007-guided-happymahjong-first-task.html)
  现场选功能的 live demo 框架。Use for: 课堂现场带学员走完分级 → 验收 → 分析 → 实现 → diff 的完整 loop。
- [UI Click Binding Field Guide](./reference/0007-ui-click-binding-field-guide.html)
  UGUI、UIEventListener、Empty Click / EmptyClick 点击绑定判断表。Use for: 避免 agent 误判 UIEventListener 和 Empty Click。
- [Safe First Tasks](./reference/0008-safe-first-tasks.html)
  新手第一批任务白名单 / 黑名单。Use for: 选任务和约束范围。
- [Bad Agent Output Lab](./reference/0009-bad-agent-output-lab.html)
  反例练习。Use for: 训练新手拒绝越界输出。

## Wisdom (Communities)

- [Unity Discussions](https://discussions.unity.com/)
  Unity 官方社区。Use for: 查询版本相关坑、编辑器问题和常见 API 行为。
- [Unity Learn](https://learn.unity.com/)
  Unity 官方学习平台。Use for: 课后给希望系统学习 Unity 的同学补基础。
- 团队内部 Unity 工程师 review / office hour
  对本课程最重要的“智慧来源”。Use for: 确认项目专属 UI 框架、网络层、资源系统、测试入口和可改边界。

## Gaps

- 仍需补充 HappyMahjong 的测试命令、CI 入口和推荐本地运行参数。
- 需要补充团队内部可复制的 2D UI 小任务案例：一个成功案例、一个 agent 误改 Prefab / meta / Context binding 的失败案例。
- 需要由项目 owner 确认：新功能中 Empty Click 的命名、层级、点击穿透规则是否有团队标准模板。
- 需要补充 Prefab2Code / ScriptTemplates 的实际操作入口截图或菜单路径。