Reference
Safe First Tasks
告诉新人第一批“可以碰什么”和“先别碰什么”。安全感来自正向路径，不只是禁令。
先判断车道
Green：产品可独立开发
- 低风险体验小改
- 复用现有 UI / 提示
- 不碰序列化资产
Yellow：后台/全栈可独立开发
- 接口 / 数据链路
- Command / Service 小逻辑
- 证据、风险、验证更完整
Red：客户端 owner 做
- 启动 / 热更
- 框架源码
- 构建 / Package
适合作为第一批 agent 任务
| 任务类型 | 为什么适合 | 必须加的限制 |
|---|---|---|
| 已有错误码 → 文案映射调整 | 范围小，容易手动验证。 | 不得新增弹窗 Prefab；沿用现有提示方式。 |
| 输入 / 状态校验 | 多在普通 C# 或 Command 内完成。 | 先找相似校验；不要改协议。 |
| 防重复点击状态 | 业务价值高，风险可控。 | 必须覆盖成功、失败、取消、关闭页面。 |
| 空数据展示逻辑 | 产品能清楚验收，后台能补边界判断。 | 不要改资源加载方式。 |
| 已有接口返回字段的容错 | 后台同学容易理解。 | 不要绕过 TSDK / 项目网络层。 |
| 已有 Toast / 提示逻辑复用 | 不需要新 UI 资源。 | 必须找现有提示 API。 |
| 生成验证清单 / 补文档 | 几乎无运行时风险。 | 必须附源码路径。 |
不适合作为第一批任务
- 新增复杂弹窗 Prefab 或重做 UI 层级。
- 修改
Assets/Scenes/AppMainScene.unity。 - 修改
Assets/Scripts/Boot/LoadDll.cs。 - 修改
Assets/Scripts/Base/StrangeIoC/框架源码。 - 大范围修改
AppContext.cs、GameContext.cs、GameUIView.cs、GameTableView.cs。 - 引入新网络层、新 DI 框架、新 UI 框架。
- 修改 Packages / ProjectSettings / 构建配置。
- 资源加载方式迁移、Addressables / AssetBundle 重构。
产品可直接开发的 Green lane
- 复用现有 Toast / 提示系统的文案和触发条件。
- 已有页面中的按钮状态、防连点、入口展示条件。
- 空状态、错误状态、异常提示。
- 不涉及新资源、不涉及新 Prefab、不涉及复杂接口的新体验规则。
后台 / 全栈可直接开发的 Yellow lane
- 已有接口回包字段容错。
- DTO → Model 转换和默认值保护。
- Command / Service 内的小流程调整。
- 沿用现有 TSDK / Util / Service 的新参数或小接口接入。
- 必须附 View → Mediator → Command → Service / Model 链路、修改边界、风险和验证结果。
给产品实现者的任务卡模板
任务：{一句话描述}
用户入口：{页面 / 按钮 / 状态}
正常验收：{成功时看到什么}
异常验收：
- 接口失败：{预期}
- 超时：{预期}
- 快速重复点击：{预期}
- 关闭页面 / 弹窗：{预期}
- 第二次打开：{预期}
禁止项：
- 不改页面布局 / Prefab
- 不改资源
- 不改主流程
- 不新增第三方依赖
需要工程确认：{不确定点}给后台 / 全栈的分析入口
先不要修改代码。
请找出这个小任务在 HappyMahjong 中最小可改范围：
- Context / View / Mediator / Command / Service / Model
- 现有相似实现
- 不应修改的文件
- 可自动测试的普通 C# 逻辑
- 必须手动验证的 Unity 行为