菜单
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.
用 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.
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.
| name | write-specs |
| description | 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. |
Specs are *.spec.luau files inside the package's src/ tree (convention:
src/Tests/). A spec returns a function receiving the tiniest object:
return function(tiniest)
local describe = tiniest.describe
local test = tiniest.test
local expect = tiniest.expect
describe("MyModule", function()
test("does the thing", function()
expect(result).is(5)
end)
end)
end
Reference examples: test/tiniest/Examples/. Existing strong suites:
lib/tablemanager/src/Tests/, lib/tablereplicator/src/Tests/.
Run with lune run coverage.luau package=<name> (see the test-package skill).
Full documented list at the top of test/tiniest/tiniest_expect.luau. Matchers
chain (expect(x).exists().is_a("number")). Commonly misremembered:
.is_false() → use .never_is_true() (value must be boolean)..throws() → use .fails(), .fails_with(message)
(case-insensitive substring), .never_fails().never_ prefix: .never_is(b), .never_exists(),
.never_has_key(k), .never_has_value(v), .never_is_a(t)..prints(pattern?), .warns(...), .errors(...),
.outputs(spec) and their never_ forms — these take a function.Use tiniest.context to attach labeled state to a test; it prints only on
failure. Prefer attaching 3+ distinct pieces of info over rerunning with prints.
game, no Roblox globals.
Vector2/Vector3 come from test/RobloxClassShims/ (wired via .luaurc).const or a datamodel global to a spec/source moves the whole package
to the slow Roblox Studio pipeline — avoid in tests unless required.test/tiniest/tiniest_snapshot.luau, stored in test/__snapshots__/.lib/tablereplicator/src/Tests/Helpers/FakeIntermediary.luau (+ FakeManager,
SpecUtils); pattern in TR.EndToEnd.spec.luau. No real networking needed.test/testez/ and testez.toml are legacy.