← ClaudeAtlas

mc-testkitlisted

Use when an AI assistant (Codex / Claude Code / any platform supporting this skill layout) needs to add, author, run, or debug mc-testkit E2E/serve workflows for Bukkit/Paper/Folia plugin projects: apply top.wcpe.mc-testkit, confirm template source, wire mcTestkit DSL (backend/proxy/scenario/dependencies/serve, cluster/stress/multi-bot, node runtime injection, multi-version backends), harness, mineflayer bot, result-file PASS/FAIL, and troubleshooting.
wcpe/mc-testkit-skill · ★ 1 · AI & Automation · score 72
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