受众
产品同学：既是需求方，也要能独立实现低风险体验小改，例如提示、文案、空状态和校验。
后台/全栈同学：要能独立实现接口和数据链路相关的中等风险改动，例如已有通道接口接入、DTO/Model 容错、Command/Service 小逻辑和验证。
1 hour teaching site
HappyMahjong Unity Agent Onboarding
给产品和后台/全栈的一小时入门课：让非客户端成员也能在清晰边界内开发 HappyMahjong Unity 功能。
1. 这门课解决什么问题
边界
课堂主线围绕两类可自研功能：产品的低风险体验改动，以及后台/全栈的接口、数据、Command/Service 改动。两类任务都要先判断边界，再写验收、让 agent 分析、限定修改、验证并提交 PR。
只讲必要地图：AppMainScene → LoadDll → AppMainRoot → AppContext；不展开热更和框架源码。
不讲 3D、Shader、渲染、动画状态机、物理、ECS、HybridCLR 细节、StrangeIoC 源码。
核心结果
学员离开课堂后，应该明确两条自研目标：产品同学能独立完成低风险体验改动（Green lane）；后台/全栈同学能独立完成接口、数据、Command/Service 相关改动（Yellow lane）；超出边界的 Red 任务交给客户端 owner。
2. 课程地图：从需求到 PR
先按角色和风险把需求分成三类：产品可自研的低风险体验改动（Green）、后台/全栈可自研的数据/接口链路改动（Yellow）、必须客户端 owner 处理的高风险改动（Red）。Yellow 不是交给客户端写，而是要求更完整的链路证据、验证和 review 说明。
分级角色 + 风险
验收产品写场景
分析agent 给路径
实现限定文件
Diff review红旗就停
PR验证 + 风险
课堂不追求记住所有术语，只追求产品 Green 自研、后台/全栈 Yellow 自研、Red 交 owner。
3. 60 分钟课程节奏
- 0–5 min: 课程契约：不是只有客户端能改 Unity；产品 Green 自研，后台/全栈 Yellow 自研，Red 交 owner。
- 5–12 min: Green / Yellow / Red 车道：按角色和风险判断谁可以改什么。
- 12–18 min: 最低 Unity + Editor 生存：对象树、Inspector、Project、Console、Play Mode。
- 18–28 min: 2D UI + 生命周期 + 序列化：按钮、Prefab、Inspector 引用、异步关闭风险。
- 28–40 min: 现场选功能 + Live demo：产品走 Green 的验收；后台/全栈走 Yellow 的 View → Mediator → Command → Service 数据链路。
- 40–50 min: Agent analysis + implementation + 模块边界：先证明链路，再限定文件小步修改。
- 50–60 min: Console 验证 + PR / Diff lab：非客户端提交什么证据，客户端 review 什么。
4. 学习路径
1. Unity 的最低心智模型
只讲新手必须知道的“代码之外还有对象树、序列化配置和资源”。
2. Unity Editor 生存指南
掌握 Hierarchy、Project、Inspector、Console、Play Mode、Prefab Mode 和 Apply / Revert 风险。
3. 2D UI 对象模型
用 HappyMahjong 真实链路理解 Scene、UI Root、GameObject、Component、Prefab。
4. 生命周期与序列化安全
理解最容易被 agent 弄坏的两类隐性状态。
5. Agent 编码循环
把一句粗糙需求变成可控、可验证的小任务。
6. 验证、调试与 Git Diff 审查
用 Console、stack trace、测试、手动验证和 diff 红旗定义“完成”。
7. Guided mission: 第一个可自研功能
现场选一个真实功能，带学员走完分级 → 验收 → 分析 → 实现 → diff 的完整 loop。
5. 参考资料：按使用场景查
先判断能不能改
- Feature Development Lanes — 产品 Green、后台/全栈 Yellow、Red owner、PR 标准。
- Module Development Rules — 新增模块用模板，改现有模块先找边界，跨模块先审核架构影响。
- Safe First Tasks — 第一批适合做什么、不适合做什么。
Editor / Console / Prefab 安全
- Unity Editor 生存指南 — Hierarchy、Project、Inspector、Console、Play Mode、Prefab Mode、Apply / Revert 风险。
- Safe Diff Checklist —
.unity/.prefab/.meta红旗；提交前必查。 - Visual Cheatsheets — 编辑器五区图、Diff 红绿灯、Console 调试流程。
看懂项目地图
- HappyMahjong Project Map — 真实项目路径、启动场景、启动链路、UI 系统和示例链路。
- StrangeIoC Cheatsheet — View / Mediator / Command / Model / Service 的最低必要认知。
- UI Click Binding Field Guide — UIEventListener、Button.onClick、Empty Click / EmptyClick 以及点击绑定边界。
- Glossary — 课堂统一词汇。只在课堂讲最小词汇，其余课后查。
让 agent 安全工作
- Agent Prompt Cards — 产品、后台日常、架构排查三档提示词。
- Safe Diff Checklist — 提交前检查：哪些文件变了、哪些风险必须解释。
- Bad Agent Output Lab — 训练新人识别越界 agent 输出。
讲课和速查
- Facilitator Runbook — 讲师用逐分钟讲稿、提问、板书和练习安排。