run-unit-tests - SKILL.md Agent Skill

name: run-unit-tests description: Build and run dxvk-remix unit tests. Use when the user asks to run tests, add new tests, or verify that code changes pass existing tests.

Run Unit Tests

All commands run in PowerShell from the repo root.

Unit tests live in tests/rtx/unit/. New test files must be added to tests/rtx/unit/meson.build.

IMPORTANT: Unit tests use a separate dedicated build directory (_Comp64UnitTest) with special build flags. Do NOT run unit tests from game build directories (_Comp64DebugOptimized, _Comp64Release, etc.) — they will fail.

First-Time Setup

Build the unit test configuration:

.\build_dxvk.ps1 -BuildFlavour release -BuildSubDir _Comp64UnitTest -Backend ninja -EnableTracy false -BuildTarget unit_tests -InstallTags unit

Running Tests

Once _Comp64UnitTest exists:

cd _Comp64UnitTest
meson test --verbose          # run all tests
meson test --verbose <name>   # run a specific test

Incremental Rebuild and Retest

If test source files have changed, rebuild before running:

cd _Comp64UnitTest; meson compile -v; meson test --verbose <name>

Test Guidelines

Minimal dependencies. Refactor tested code if needed to reduce coupling.
Full branch coverage with carefully designed test data.
Return 0 on success, -1 on failure.
Include descriptive logging on failure.

If the above steps don't work, check tools/ci/gitlab/unit_test.yml for the latest commands.