# Et Test Write

> ET test authoring workflow for WOW. Use when writing or modifying ATestHandler tests, choosing test package placement, naming test classes, creating test-only model types, preparing deterministic coroutine-style assertions, handling ObjectWait, constructing test config data, and enforcing EntityRef safety in tests.

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

---


# et-test-write - 测试编写入口

## 何时使用

- 编写新的 `ATestHandler` 测试用例。
- 修改现有测试用例。
- 补 `Test.md` 或最小验证清单。

## 不要加载

- 只是执行测试或查看日志：用 `et-test-run`。
- 只是做完整 TDD 流程编排：用 `et-tdd`。

## 落点与命名

1. 测试优先放在被测功能自己的 package 内：`Packages/cn.etetet.{被测包}/Scripts/Hotfix/Test/`。
2. 测试专用的数据结构、Entity、Component、BT 节点或辅助模型类型必须放在被测包的 `Scripts/Model/Test/`。
3. `Scripts/Model/Share/` 只放运行时或配置编译需要的公共模型，不放只为测试声明的类型。
4. `Scripts/Hotfix/Test/` 只放测试入口和测试流程代码，不放测试专用模型数据结构。
5. `cn.etetet.test` 只承载测试框架、公共测试基础设施，以及测试 test 包自身代码的测试；功能包测试和跨包集成测试不要临时放到 test 包。
6. 跨包集成测试必须放到拥有该集成场景的业务包；若确实是多业务编排，放到发起该编排的更高层业务包。
7. 类名遵守 `{PackageType}_{TestName}_Test`，并与所在包 `PackageType` 常量匹配。
8. 移动测试专用 C# 文件时同步移动 `.meta`，并通过 UnityBridge `RegenProject` 或项目既有流程刷新工程引用。

## 编写规则

1. 测试必须是协程式、逻辑确定的验证：按真实时序 `await` 消费事件、消息返回或明确完成信号。
2. 禁止用固定时间等待、sleep、轮询、`WaitMatch` 或无序过滤来等待状态出现。
3. ObjectWait 必须按真实时序逐个消费事件；事件桥接器只做转发，不写业务过滤。
4. 含 `await` 的测试必须在 `await` 后通过 `EntityRef` 重新获取 Entity。
5. 测试需要的 Config 数据必须由测试自己用代码构造，不要修改已有 Excel、配置文件或导出的配置代码。
6. 成功返回 `ErrorCode.ERR_Success`；失败直接返回唯一数字错误码，不污染正式 `ErrorCode.cs`。
7. 测试失败用 `Log.Console`，普通信息用 `Log.Debug`，日志统一英文。

## 常见错误

- 把功能包自己的测试或跨包集成测试写到 `cn.etetet.test`。
- 把测试专用数据结构、Entity、Component、BT 节点或辅助模型类型放到 `Scripts/Model/Share/` 或 `Scripts/Hotfix/Test/`。
- 测试类名前缀与所在包 `PackageType` 不一致。
- `await` 后直接访问旧 Entity。
- 不同失败分支返回相同错误码。
- 用 `Log.Error` 代替 `Log.Console`。
- 修改已有配置文件、Excel 表或导出的配置代码准备测试数据。
- 使用固定时间等待某种状态出现。
- 使用睡眠轮询、`WaitMatch` 或无序过滤跳过事件。
- 在正式包 `ErrorCode.cs` 里定义测试专用错误码。