et-code - ET Code 入口
何时使用
- 新建或修改
Entity、Component、System、Helper - 新建或修改
MessageLocationHandler、MessageHandler<T>、MessageSessionHandler - 新建或移动 C# 文件,检查
.meta、程序集与包内落点 - 新增消息、模块、程序集或包依赖
- 处理 ECS 分层、组件存在性契约、Module analyzer、分析器报错
不要加载
- 只是执行测试、导出配置或操作 Excel
- 只做 Unity 编辑器操作(用
et-unitybridge)
默认动作
- 先确认改动所在 package、程序集层级和包内
AGENTS.md规则。 - 检查代码是否位于
Packages/cn.etetet.*,并确认是否需要关注packagegit.json、PackageType.cs。 - 先判断 Entity / System 分离、Handler
Run规范、包依赖单向、Module analyzer、禁止 hard code 是否受影响。 - 新增组件或判空前先确认组件存在性契约;按设计必然存在的组件不要偷偷兜底创建。
- 涉及
async/await/ETTask/EntityRef时,叠加../et-async/SKILL.md。 - 新建类前优先复用现有结构;默认一类一文件。
- 严禁 AI 手工生成
.meta或手工修改.csproj;移动 C# 文件时必须同步移动对应.meta以保留 GUID。 - 严禁为了注册表、缓存、映射关系随手新增静态可变字段;先确认生命周期与 owner。
快速分流
- 文件、
.meta、包落点、包层级:补读references/et-code-rules.md - ECS 数据/逻辑边界、组件契约、Module analyzer:补读
references/et-code-rules.md await后 Entity 访问、EntityRef<T>、NewContext(...):叠加et-async- 编译或分析器验证:转
et-build
输出要求
- 说明代码落点、包依赖、程序集层次是否正确
- 说明是否影响
.meta、.csproj、Unity 刷新或工程文件生成 - 说明是否影响
EntityRef/await安全、HandlerRun规范 - 说明是否引入新的 analyzer 风险、静态状态风险或模块边界问题