К основному содержанию
скилл CX Codex

dart-test-coverage — скилл для Claude Code: покрытие Dart-тестами

Скилл dart-test-coverage для Claude Code запускает сбор покрытия Dart-пакета, разбирает пропущенные строки и помогает наметить тесты. Помогает выявить непроверенный код в lib/.

Apache-2.0 163 установок ★ 149 обновлён 2026-10-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add kevmoo/dash_skills --skill dart-test-coverage -a claude-code
Открыть на GitHub

Что делает dart-test-coverage

Сначала скилл предлагает убедиться, что dart test проходит, затем собрать данные командой dart test --coverage=.dart_tool/coverage. Результаты можно разобрать скриптом interpret_coverage.dart или инструментом coverage:format_coverage; скрипт показывает процент и пропущенные строки. Для ветвлений доступен флаг --branch-coverage.

При разборе он связывает номера строк с функциями и блоками кода и предлагает конкретные тесты. Покрытие стоит собирать только после успешного запуска тестов: если они падают, сначала нужно исправить их. Скилл рекомендует сосредоточиться на файлах lib/, а не на сгенерированном коде, тестах или скриптах обслуживания; каталог .dart_tool/coverage не следует коммитить.

Какие задачи решает

  • собрать покрытие Dart-пакета
  • найти файлы и строки без тестов
  • разобрать процент покрытия через LCOV-данные
  • понять, какие функции требуют новых тестов
  • подготовить тесты для пропущенных веток кода

Примеры запросов агенту

  • Проверь тесты Dart-пакета, собери покрытие и найди пропущенные строки.
  • Разбери покрытие в .dart_tool/coverage для пакета из pubspec.yaml.
  • Проверь покрытие ветвлений и предложи тесты для непроверенных функций в lib/.

Как установить dart-test-coverage

1Через Skills CLI (Vercel)

npx skills add kevmoo/dash_skills --skill dart-test-coverage -a claude-code

2Вручную: положить файлы

~/.claude/skills/dart-test-coverage/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/dart-test-coverage/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о dart-test-coverage

Как установить dart-test-coverage в Claude Code?

Выполните npx skills add kevmoo/dash_skills --skill dart-test-coverage -a claude-code. Файл скилла находится в ~/.claude/skills/dart-test-coverage/SKILL.md.

Что делает dart-test-coverage?

Скилл помогает запустить сбор покрытия Dart-тестов, найти пропущенные строки и определить, какие части библиотеки стоит покрыть тестами.

Нужно ли сначала запускать тесты?

Да. Сначала запустите dart test и устраните ошибки, если тесты падают; только после этого собирайте покрытие.

Исходный текст

SKILL.md · Apache-2.0
---
name: dart-test-coverage
description: |-
  Understand and improve test coverage in a Dart package.
  Helps agents run coverage, interpret results, and identify missed lines.
key_features:
  - LCOV report collection
  - Missed line identification
  - Coverage analysis & improvement
---

# Dart Test Coverage

Guidelines for running and interpreting test coverage in Dart packages.

## When to use this skill

- When asked to "check test coverage" or "improve coverage".
- When you need to identify which parts of a library are untested.

### When NOT to use (Abstention Guardrails)

Do NOT collect or demand test coverage for:

- **Generated Code**: Code generated by builders (`*.g.dart`, `*.freezed.dart`,
  protobufs).
- **Platform-Specific FFI / OS Entrypoints**: Low-level platform bindings or
  entrypoints that require specific physical hardware or OS services not
  available in the execution environment.
- **Example Applications & Tool Scripts**: Standalone sample code under
  `example/` or developer maintenance scripts under `tool/` unless the package
  explicitly mandates 100% repository-wide coverage.
- **Failing Test Suites**: If existing tests are failing under `dart test`, fix
  the broken tests first before collecting or reporting coverage.

## Discovery

To find areas lacking test coverage:

### Run Coverage Analysis

Follow the workflow to generate and interpret coverage data:

1. **Run Tests with Coverage**: `dart test --coverage=.dart_tool/coverage`
2. **Interpret Results**: Use the script or `format_coverage` as described in
   the **Interpreting Results** section to identify specific files and missed
   lines.

## How to use this skill (The Workflow)

1.  Ensure tests pass by running `dart test`.
2.  Collect coverage by running `dart test --coverage=.dart_tool/coverage`.
3.  Interpret the results using the provided script or standard tools.
4.  Add tests to cover missed lines.

## Running Coverage

Run the following command to collect coverage in JSON format:

```bash
dart test --coverage=.dart_tool/coverage
```

> [!NOTE] We use `.dart_tool/coverage` as the output directory because
> `.dart_tool` is typically already ignored in `.gitignore` files.

> [!TIP] For projects with complex conditional logic, you can pass the
> `--branch-coverage` flag to `dart test` to collect branch-level coverage.

## Interpreting Results

### Option 1: Use the custom interpreter script

This repository includes a zero-dependency script that parses the raw JSON
output and provides a summary of covered percentage and missed lines.

Run it from the project root (adjust path to script as needed):

```bash
dart run skills/dart-test-coverage/scripts/interpret_coverage.dart .dart_tool/coverage <package_name>
```

Replace `<package_name>` with the name from `pubspec.yaml`.

Example Output:

```
package:my_pkg/src/file.dart: 50.0% (2/4 lines)
  Missed lines: 3, 4
```

### Option 2: Use package:coverage

If `package:test` is installed, `package:coverage` is likely available as a
transitive dependency. You can use its `format_coverage` tool.

To get a human-readable "pretty print" of the coverage:

```bash
dart run coverage:format_coverage --in=.dart_tool/coverage --out=stdout --pretty-print --report-on=lib
```

This will output the file content with hit counts on the left (e.g., `0|` for
missed lines).

## Best Practices for Reporting Results

When presenting coverage results to the user, follow these guidelines:

1.  **State the high-level percentage first** to give immediate context.
2.  **Identify specific files and missed lines** clearly.
3.  **Translate line numbers to code**: Don't just say "lines 3-6 are missed".
    Look at the source file and tell the user which functions or blocks are
    untested (e.g., "The `divide` function is missing coverage").
4.  **Propose concrete fixes**: Provide example test code that the user can
    immediately apply to cover the missed lines.
5.  **Use tables for multi-file summaries**: When reporting on multiple files,
    use a markdown table with columns for File, Coverage %, and Missed Lines to
    make the summary easy to scan.

## Constraints

- ALWAYS verify that tests pass before collecting coverage.
- DO NOT commit the `.dart_tool/coverage` directory.
- Focus coverage improvements on `lib/` files, not `test/` or generated files.

© kevmoo · Apache-2.0 · kevmoo/dash_skills

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
dart-collect-coverage dart-lang Скилл dart-collect-coverage настраивает сбор тестового покрытия в проектах на Dart и Flutter через пакет coverage и генерирует отчёт в формате LCOV. Помогает отслеживать метрики тестов. CX Codex +1 20 400установок test-coverage-mcp goldbergyoni MCP-сервер test-coverage-mcp даёт агенту доступ к данным покрытия из LCOV-файлов: он видит, улучшил или ухудшил тесты, не разбирая многомегабайтные отчёты. CX Codex +1 ★ 42звёзд репо Python Unit Test Generator — Comprehensive, Coverage-Mapped & Production-Ready sivasaiyadav8143 Промпт Python Unit Test Generator — Comprehensive, Coverage-Mapped & Production-Ready превращает фрагмент Python-кода в набор тестов pytest с картой покрытия и моками внешних зависимостей. GP ChatGPT ★ 178 201звёзд репо bun-test-coverage secondsky Скилл bun-test-coverage для Claude Code, Codex, Cursor и других платформ запускает тесты Bun с флагом --coverage и настраивает пороги, репортеры и CI-интеграцию. Генерирует lcov-отчёт для загрузки в Codecov прямо из GitHub Actions. CX Codex +1 424установок dart-add-unit-test dart-lang Скилл dart-add-unit-test для Claude Code, Codex и других агентов пишет и организует юнит-тесты на package:test. Включается при добавлении логики или исправлении багов, чтобы избежать регрессий. CX Codex +1 21 400установок test-coverage NeoLabHQ Скилл test-coverage помогает оценить, что именно проверяют уже написанные тесты: код, мутации, требования и API. Пригодится после создания тестового набора. CX Codex +1 683установок

Из того же набора9

dart-best-practices Скилл dart-best-practices задаёт правила оформления кода на Dart при генерации и ревью. Помогает форматировать многострочные блоки и соблюдать лимит длины строки в 80 знаков. CX Codex +1 847установок dart-test-fundamentals Скилл dart-test-fundamentals для Claude Code и Codex задаёт стандарты работы с библиотекой package:test в Dart. Инструмент следит за структурой тестов, вызовами setUp и очисткой ресурсов через addTearDown. CX Codex +1 455установок dart-modern-features Скилл dart-modern-features обучает агента современному синтаксису Dart версий 3.0–3.10. Он помогает безопасно внедрять записи, extension types и модификаторы классов при рефакторинге. CX Codex +1 370установок dart-doc-validation Скилл dart-doc-validation учит агента проверять комментарии документации в Dart-коде командой dart doc и включать линт comment_references, чтобы ловить битые ссылки на классы, методы и макросы. CX Codex +1 291установок dart-package-maintenance Скилл dart-package-maintenance для Claude Code помогает вести Dart-пакеты: следить за версиями, синхронизировать CHANGELOG и управлять релизами. Описывает поддержку пакетов на pub.dev. CX Codex +1 285установок dart-matcher-best-practices Скилл dart-matcher-best-practices для Claude Code помогает писать проверки Dart через expect и package:matcher. Он подключается при создании тестов, разборе сбоев и замене ручных проверок. CX Codex +1 269установок dart-long-lines Скилл dart-long-lines для Claude Code помогает соблюдать лимит в 80 символов в строках Dart. Он подключается при написании и рефакторинге кода под lint lines_longer_than_80_chars. CX Codex +1 150установок dart-multiline-strings Скилл dart-multiline-strings для Claude Code учит переписывать цепочки print() и конкатенации в тройные кавычки. Запускается при рефакторинге CLI-вывода, шаблонных сообщений и многострочных блоков в Dart. CX Codex +1 116установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой