testing · evanca — скилл для Claude Code: тесты Flutter/Dart и установка
Скилл testing помогает писать и проверять unit- и widget-тесты для Flutter и Dart, разбирать flaky-тесты и выбирать подходящий тип проверки.
MIT ★ 674 обновлён 2026-10-29
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rulesЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/testing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/testing/
1Через Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill testing -a codex2Вручную: положить файлы
.agents/skills/testing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill testing -a cursor2Вручную: положить файлы
.cursor/skills/testing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install evanca/flutter-ai-rules skills/testing2Вручную: положить файлы
.github/skills/testing/SKILL.md1Через Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill testing -a gemini-cli2Командой платформы
gemini skills install https://github.com/evanca/flutter-ai-rules --path skills/testingВручную: положить файлы
.devin/skills/testing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.