Reference
Feature Development Lanes
这页定义团队共识：产品和后台不是只能提需求或看代码，他们可以在明确车道内开发 HappyMahjong Unity 功能。
三条开发车道
Green lane：产品可独立开发
- 同模块 1–4 个 C# 文件
- 文案、提示、校验、状态保护
- 复用现有 UI / Toast / PopUp
- 不改 Prefab / Scene / Packages
Yellow lane：后台/全栈可独立开发
- 新增模块但使用项目模板
- 新增 Command / Context binding
- 新增 Inspector 字段
- 小范围 UI 层级或 Prefab 配置
- 新接口接入但沿用项目网络层
- 必须提交链路证据、风险说明和验证结果
Red lane：客户端 owner 做
- 启动 / 热更 / LoadDll
- StrangeIoC 框架源码
- 大规模 Scene / Prefab 重构
- Packages / ProjectSettings / 构建
- 不使用模板从零手写模块骨架
- 未经审核的跨模块直接引用
产品作为实现者
产品不是只写需求。产品可以在 Green lane 内直接开发偏体验和规则的小功能。
| 产品可做 | 例子 | 必须满足 |
|---|---|---|
| 文案和提示逻辑 | 某个操作未满足条件时显示现有提示。 | 复用现有提示系统，不新增 UI 资源。 |
| 体验规则 | 按钮防重复点击、失败后恢复按钮。 | 验收覆盖连点、失败、关闭页面。 |
| 空状态 / 异常状态 | 列表为空显示已有空状态。 | 不改 Prefab 布局；先找现有空状态实现。 |
| 配置和开关使用 | 某活动入口是否展示。 | 沿用现有配置读取，不新增配置系统。 |
后台 / 全栈作为实现者
后台和全栈同学的目标不是只做 Green lane；他们应能独立完成 Yellow lane 中的数据、接口、DTO、状态流转、容错和验证，但必须给出链路证据、边界、风险和验证结果。
| 后台 / 全栈可做 | 例子 | 必须满足 |
|---|---|---|
| 接口接入 | 接一个已有通道的新回包字段。 | 沿用 TSDK / Util / Service，不写新 HttpClient。 |
| DTO → Model 容错 | 空数组、未知枚举、缺字段处理。 | 不破坏旧客户端兼容。 |
| Command / Service 流程 | 请求中禁用按钮，回包后恢复。 | 覆盖成功、失败、超时、取消。 |
| 日志和验证清单 | 关键失败路径打已有风格日志。 | 不泄露 token、openid、手机号等敏感信息。 |
从需求到 PR 的统一流程
1. 分级Green / Yellow / Red
2. 验收产品写场景
3. 分析agent 输出路径
4. 边界Yellow 证据更全
5. 实现限定文件
6. Diff红旗停止
7. PR验证 + 风险
模块边界规则
- 新增模块：必须先选
Assets/Editor/Prefab2Code/Scripts/ScriptTemplates/下的模板。 - 改现有模块：先定位模块目录、Context、View / Mediator / Command / Service / Model。
- 模块内能完成的，不跨模块。
- 跨模块修改必须说明原因、影响、替代方案，并找客户端 owner 审核。
Definition of Ready
- 任务已分级：Green / Yellow / Red。
- 用户入口和验收场景清楚。
- agent 已输出文件路径和功能链路。
- 如果是新增模块，已确认模板选择。
- 如果是改现有模块，已确认模块边界。
- 如果是跨模块修改，已完成架构影响审核。
- 允许修改文件和禁止修改文件已写明。
- Yellow lane 已写清链路证据、修改边界、验证计划和需要客户端 review 的点。
PR 必须包含
- 改了哪些文件，为什么是最小范围。
- 属于 Green / Yellow / Red 哪条车道。
- 正常流程和异常流程验证结果。
- 是否触碰 Prefab / Scene / Context / ProjectSettings / Packages。
- 如果新增模块，使用了哪个 ScriptTemplates 模板。
- 如果改现有模块，模块边界是什么。
- 如果跨模块，审核了哪些架构影响。
- 未验证的平台和风险。
- 如果使用 agent，附 agent analysis 摘要或关键结论。
团队目标： 非客户端成员不是绕过客户端工程，而是在清晰车道内扩大 Unity 工程吞吐。产品 Green lane 自助，后台/全栈 Yellow lane 自助，Red lane 交给 owner；Yellow 的差别是证据和 review 要更完整。