et-async
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.
npx skills add FlameskyDexive/Legends-Of-Heroes --skill et-async --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# et-async - ET Async 入口 ## 何时使用 - 新增、修改或 review `async` / `await` / `ETTask` / `ETTask<T>` - 判断某段逻辑是否应该异步化，或是否应该改回同步 - 处理 `await` 后 `Entity` 访问、`EntityRef<T>`、Handler `Run` 异步安全 - 设计并发等待、`ETTask.WaitAll(...)`、`ETCancellationToken`、`NewContext(...)` ## 不要加载 - 代码完全同步，且不涉及异步边界、安全或取消控制 - 只是编译、导出、跑测试、操作 Unity / Excel ## 默认动作 1. 先判断是否真的需要异步，并明确谁在等待返回值。 2. 只有 RPC、IO、定时器、协程锁、跨 Fiber 结果或其它真实异步资源，才保留 `async` / `ETTask`。 3. 调用方不依赖返回值时，优先改成同步方法、普通消息、`Send` 或独立协程。 4. 只要存在 `await` 后继续访问 Entity 的路径，就在 `await` 前创建 `EntityRef<T>`，并在 `await` 后重新获取。 5. 函数参数可以传 Entity；字段、属性、集合中保存 `EntityRef<T>`，不要长期持有 Entity。 6. 在消费结果的协程里直接 `await`；不要设计“返回一个 `ETTask` 句柄，后面再 await”的桥接层。 7. `NewContext(...)` 只承担独立协程与取消边界；需要携带实体时使用 `EntityRef<T>`。 ## 快速分流 - `EntityRef` 正误示例、并发等待、取消控制：补读 `references/et-async-rules.md` - Handler `Run`、组件契约、包结构：叠加 `et-code` - 测试里的异步等待：叠加 `et-test-write` ## 输出要求 - 说明异步是否必要，以及谁在等待结果 - 说明 `await` 后实体访问是否通过 `EntityRef<T>` 保护 - 说明并发组织方式是否避免延后消费 `ETTask` - 说明 `ETCancellationToken` / `NewContext(...)` 是否只承担取消与协程边界职责
- 何时使用
- 不要加载
- 默认动作
- 快速分流
- 输出要求
What does the et-async skill do?
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.
How do I install it?
Run `npx skills add FlameskyDexive/Legends-Of-Heroes --skill et-async --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From FlameskyDexive/Legends-Of-Heroes, a repository with 908 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.