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

testing · evanca — скилл для Claude Code: тесты Flutter/Dart и установка

Скилл testing помогает писать и проверять unit- и widget-тесты для Flutter и Dart, разбирать flaky-тесты и выбирать подходящий тип проверки.

MIT ★ 674 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules
Открыть на GitHub

Что делает testing

Скилл направляет агента при написании и ревью тестов для бизнес-логики, репозиториев, виджетов и cubit/bloc. Он предлагает проверять, способен ли тест поймать регрессию, и не ограничиваться подтверждением поведения мока. Такой тест не проверяет реальную логику — он может пропустить поломку.

Для unit-тестов описаны test, bloc_test и mocktail, для интерфейса — flutter_test и WidgetTester. Скилл рекомендует оборачивать виджеты в MaterialApp, использовать pump() или pumpAndSettle() по ситуации и выбирать find.byKey, когда текст меняется. В тестах предлагается группировать проверки по классу и повторять структуру lib/ в каталоге test/.

Для моков указан mocktail; пользовательские типы для any() нужно регистрировать через registerFallbackValue(). В Claude Code скилл можно установить через маркетплейс или npx skills.

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

  • написать unit-тест для бизнес-логики или репозитория
  • проверить отображение и взаимодействие с виджетом
  • найти тесты, которые проверяют только поведение мока
  • разобраться с нестабильным тестом
  • выбрать между unit- и widget-тестом

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

  • Напиши unit-тесты для бизнес-логики в этом файле и проверь, что они ловят регрессии.
  • Проверь widget-тест экрана входа: добавь проверку сообщения об ошибке.
  • Разбери нестабильные тесты и предложи, где нужны unit-тесты, а где widget-тесты.

Как установить testing

1Через маркетплейс плагинов

/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules

Команда ставит плагин flutter-ai-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add evanca/flutter-ai-rules --skill testing -a claude-code

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

~/.claude/skills/testing/SKILL.md

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

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

Вопросы о testing

Как установить testing в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add evanca/flutter-ai-rules, затем установите скилл: /plugin install flutter-ai-skills@flutter-ai-rules.

Что делает скилл testing?

Он помогает писать и проверять тесты Flutter и Dart, выбирать между unit- и widget-проверками и разбирать flaky-тесты. Также задаёт структуру тестовых файлов и правила для моков.

Когда использовать unit-тесты, а когда widget-тесты?

Для бизнес-логики скилл рекомендует unit-тесты. Widget-тесты нужны для проверки отображения, жестов и взаимодействия с виджетами.

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

SKILL.md · MIT
---
name: testing
description: "Use when writing or reviewing Flutter/Dart tests (unit, widget, golden), fixing flaky tests, adding coverage, or choosing between unit and widget tests."
license: MIT
---

# Testing Skill

Write effective, meaningful Flutter and Dart tests that catch real regressions.

## When to Use

Use this skill when:

* Writing unit tests for business logic, repositories, or utility classes.
* Writing widget tests for UI components.
* Reviewing existing tests for correctness and coverage.
* Fixing flaky or false-positive tests.
* Deciding between unit tests, widget tests, and integration tests.

---

## 1. Test Validity

Before writing or accepting a test, ask:

> **"Can this test actually fail if the real code is broken?"**

- Avoid tests that only confirm mocked/fake behavior without exercising real logic.
- Avoid tests that confirm behavior guaranteed by the language or standard library.
- Every test must be capable of catching a real regression.

```dart
// BAD — tests the mock, not real logic
test('should return user', () {
  when(() => repo.getUser()).thenReturn(fakeUser);
  expect(repo.getUser(), fakeUser); // Only proves the mock works
});

// GOOD — tests the cubit's state transitions driven by the mock
blocTest<UserCubit, UserState>(
  'should emit loaded state when getUser succeeds',
  build: () {
    when(() => repo.getUser()).thenAnswer((_) async => fakeUser);
    return UserCubit(repo);
  },
  act: (cubit) => cubit.fetchUser(),
  expect: () => [
    const UserState(status: UserStatus.loading),
    UserState(status: UserStatus.loaded, user: fakeUser),
  ],
);
```

---

## 2. Structure

Always use `group()` in test files. Name the group after the **class under test**:

```dart
group('Counter', () {
  late Counter counter;

  setUp(() {
    counter = Counter();
  });

  test('value should start at 0', () {
    expect(counter.value, 0);
  });

  test('should increment value by 1', () {
    counter.increment();
    expect(counter.value, 1);
  });
});
```

Rules:
- Use `setUp` for shared object creation; use `tearDown` for cleanup (closing streams, controllers).
- Keep each test focused on one behavior.
- Nest `group()` blocks for sub-features when a class has many methods.

---

## 3. Naming

Name test cases using **"should"** to describe expected behavior:

```dart
test('should emit updated list when item is added', () { ... });
test('should throw ArgumentError when input is negative', () { ... });
```

---

## 4. Unit Tests vs Widget Tests

| Type | Target | Tools |
|---|---|---|
| **Unit test** | Pure Dart logic, repositories, cubits/blocs | `test`, `bloc_test`, `mocktail` |
| **Widget test** | Individual widgets, UI behavior, navigation | `flutter_test`, `WidgetTester` |

Default to **unit tests** for business logic. Use **widget tests** when verifying UI rendering, gesture handling, or widget interaction.

---

## 5. Widget Test Patterns

```dart
testWidgets('should display error message on failure', (tester) async {
  await tester.pumpWidget(
    MaterialApp(
      home: BlocProvider<LoginCubit>.value(
        value: mockLoginCubit,
        child: const LoginView(),
      ),
    ),
  );

  // Simulate failure state
  whenListen(
    mockLoginCubit,
    Stream.fromIterable([const LoginState(status: LoginStatus.failure, errorMessage: 'Invalid')]),
    initialState: const LoginState(),
  );
  await tester.pump();

  expect(find.text('Invalid'), findsOneWidget);
});
```

Rules:
- Wrap widgets in `MaterialApp` (or the app's root widget) to provide `MediaQuery`, `Directionality`, etc.
- Use `pump()` for a single frame or `pumpAndSettle()` when animations must complete.
- Prefer `find.byKey` over `find.text` for widgets that may have localized or dynamic text.

---

## 6. Mocking Best Practices

- Use `mocktail` for mocks (no code generation required).
- Call `registerFallbackValue()` in `setUpAll` for custom types passed to `any()`.
- Mock at the repository boundary, not at the HTTP/database layer.

```dart
class MockAuthRepository extends Mock implements AuthRepository {}

void main() {
  setUpAll(() {
    registerFallbackValue(FakeLoginRequest());
  });

  // ... tests
}
```

---

## 7. Test File Organization

```
test/
  feature_a/
    cubit/
      feature_a_cubit_test.dart
    view/
      feature_a_view_test.dart
    model/
      feature_a_model_test.dart
```

- Mirror the `lib/` folder structure under `test/`.
- One test file per source file.
- Name test files `<source_file>_test.dart`.

© Ivanna Kaceviča · MIT · evanca/flutter-ai-rules

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

Все скиллы по теме «Тесты и QA» →

Сначала — testing от других авторов.

testing tursodatabase Скилл testing помогает писать тесты для SQL и Rust: учит выбирать между форматами .sqltest, TCL и интеграционными тестами, показывает команды для запуска. CX Codex +1 1 300установок testing codewithmukesh Скилл testing задаёт стратегию тестирования приложений .NET 10: интеграционные тесты через WebApplicationFactory, реальные базы в Testcontainers, снапшоты Verify. CX Codex +1 4 000установок testing grafana Скилл testing настраивает проверки доступности, нагрузочные тесты k6 и наблюдаемость фронтенда через Grafana Cloud. Нужен перед релизом и для поиска сбоев. CX Codex +1 4 600установок testing rshankras Скилл testing для Claude Code: TDD-воркфлоу и тестовая инфраструктура для приложений на платформах Apple. Покрывает код тестами до и после изменений. CX Codex +1 500установок testing Mindrally Скилл testing задаёт правила тестирования для ИИ-агента: от табличных проверок до изоляции состояния и структуры каталогов. CX Codex +1 888установок flutter alinaqi Настраивает разработку на Flutter с Riverpod, Freezed и go_router. Срабатывает автоматически при работе с .dart, pubspec.yaml и папками lib/, test/. CX Codex +1 746установок dart-add-unit-test dart-lang Скилл dart-add-unit-test для Claude Code, Codex и других агентов пишет и организует юнит-тесты на package:test. Включается при добавлении логики или исправлении багов, чтобы избежать регрессий. CX Codex +1 21 400установок very-good-ai-flutter-plugin VeryGoodOpenSource Плагин very-good-ai-flutter-plugin для Claude Code задаёт стандарты разработки Flutter и Dart: BLoC, GoRouter, тесты и автоматическое форматирование кода. ★ 180звёзд репо flutter-testing Stanislav [MADTeacher] Chernyshev Скилл flutter-testing для написания, починки и отладки тестов Flutter: юнит-, виджет- и интеграционные тесты, моки, golden-проверки. CX Codex +1 1 500установок flutter-testing-skill TestMu AI Скилл flutter-testing-skill генерирует виджет-тесты, интеграционные тесты и golden-тесты для Flutter на Dart. Запускает локально или на реальных устройствах через TestMu AI облако. CX Codex +1 242установок dart-generate-test-mocks dart-lang Скилл dart-generate-test-mocks для юнит-тестов на Dart: агент выносит внешние зависимости в конструктор, генерирует моки через mockito и build_runner, потом пишет тесты. CX Codex +1 20 300установок

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

Весь набор →
firebase-storage Скилл firebase-storage содержит инструкции по работе с Firebase Cloud Storage во Flutter: загрузке и скачиванию файлов, управлению метаданными и обработке ошибок. CX Codex +1 ★ 674звёзд репо firebase-data-connect Скилл помогает настраивать Firebase Data Connect в Flutter, описывать GraphQL-запросы и мутации, подключать типизированный SDK и разбирать офлайн-сценарии. CX Codex +1 ★ 674звёзд репо firebase-remote-config Скилл для Flutter-приложений: агент подключает Firebase Remote Config — фича-флаги, значения по умолчанию, A/B-тесты и обновления конфига без релиза. CX Codex +1 ★ 674звёзд репо firebase-cloud-functions Помогает агенту писать код для вызова Firebase Cloud Functions во Flutter: обработка ошибок, таймауты и работа с эмулятором. CX Codex +1 ★ 674звёзд репо firebase-ai Скилл учит агента правильно подключать Firebase AI Logic в Flutter-проекте и писать код для генерации текста и чата через Gemini. CX Codex +1 ★ 674звёзд репо flutterfire-configure Настраивает Firebase в Flutter-проектах, автоматизирует вызов flutterfire configure и помогает развести конфигурации по нескольким app flavors. CX Codex +1 ★ 674звёзд репо flutter-use-column-row-first Скилл flutter-use-column-row-first помогает собирать адаптивные Flutter-экраны на Row и Column, а фиксированные размеры оставляет для конкретных задач. Пригодится при создании и проверке интерфейсов. CX Codex +1 ★ 674звёзд репо firebase-crashlytics Скилл учит агента настраивать Firebase Crashlytics во Flutter-проектах: ловить фатальные и нефатальные ошибки, логировать асинхронные исключения, добавлять кастомные ключи и загружать символы обфусцированных сборок. CX Codex +1 ★ 674звёзд репо

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

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