flutter-change-notifier — скилл для Claude Code: что делает, установка
Скилл flutter-change-notifier учит агента правильно использовать ChangeNotifier и provider для управления состоянием во Flutter: модель, провайдер, Consumer, оптимизация ребилдов.
MIT ★ 674 обновлён 2026-10-29
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rulesЧто делает flutter-change-notifier
Агент создаёт модель с приватным состоянием и методами, которые вызывают notifyListeners() после изменений. Модель оборачивается в ChangeNotifierProvider (или MultiProvider для нескольких моделей), который автоматически очищает ресурсы. Виджеты подписываются через Consumer<T> с явным указанием типа; константные части передаются в параметр child, чтобы они не пересобирались.
Для вызова методов без подписки на изменения агент использует Provider.of<T>(context, listen: false). Consumer размещается как можно глубже в дереве виджетов, чтобы сократить область ребилдов. Без правильной структуры дерева и размещения провайдеров будут пересобираться большие части интерфейса.
Скилл включает правила для unit-тестов моделей: проверка изменений состояния и вызова слушателей через addListener. Агент не мутирует виджеты напрямую, а пересобирает их с новыми данными.
Какие задачи решает
- настроить
ChangeNotifierмодель с приватным состоянием иnotifyListeners() - обернуть модель в
ChangeNotifierProviderилиMultiProvider - подписать виджет на изменения через
Consumer<T>с оптимизацией ребилдов - вызвать метод модели без подписки через
Provider.of<T>(context, listen: false) - написать unit-тест для
ChangeNotifierс проверкой слушателей
Примеры запросов агенту
- Создай модель корзины с
ChangeNotifier, методами добавления и очистки товаров - Оберни приложение в
ChangeNotifierProviderдляCartModel - Добавь
Consumer<CartModel>для отображения общей цены, константную часть вынеси вchild
Как установить flutter-change-notifier
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 flutter-change-notifier -a claude-code3Вручную: положить файлы
~/.claude/skills/flutter-change-notifier/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/flutter-change-notifier/
1Через Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill flutter-change-notifier -a codex2Вручную: положить файлы
.agents/skills/flutter-change-notifier/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill flutter-change-notifier -a cursor2Вручную: положить файлы
.cursor/skills/flutter-change-notifier/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install evanca/flutter-ai-rules skills/flutter-change-notifier2Вручную: положить файлы
.github/skills/flutter-change-notifier/SKILL.md1Через Skills CLI (Vercel)
npx skills add evanca/flutter-ai-rules --skill flutter-change-notifier -a gemini-cli2Командой платформы
gemini skills install https://github.com/evanca/flutter-ai-rules --path skills/flutter-change-notifierВручную: положить файлы
.devin/skills/flutter-change-notifier/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о flutter-change-notifier
Как установить flutter-change-notifier в Claude Code?
Выполни /plugin marketplace add evanca/flutter-ai-rules, затем /plugin install flutter-ai-skills@flutter-ai-rules. Можно через CLI: npx skills add evanca/flutter-ai-rules --skill flutter-change-notifier -a claude-code. Файл появится в ~/.claude/skills/flutter-change-notifier/SKILL.md.
Что делает flutter-change-notifier?
Учит агента работать с ChangeNotifier и provider для управления состоянием во Flutter: создавать модели, оборачивать в провайдеры, подписывать виджеты через Consumer, оптимизировать ребилды и тестировать модели.
Когда использовать listen: false в Provider.of?
Когда нужно вызвать метод модели в колбэке (например, onPressed), но не нужна подписка на изменения состояния. Так виджет не будет пересобираться при каждом notifyListeners().
Исходный текст
SKILL.md · MIT
---
name: flutter-change-notifier
description: "Use when setting up ChangeNotifier models, providing them to the widget tree, consuming state with Consumer or Provider.of, or optimizing rebuilds."
license: MIT
---
# Flutter ChangeNotifier Skill
This skill defines how to correctly use `ChangeNotifier` with the `provider` package for state management in Flutter.
---
## 1. Model
Extend `ChangeNotifier` to manage state. Keep internal state **private** and expose **unmodifiable views**. Call `notifyListeners()` on every state change.
```dart
class CartModel extends ChangeNotifier {
final List<Item> _items = [];
UnmodifiableListView<Item> get items => UnmodifiableListView(_items);
void add(Item item) {
_items.add(item);
notifyListeners();
}
void removeAll() {
_items.clear();
notifyListeners();
}
}
```
- Place shared state **above** the widgets that use it in the widget tree.
- Never directly mutate widgets or call methods on them to change state — rebuild widgets with new data instead.
---
## 2. Providing the Model
```dart
ChangeNotifierProvider(
create: (context) => CartModel(),
child: MyApp(),
)
```
- `ChangeNotifierProvider` **automatically disposes** of the model when it is no longer needed.
- Use `MultiProvider` when you need to provide multiple models:
```dart
MultiProvider(
providers: [
ChangeNotifierProvider(create: (_) => CartModel()),
ChangeNotifierProvider(create: (_) => UserModel()),
],
child: MyApp(),
)
```
---
## 3. Consuming State
### Consumer
```dart
Consumer<CartModel>(
builder: (context, cart, child) => Stack(
children: [
if (child != null) child,
Text('Total price: ${cart.totalPrice}'),
],
),
child: const SomeExpensiveWidget(), // rebuilt only once
)
```
- Always specify the generic type (`Consumer<CartModel>`, not `Consumer`).
- Use the `child` parameter to pass **widgets that don't depend on the model** — they are built once and reused.
- Place `Consumer` widgets **as deep in the widget tree as possible** to minimize the scope of rebuilds:
```dart
HumongousWidget(
child: AnotherMonstrousWidget(
child: Consumer<CartModel>(
builder: (context, cart, child) {
return Text('Total price: ${cart.totalPrice}');
},
),
),
)
```
### Provider.of with listen: false
Use `Provider.of<T>(context, listen: false)` when you only need to **call methods** on the model, not react to state changes:
```dart
Provider.of<CartModel>(context, listen: false).removeAll();
```
---
## 4. Optimization Rules
- Do **not** wrap large widget subtrees in a `Consumer` if only a small part depends on the model.
- Avoid rebuilding widgets unnecessarily — structure your widget tree and provider usage carefully.
- Use `listen: false` in callbacks (e.g., `onPressed`) where you trigger actions but don't need rebuilds.
---
## 5. Testing
Write **unit tests** for your `ChangeNotifier` models to verify state changes and notifications:
```dart
test('adding item updates total', () {
final cart = CartModel();
var notified = false;
cart.addListener(() => notified = true);
cart.add(Item('Book'));
expect(cart.items.length, 1);
expect(notified, isTrue);
});
```
---
## References
- [Flutter Website GitHub Repository](https://github.com/flutter/website)
© Ivanna Kaceviča · MIT · evanca/flutter-ai-rules