AgentSkillsCN

senior-flutter-protocol-v5

Melos/Mason 项目结构的企业级规范（核心、通用、软件包）。

SKILL.md
--- frontmatter
name: senior-flutter-protocol-v5
description: Enterprise-level rules for Melos/Mason project structure (Core, Common, Package)

🛡 Senior Flutter Engineering Protocol (V5 Enterprise)

0. Project Context & Awareness (MANDATORY)

Перед генерацией кода агент ОБЯЗАН просканировать структуру проекта:

  • •Core Library (lib/core/):
    • •error/ — используй для моделей Failure.
    • •router/ — используй для навигации.
    • •di/ — используй для инъекции зависимостей.
    • •theme/, constants/, extensions/ — используй для UI и стилизации.
  • •Common Components (lib/common/): Сначала ищи готовые виджеты здесь (dialogs, timer, food_card). ❌ Запрещено дублировать существующие компоненты.
  • •Packages: Проект использует Melos. Изменения в package/rest_client или storage должны быть изолированы.
  • •Automation: Проверь mason.yaml и Makefile перед созданием новых модулей.

1. Architecture (HARD RULES)

  • •Dependency Flow: Presentation → Domain ← Data. (Strict)
  • •Layer Isolation:
    • •❌ flutter/*, dio или сторонние SDK внутри domain.
    • •❌ BuildContext внутри Cubit/Bloc/Repository/Service.
    • •✅ Domain = Pure Dart. Бизнес-логика только в UseCase или Cubit.
  • •Contract-First: Репозитории в Domain — это интерфейсы (abstract class). Реализация — в Data.

2. State Management (Bloc/Cubit)

  • •Single Source of Truth: Весь стейт хранится ТОЛЬКО в классе State.
  • •Immutability: Все State: sealed, final, immutable. Обновление только через copyWith.
  • •❌ No Hidden State: Запрещены late переменные и приватные поля внутри Cubit/Bloc.
  • •State Design: Состояние должно быть явным (Initial, Loading, Success, Failure).

3. UI & Performance (Custom Kit)

  • •UI Kit First: ❌ Запрещено использовать базовые виджеты (ElevatedButton и т.д.), если есть проектные аналоги в common/ или core/.
  • •Decomposition: build() > 40 строк → Extract to const StatelessWidget.
  • •❌ No Logic in UI: В build() и onPressed запрещены вычисления и условия (if/else).
  • •✅ Intent Pattern: onPressed только уведомляет логику: cubit.onAction().

4. Side Effects & Navigation

  • •Navigation: Только через lib/core/router/. Логика не знает о маршрутах.
  • •Side Effects: Snackbar, Dialog, Toast — это Effect. Cubit эмитит Effect, UI слушает через BlocListener.

5. Error Handling & Data Flow

  • •Data Layer: try-catch (Dio/Storage) → маппинг в Failure из `lib