test-audit · mblode — скилл для Claude Code: удаление бесполезных тестов
Скилл test-audit для Claude Code, Cursor, Codex и других агентов, который вырезает малоценные тесты из сьюта до заданной цели, сохраняя покрытие. Запускается как точечный аудит папки или кампания на весь репозиторий с числовым таргетом.
MIT 283 установок ★ 216 обновлён 2026-11-10
npx skills add mblode/agent-skills --skill test-audit -a claude-codeЧто делает test-audit
Скилл решает конкретную проблему: агенты пишут тест на каждое мелкое изменение, большинство из них просто пересказывают исходник или гоняют моки вхолостую. Покрытие при удалении почти не падает, а время прогона и стоимость поддержки растут.
Скилл различает два режима. Audit — точечный обход названных файлов или директории, результат которого — пакетное удаление с доказательствами по каждому кандидату и зелёным тестами после. Campaign — работа с целой подсистемой или репозиторием по числовому таргету: например, «убрать 20% деклараций тестов, удерживая покрытие в пределах 2 процентных пунктов от базовой линии». Таргет скилл просит задать явно или предлагает сам — и приступает, не ожидая подтверждения. Перед запуском кампании нужен тест-раннер репозитория и инструмент покрытия, который он уже поддерживает: Vitest, Jest, c8, pytest-cov, go test -cover или аналог.
За каждым кандидатом скилл читает полный тест, его продакшн-владельца, вызывающих и вызываемых, соседние реализации и историю. Удаляет пакетами по границам владельца, заодно убирая тест-only экспорты, глобалы и мёртвые ветки продакшн-кода, которые те тесты держали живыми. Финальный прогон всего сьюта с повторным замером покрытия подтверждает результат.
Какие задачи решает
- удалить тесты, которые не поймают ни одну реальную регрессию
- сократить сьют на заданный процент без потери покрытия
- убрать дублирующие вызовы одного контракта в разных провайдерах
- найти и переместить тесты, живущие не в своём owner-сьюте
- вычистить тест-only экспорты и обёртки вместе с удалёнными тестами
Примеры запросов агенту
- Удали наименее ценные 20% тестов в
src/payments, удерживая покрытие в пределах 2 процентных пунктов - Проведи аудит
tests/api/и покажи кандидатов на удаление с доказательствами по каждому - У нас слишком много тестов в
lib/slug— запусти campaign с таргетом 15% и зелёными после
Как установить test-audit
1Через Skills CLI (Vercel)
npx skills add mblode/agent-skills --skill test-audit -a claude-code2Вручную: положить файлы
~/.claude/skills/test-audit/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/test-audit/
1Через Skills CLI (Vercel)
npx skills add mblode/agent-skills --skill test-audit -a codex2Вручную: положить файлы
.agents/skills/test-audit/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mblode/agent-skills --skill test-audit -a cursor2Вручную: положить файлы
.cursor/skills/test-audit/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mblode/agent-skills skills/test-audit2Вручную: положить файлы
.github/skills/test-audit/SKILL.md1Через Skills CLI (Vercel)
npx skills add mblode/agent-skills --skill test-audit -a gemini-cli2Командой платформы
gemini skills install https://github.com/mblode/agent-skills --path skills/test-auditВручную: положить файлы
.devin/skills/test-audit/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mblode/agent-skills --skill test-audit -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о test-audit
Как установить test-audit в Claude Code?
Выполните команду npx skills add mblode/agent-skills --skill test-audit -a claude-code. Скилл появится по пути ~/.claude/skills/test-audit/SKILL.md.
Что делает скилл test-audit?
Он ищет малоценные тесты по набору паттернов — assertion-free пробы покрытия, самосравнения, дубликаты, тесты приватных вызовов — и удаляет их пакетами до заданного таргета, сохраняя покрытие. Финальный прогон подтверждает, что всё зелёное.
Какой тест-раннер нужен для работы?
Тот, что уже есть в репозитории, плюс инструмент покрытия, который он поддерживает: Vitest, Jest, c8, pytest-cov, go test -cover или аналог. Без инструмента покрытия кампания не сможет отслеживать бюджет.
Исходный текст
SKILL.md · MIT
---
name: test-audit
description: Prunes low-value tests across a whole suite to a measured target while holding coverage. Use when asked to "remove useless tests", "prune the test suite", "we have too many tests", "agents keep writing pointless tests", or "cut 20% of tests without losing coverage".
compatibility: Needs the repository's test runner and a coverage tool it already supports (Vitest, Jest, c8, pytest-cov, go test -cover, or equivalent).
---
# Test Audit
Tests earn their place by catching a credible regression that nothing else catches. Agents write a test for every small change, and most of those re-assert the source, replay a stronger test through a mock, or pin a private call shape. Coverage barely moves when they go; maintenance cost and suite time do.
- **IS:** sweeping a directory for low-value, misplaced, and skipped tests, and campaign-pruning a whole subsystem or repo to a measured target with coverage held, plus deleting the test-only production seams those tests kept alive.
- **IS NOT:** gating a test before it lands or reviewing a feature diff (`tidy`), making CI faster by splitting or sharding (`ci-speedup`), or writing tests for untested code.
## Pick a mode
| Mode | When | Done means |
|------|------|------------|
| **Audit** | A focused sweep of named files or a directory | A handful of high-confidence candidates with full evidence, deleted in one coherent batch with validation green |
| **Campaign** | A subsystem's or repo's whole test surface, or any request with a target ("remove 20%") | The target is met or the ledger shows why it cannot be, coverage held within tolerance, and the preservation review passed. Read `references/campaign.md` first |
## Set a target before starting
An open-ended "clean up the tests" stops after a few obvious deletions, because every remaining candidate looks defensible in isolation. Audit and Campaign need a number to work against. When the user gave one, use it. When they did not, propose one and proceed on it rather than waiting:
> Remove the least useful 20% of test declarations in `<scope>`, keeping line and branch coverage within 2 percentage points of the baseline and every retained test green.
Measure the baseline first (`references/coverage.md`), then keep deleting in order of lowest value until the target is met or the coverage budget is spent. Stopping short is a valid result only with a ledger showing that the remaining candidates each guard a named contract. The target is a floor on effort, not permission to cut uncertain tests: the retention bar below still wins over the number.
## Junk patterns
What an audit or campaign hunts for:
- assertion-free coverage probes, and tests whose only assertion is "does not throw" on a path that cannot throw
- self-comparisons, identity copies, and expected values produced by the helper or renderer under test
- copied fixtures, inventories, manifests, export lists, or snapshots of data the test also defines
- exact source, import, or string greps that fail on a rename and survive a real behavior change
- private predicate or call-shape tests (`toHaveBeenCalledWith` on an internal) duplicated at a real boundary
- duplicate invocations of one contract, and per-provider replays of a shared helper
- tests whose only purpose is keeping a test-only export, global, or wrapper alive, and production code whose only callers are tests
- mocks that implement the asserted behavior, or one mock standing in for several different APIs
- fixtures that supply the ordering, receipt, or callback the code under test should produce, or persistence asserted against a store the path never writes
- capability tests that restate declared flags instead of exercising what the flag promises
- negative controls that pass for an unrelated reason, such as a rejection from a different guard
- names that promise more than the assertions check: judge the test by its assertions, not its title
## Misplaced and skipped tests
Two more finding kinds. Neither is a removal candidate on that fact alone, and a move or an unskip is not a deletion toward the target.
- **Misplaced:** the test lives in one owner's suite but only exercises another's, such as a slug-format check in `routes/posts.test.ts` that never touches the route and only calls `lib/slug.ts`. Move it to the canonical owner's suite, as "Edit shape" says for retained regressions.
- **Skipped:** the test is disabled, such as `it.skip('prorates refunds on downgrade')`, `xit`, `@pytest.mark.skip`, or `t.Skip()`. Unskip it and run it first; never remove it on sight. If it passes, leave it enabled and judge it like any other test. If it fails, treat it as a possible product bug under the retention bar: reproduce it and fix the owner. A conditional skip with a real platform or environment reason is not a finding.
## Retention bar
Keep a test when it independently enforces a public API, protocol, config, migration, storage, security, platform, default value, generated cross-language, package, release, or architecture contract. Also keep:
- call ordering when the order is observable behavior
- a regression with a credible failure mode
- a source inspection when it is the cheapest independent guard: it fails when the user-facing key, byte, or path changes and survives an identifier-only rename
- a retained test that fails on the baseline: treat it as a possible product bug, reproduce it, and fix the owner rather than deleting it
Static or slow is not a reason to delete. A test that resembles implementation may still be the only proof of a contract; show otherwise before removing it.
## Evidence per candidate
Before judging, read the complete test, the production owner, its callers and callees, sibling implementations, overlapping tests, and the history that explains why the test exists. Record for each deletion:
- test name and location, and what failure it can actually detect
- non-test callers of the seam it covers
- the stronger proof that remains (name the keeper test), or why no contract exists
- the production or test-support code the deletion unlocks
- coverage delta from removing it, when measured
A missing field means the candidate is not ready. Prefer a few high-confidence deletions over a long speculative list; do not convert uncertain candidates into deletions to reach the number.
## Edit shape
Delete in coherent owner-boundary batches. With each batch, delete the test-only exports, globals, wrappers, reset hooks, and dead production paths it unlocks instead of keeping aliases. Move retained regressions to their canonical owner and fold duplicated setup into shared fixtures. Aim for net-negative production lines as well as test lines. Do not add replacement tests that restate the same implementation.
## Validation
1. Run the owner and sibling tests for each batch.
2. Where a deleted test grepped source or asserted a plan, run the script or dry-run that owns the real contract.
3. Re-measure coverage with the same command as the baseline and compare against the budget, per file.
4. Report `git diff --numstat` with production and tooling lines separate from test lines.
## Permissions
Running tests and coverage locally, and deleting tests and test-only seams in the working tree, are the task: do them without asking. Commit, push, or open a PR only when asked. A test that meets the retention bar stays; deleting one anyway is the user's call, as is changing coverage thresholds or CI gates.
## Handoff
- target, baseline, and final numbers: declarations or lines, and line and branch coverage
- removed categories and the root cause behind them (what kept producing these tests)
- production simplifications, counted separately from test lines
- retained false positives and why each stays
- validation actually run, with results
- a proposed gate for the repo's `AGENTS.md`, drawn from the patterns this audit actually found, so agents stop writing them
## Gotchas
- Line coverage survives deletions that remove the only assertion on a path, because another test still executes the lines without checking them. Where a deletion looks free on coverage, confirm a keeper asserts the behavior, or run a mutation against the owner (`references/coverage.md`).
- Aggregate coverage hides a subsystem that lost its only proof while an unrelated area gained. Compare per file for every production file the deleted tests touched.
- Ranking candidates by unique line coverage alone deletes the wrong tests: a test with zero unique lines can still hold the only assertion on them. Unique coverage makes a test a candidate; a named keeper makes it a deletion.
- Editing tests while Vitest or Jest runs in watch mode on the same checkout re-runs half-edited files, and the failures read as regressions from the deletion. Stop the watcher before a batch.
## Reference files
| File | Read when |
|------|-----------|
| `references/campaign.md` | Campaign mode, or any target-driven prune larger than one directory |
| `references/coverage.md` | Measuring the baseline, per-file and per-test coverage, the budget check, and mutation spot checks |
Maintenance only: `evals/evals.json` holds scenarios for changing this skill; it never loads during a task.
## Related skills
- `tidy`: gates a test the moment a diff adds or changes it, and reviews the rest of the diff alongside it. This skill only sweeps or campaign-prunes the existing suite; "audit these tests in my PR" routes to `tidy`, not here.
## Credit
Adapted from OpenClaw's `test-audit` skill ([openclaw/openclaw](https://github.com/openclaw/openclaw/tree/main/.agents/skills/test-audit), MIT). Provenance lives in the repository's maintenance notes.
© mblode · MIT · mblode/agent-skills
Похожие скиллы
Все скиллы по теме «Тесты и QA» →Сначала — test-audit от других авторов.