# Et Code

> ET framework C# code authoring and review workflow. Use when creating or modifying Entity, Component, System, Helper, message handlers, package dependencies, assemblies, module analyzer boundaries, C# file placement, .meta handling, ECS layering, or component contract logic in WOW/ET packages.

- Skill: `flameskydexive/et-code` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add flameskydexive/et-code`
- Raw SKILL.md: https://api.skillmd.com/api/skills/flameskydexive/et-code/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: flameskydexive (https://skillmd.com/u/flameskydexive)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/flameskydexive/et-code

---


# et-code - ET Code 入口

## 何时使用

- 新建或修改 `Entity`、`Component`、`System`、`Helper`
- 新建或修改 `MessageLocationHandler`、`MessageHandler<T>`、`MessageSessionHandler`
- 新建或移动 C# 文件，检查 `.meta`、程序集与包内落点
- 新增消息、模块、程序集或包依赖
- 处理 ECS 分层、组件存在性契约、Module analyzer、分析器报错

## 不要加载

- 只是执行测试、导出配置或操作 Excel
- 只做 Unity 编辑器操作（用 `et-unitybridge`）

## 默认动作

1. 先确认改动所在 package、程序集层级和包内 `AGENTS.md` 规则。
2. 检查代码是否位于 `Packages/cn.etetet.*`，并确认是否需要关注 `packagegit.json`、`PackageType.cs`。
3. 先判断 Entity / System 分离、Handler `Run` 规范、包依赖单向、Module analyzer、禁止 hard code 是否受影响。
4. 新增组件或判空前先确认组件存在性契约；按设计必然存在的组件不要偷偷兜底创建。
5. 涉及 `async` / `await` / `ETTask` / `EntityRef` 时，叠加 `../et-async/SKILL.md`。
6. 新建类前优先复用现有结构；默认一类一文件。
7. 严禁 AI 手工生成 `.meta` 或手工修改 `.csproj`；移动 C# 文件时必须同步移动对应 `.meta` 以保留 GUID。
8. 严禁为了注册表、缓存、映射关系随手新增静态可变字段；先确认生命周期与 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` 安全、Handler `Run` 规范
- 说明是否引入新的 analyzer 风险、静态状态风险或模块边界问题