菜单
Work on the coverage system itself under tools/coverage (Rust full_moon engine or Lune orchestrator). Use when modifying instrumentation, probes, mutation testing, the report, adapters, or when golden tests fail. Covers building, testing, golden regeneration, and layout boundaries.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | coverage-engine |
| description | Work on the coverage system itself under tools/coverage (Rust full_moon engine or Lune orchestrator). Use when modifying instrumentation, probes, mutation testing, the report, adapters, or when golden tests fail. Covers building, testing, golden regeneration, and layout boundaries. |
Read tools/coverage/README.md first — it is the authoritative architecture
doc (probe model, sentinel protocol, mutation semantics).
engine/ (Rust) and lune/core/ are repo-agnostic: nothing there may
hardcode lib/, _Index, or .spec.luau. Layout knowledge lives only in
lune/adapters/modules_on_rails.luau (this repo) behind the RepoAdapter
interface in lune/adapter.luau.cd tools/coverage/engine && cargo build --release # or --rebuild-engine on a run
cd tools/coverage/engine && cargo test # unit + CLI + golden tests
lune run coverage.luau package=self --adapter=./tools/coverage/lune/adapters/coverage_self # Lune core specs (from repo root)
Build/test release, not dev: full_moon recurses deeply and can overflow
the stack in the dev profile.
engine/tests/golden/ pins exact map.json + instrumented output for
engine/tests/fixtures/simple_pkg. Any intentional change to probe collection,
id allocation, site keys, or splicing requires regeneration + diff review:
$env:UPDATE_GOLDEN = "1"; cargo test --test golden; Remove-Item Env:UPDATE_GOLDEN
git diff tests/golden/
Fixtures and goldens are pinned to LF via .gitattributes — never reformat
or re-encode anything under engine/tests/fixtures/ or golden/.
const; that's why const-using packages route to
the Studio pipeline. Don't add const to lune/ sources.[[TM-COV ...]] lines in the adapter's runner template) — base64 is
load-bearing (UTF-8 byte-slicing hazard), don't "simplify" it.lune/mutant_run.luau);
a stop file .coverage/<pkg>/mutation.stop ends a run early keeping partials.Create a new Wally package under lib/ in this repo. Use when asked to scaffold, add, or create a new package/module/library. Covers the scaffold script, the pure-Luau vs datamodel entry-point decision, and post-scaffold registration steps.
Publish or version-bump a Wally package in this repo. Use when asked to publish, release, or bump a package version. Covers the publish script's non-interactive flags, the auto-generated init.luau, and CI workflow actions.
Run tests and coverage for a package in this repo. Use when asked to run tests, check coverage, run the test suite, or verify a package's specs pass. Covers command forms, flags, pipeline selection (Lune vs Roblox Studio), and reading the output.
Write or edit documentation in this repo — moonwave API docs, doc comments, or guide pages. Use when asked to document an API, add a guide, fix docs, or preview the docs site. Covers moonwave comment forms, guide-file conventions, classOrder registration, and previewing.
Write or modify tiniest test specs (.spec.luau) in this repo. Use when adding tests, fixing failing tests, or improving coverage for a package. Covers spec structure, the expect matcher API, snapshots, Roblox class shims, and the FakeIntermediary bridge for replicator tests.