---

name: agents-test description: Run targeted tests using src.agents.scripts.test after code changes. Use when you need to execute only affected tests, pass a custom pytest command, or collect JSON test summaries with sub-agent fixes.

Agents Test

Overview

Use this skill to run only the affected tests and capture a JSON summary.

Quick start

Run the default test command (pytest with -q -n auto) through the sub-agent.

Copyuv run python -m src.agents.scripts.test

Targeted tests (required by repo policy)

Always pass a narrowed task.test_cmd for affected files.

Copyuv run python -m src.agents.scripts.test \
  'task.test_cmd=uv run --no-sync pytest -q -n auto tests/unit/test_affected.py'

Use a specific test case when needed.

Copyuv run python -m src.agents.scripts.test \
  'task.test_cmd=uv run --no-sync pytest -q tests/test_example.py::test_case'

Output and logs

The script prints a single-line JSON summary and stores logs under agents_workspace/sub_agents/logs/pytest_*.log.

Cache workaround

If uv cache permissions fail, use a workspace cache:

Copyuv run python -m src.agents.scripts.test \
  'task.test_cmd=uv --cache-dir agents_workspace/tmp_cache/uv_cache run --no-sync pytest -q tests/...'