// ET async and EntityRef safety workflow. Use when adding, modifying, or reviewing async/await, ETTask, generic ETTask results, ETCancellationToken, NewContext, concurrent waits, handler Run async safety, or any Entity access after await in WOW/ET code or tests.
ET build, analyzer, proto export, server startup, and publish workflow. Use when compiling WOW with dotnet build ET.sln, exporting Proto to C#, starting ET.App, publishing, or validating analyzer/build results.
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.
ET Excel MCP workflow for reading, writing, styling, transforming, and inspecting xlsx data. Use when operating Excel cells, ranges, sheets, formulas, charts, merges, batch data import/export, or editing Luban source spreadsheets before export.
ET git workflow for preparing commits and reviewing changes. Use when checking git status or diff, filtering unrelated files, staging task-scoped changes, writing Chinese commit messages, or synchronizing with remotes using rebase instead of merge.
ET Luban export workflow. Use when exporting generated C# config/data code, refreshing aggregated luban.conf, validating CodeMode outputs, or troubleshooting ET.ExcelExporter, LubanGen.ps1, table definitions, beans, enums, Defines, and Luban export failures.
ET test-driven development workflow for WOW. Use when implementing features or bug fixes through a complete loop of requirements, test plan, ATestHandler test writing, implementation, dotnet build ET.sln, targeted test execution, regression checks, and AGENTS.md rule updates.
| name | et-async |
| description | ET async and EntityRef safety workflow. Use when adding, modifying, or reviewing async/await, ETTask, generic ETTask results, ETCancellationToken, NewContext, concurrent waits, handler Run async safety, or any Entity access after await in WOW/ET code or tests. |
async / await / ETTask / ETTask<T>await 后 Entity 访问、EntityRef<T>、Handler Run 异步安全ETTask.WaitAll(...)、ETCancellationToken、NewContext(...)async / ETTask。Send 或独立协程。await 后继续访问 Entity 的路径，就在 await 前创建 EntityRef<T>，并在 await 后重新获取。EntityRef<T>，不要长期持有 Entity。await；不要设计“返回一个 ETTask 句柄，后面再 await”的桥接层。NewContext(...) 只承担独立协程与取消边界；需要携带实体时使用 EntityRef<T>。EntityRef 正误示例、并发等待、取消控制：补读 references/et-async-rules.mdRun、组件契约、包结构：叠加 et-codeet-test-writeawait 后实体访问是否通过 EntityRef<T> 保护ETTaskETCancellationToken / NewContext(...) 是否只承担取消与协程边界职责