mc-testkitlisted
Install: claude install-skill wcpe/mc-testkit-skill
# mc-testkit E2E 对接
mc-testkit 的形态是:Gradle 编排插件 `top.wcpe.mc-testkit` 负责起真实后端/代理并读结果文件;Kotlin harness 桩负责驱动和判 PASS/FAIL;mineflayer bot 只模拟玩家操作。
## 先确认模板来源
从零接入、初始化或重新同步 `template/` 前,必须先停下来问用户选择模板来源,禁止默认选择:
- **内置模板快照**:使用本技能 `assets/mc-testkit-template-v0.6.0.zip`,来源为 `wcpe/mc-testkit` 版本 `0.6.0`、提交 `43fae4cb420a1201510cc00bf3033b9160974175`。优点是离线、可复现;缺点是可能落后上游。
- **GitHub 实时拉取**:从 `https://github.com/wcpe/mc-testkit` 的指定 tag/branch/commit sparse-checkout `template/`。优点是能对齐用户指定版本;缺点是依赖网络和上游可用性。
用户未明确选择时,只提问,不执行复制。用户选择后,定位本技能目录(包含本 `SKILL.md`),再运行:
```bash
node scripts/resolve-template.mjs --source embedded --destination e2e
node scripts/resolve-template.mjs --source github --version 0.6.0 --destination e2e
```
目标目录已存在时必须再次确认;确认可覆盖后才加 `--force`。
## 三条铁律
1. 一个场景 id 必须在 DSL、harness、bot 三处完全一致,例如 `buy-success`。
2. PASS/FAIL 永远由 harness 写结果文件决定;bot 不判定,verify 不看日志猜结果。
3. 冻结契约名不改:`MC_TESTKIT_E2E_`、`E2E_READY`、`E2E_STRESS_RESULT`、`E2E_DISCONNECT_NOW`、`E2E_UI_TOKEN`、`status`、`message`、`__mc_testkit_serve__`。
## 路由
按用户意图只读需要的 reference:
| 用户意图 | 先读 | 关键产出 |
|---|---|---|
| 从零接入 | `references/scaffolding-and-integration.md` | maven 插件仓库、`mcTestkit {}`、模板来源确认、harness/bot 接线、`e2eSmoke` |
| 写普通场景 | `references/authoring-scenarios.md` | 三处登记、真实业务判定、`e2e<Key>WithBot` |
| 集群或压测 | `references/authoring-scenarios.md` + `references/dsl-tasks-and-env.md` | `backends(...)`、`via`、`stress {}`、任务名 |
| serve 持久手测 | `references/authoring-scenarios.md` §serve + `references/dsl-tasks-and-en