test-runner
Run the relevant tests for the current change and summarize results. Use in Flow 3 (Build) and optionally in Flow 4 (Gate).
When & Why to Use This Skill
The Test Runner skill is a specialized automation tool designed to streamline the software testing lifecycle, particularly within Rust-based environments. By intelligently identifying code changes via Git and executing targeted test suites using Cargo, it minimizes feedback loops and ensures code reliability. It automatically generates detailed test summaries and logs, making it an essential component for maintaining high-quality standards in both local development and automated CI/CD pipelines.
Use Cases
- Automated PR Validation: Automatically detect modified files in a pull request and run only the relevant tests to provide fast feedback to developers.
- CI/CD Build Integration: Incorporate into build pipelines (Flow 3) to execute workspace-wide tests and capture standardized logs for audit trails.
- Quality Gate Enforcement: Act as a deployment gate (Flow 4) by summarizing test results and preventing the promotion of code with failing test cases.
- Efficient Local Debugging: Assist developers in running scoped tests for specific crates or modules during the debugging process to save time and resources.
| name | test-runner |
|---|---|
| description | Run the relevant tests for the current change and summarize results. Use in Flow 3 (Build) and optionally in Flow 4 (Gate). |
| allowed-tools | Bash, Read, Write |
Test Runner Skill
You are a helper for running tests efficiently in this repository (Rust-focused).
Behavior
Prefer scoped test runs:
- Use
git diff --name-only origin/main...HEADto list changed files when available. - If the caller provides a list of affected modules/files, attempt to run targeted tests first.
- Use
Concrete commands for this repo (Rust):
- Scoped run (preferred):
cargo test -p <crate> -- <test-name-pattern>orcargo test --test <name>when a crate/test target is known.
- Fallback / full run:
cargo test --workspace --tests --color=always
- Scoped run (preferred):
Runtime flags and speed:
- Prefer to keep runs bounded; if the full suite is required, note this in the summary.
Capture output and artifacts:
- Save raw output to
test_output.log(overwrite per run) and a parsed summary totest_summary.md. test_summary.mdshould include: overall status (PASS/FAIL), failing test names, and top error snippets.
- Save raw output to
Failure handling:
- Exit status is used by calling subagent; include failing test names in
test_summary.md.
- Exit status is used by calling subagent; include failing test names in
Do not modify source or tests.
When used in Flow 3 / Flow 4, callers should provide the scope (files/modules/tests) if known.