菜单
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.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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.
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.
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.
| name | test-package |
| description | 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. |
Loading Bash Secrets for Roblox API keys:
bash / git-bash: set -a && source .ci/secrets.env && set +a
The test runner IS the coverage tool. Always run from the repo root:
lune run coverage.luau package=<name> # e.g. package=tablemanager
lune run coverage.luau package=all # every lib/ package with specs
lune run coverage.luau package=last # reads test/last_tested_package.txt
<name> is a directory name under lib/. tests.luau no longer exists — do
not try to run it. To test the coverage tool's own Lune core:
lune run coverage.luau package=self --adapter=./tools/coverage/lune/adapters/coverage_self
If requires/types are broken on a fresh checkout, run npm run setup first
(installs wally deps, generates sourcemap + package types — all gitignored).
--per-file — per-file line-coverage breakdown (worst first).--per-test — per-test hit attribution (Lune pipeline only).--recommend — ranked list of concrete next steps; best flag when the goal
is "improve this package's tests".--mutate — mutation testing (Lune pipeline only; slow). --mutate-limit=<n> caps it.--json — print merged coverage.json to stdout.--timeout=<sec> — tiniest watchdog override for hanging suites.--rebuild-engine — force cargo build --release of the Rust engine.The adapter picks the pipeline automatically per package:
game,
Instance.new, ...) or contain const — Lune 0.10.4 cannot parse const.
This is expected behavior, not a hang; give it time or check the printed
pipeline reason. The transport is either local Studio via run-in-roblox
(one Studio launch) or headless Open Cloud (for CI, no Studio) — select
with --roblox-runner=studio|opencloud. Default: opencloud when
ROBLOX_API_KEY is set (plus ROBLOX_UNIVERSE_ID/ROBLOX_PLACE_ID), else
studio.For a coverage-free "do the specs pass on real Roblox?" run (all packages, one
Open Cloud task), use lune run tools/ci/run_tests.luau.
Console report ranks gaps (uncovered functions, one-sided decisions,
never-varied conditions). Artifacts land in .coverage/<package>/
(coverage.json, map.json, hits.json, instrumented build/) — all
gitignored. Full system docs: tools/coverage/README.md.