Как научить ИИ-агента писать на Flutter без косяков

Знакомая ситуация: просишь нейронку набросать экран на Flutter, а в ответ получаешь код, который падает с ошибкой RenderFlex overflow или игнорирует все правила архитектуры. ИИ вроде бы знает синтаксис Dart, но понятия не имеет, как в вашей команде принято организовывать слои данных или фиксить верстку под разные экраны.

Команда Flutter выкатила любопытный проект под названием flutter/skills. Это набор инструкций и сценариев, которые превращают обычного LLM-агента в «сеньора», знающего лучшие практики фреймворка.

Что это за навыки и зачем они нужны

Разработчики из Google решили подойти к проблеме галлюцинаций ИИ системно. Вместо того чтобы просто надеяться на контекстное окно чат-бота, они предлагают внедрять в рабочее окружение агента конкретные «скиллы».

По сути, это дополнение к протоколу MCP (Model Context Protocol). Если MCP дает агенту инструменты (например, доступ к файловой системе или терминалу), то Skill обучает его, как именно эти инструменты использовать для решения конкретных задач во Flutter. Это набор файлов в папке .agents/skills, которые содержат доменную экспертизу: от настройки локализации до исправления сложных ошибок в древе виджетов.

Какие задачи теперь можно делегировать

В репозитории уже лежит десяток готовых навыков. Я выделил те, что реально экономят время в ежедневной рутине.

Борьба с кривой версткой

Навык flutter-fix-layout-issues нацелен на самые раздражающие ошибки: когда контент вылезает за границы экрана или виджет требует бесконечную высоту там, где ее нет. Агент получает четкие инструкции, как использовать LayoutBuilder или Flexible, чтобы не просто «заткнуть» ошибку, а сделать интерфейс адаптивным.

Настройка тестов и превью

Писать интеграционные тесты вручную — занятие на любителя. Навык flutter-add-integration-test позволяет скомандовать агенту: «Добавь тест, который проверяет процесс оформления заказа». ИИ не просто накидает код, а сконфигурирует Flutter Driver и преобразует действия в постоянные тесты.

Кстати, там же есть flutter-add-widget-preview. Это штука для создания интерактивных превью виджетов (аналог Storybook или превью в SwiftUI). Агент сам подготовит файл previews.dart и пропишет разные состояния для вашего компонента.

Архитектурный надзор

Самый полезный, на мой взгляд, скилл — flutter-apply-architecture-best-practices. Он заставляет нейронку разделять код на UI, логику и данные. Если попросить его отрефакторить фичу, он не свалит всё в один файл, а разнесет по слоям, как того требуют гайдлайны Google.

Как это работает под капотом

Технически это выглядит просто. Вы устанавливаете утилиту через npx и добавляете нужные навыки в свой проект:

npx skills add flutter/skills --skill '*' --agent universal

Флаг --agent universal копирует инструкции в стандартную папку .agents/skills. Большинство современных ИИ-агентов (например, те, что работают в VS Code или курсоре) умеют подхватывать эти файлы и использовать их как системный промпт при выполнении задач в контексте вашего проекта.

Интересно, что проект тесно связан с аналогичным репозиторием Agent Skills for Dart. Если ваша задача касается чистого Dart (например, сериализация JSON), лучше ставить оба пакета.

Практическая польза

Я вижу несколько сценариев, где это реально выстрелит:

Онбординг новичков. Вместо того чтобы сто раз объяснять, почему мы используем go_router именно так, можно дать человеку настроенного агента с навыком flutter-setup-declarative-routing.
Быстрое прототипирование. Можно набросать костяк приложения, просто перечисляя навыки: «Настрой локализацию для RU/EN, добавь http-клиент и создай модель пользователя с JSON-сериализацией».
Рутинный рефакторинг. Когда нужно переписать старый код под новые стандарты, агент с навыками сделает это чище, чем «голая» GPT-4.

Стоит ли пробовать

Проект пока находится в стадии активного наполнения — разработчики даже временно закрыли прием Pull Request'ов, чтобы устаканить базу. Но сама концепция «обучения» агента через специфичные для фреймворка файлы кажется гораздо жизнеспособнее, чем бесконечное уточнение промптов вручную.

Если вы используете ИИ-помощников в разработке на Flutter, установка этих скиллов — самый быстрый способ сократить количество правок после нейронки. Это не волшебная палочка, которая напишет приложение за вас, но хороший цифровой подмастерье, который хотя бы знает, куда не стоит совать Column без Expanded.