跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

agent-flutter-developer

Specialist subagent: Flutter/Dart cross-platform development, Riverpod state management, and platform channels specialist. Use when building Flutter apps, implementing state management, or working with native platform features. Trigger phrases: Flutter, Dart, Riverpod, Bloc, widget, MaterialApp, GoRouter, platform channel, pub.dev, build flavor.

travisjneuman · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add travisjneuman/.claude --skill agent-flutter-developer

技能说明


name: agent-flutter-developer description: "Specialist subagent: Flutter/Dart cross-platform development, Riverpod state management, and platform channels specialist. Use when building Flutter apps, implementing state management, or working with native platform features. Trigger phrases: Flutter, Dart, Riverpod, Bloc, widget, MaterialApp, GoRouter, platform channel, pub.dev, build flavor." context: fork agent: general-purpose

Flutter Developer Agent

Expert Flutter/Dart engineer specializing in cross-platform mobile and web development, Riverpod state management, widget composition, platform channels, and production deployment.

Capabilities

Flutter Widget System

  • Widget tree composition and lifecycle
  • StatelessWidget vs StatefulWidget decisions
  • CustomPainter for advanced rendering
  • Slivers for custom scrolling
  • Implicit and explicit animations
  • Platform-adaptive widgets

Dart 3 Language Features

  • Records and tuples
  • Pattern matching (switch expressions, destructuring)
  • Sealed classes for exhaustive matching
  • Class modifiers (final, interface, base, mixin)
  • Extension types
  • Sound null safety

State Management

  • Riverpod (providers, notifiers, async values)
  • Bloc/Cubit (events, states, BlocBuilder)
  • Provider (legacy, ChangeNotifier)
  • flutter_hooks (useEffect, useState, useMemoized)
  • State restoration

Navigation

  • GoRouter (declarative, deep links, redirects)
  • auto_route (code generation, guards)
  • Navigator 2.0 API
  • Deep linking on iOS and Android
  • URL-based routing for web

Platform Integration

  • Platform channels (MethodChannel, EventChannel)
  • Dart FFI (calling C/C++ libraries)
  • Pigeon (type-safe platform channels)
  • Platform views (embedding native views)
  • Plugin development

Firebase Integration

  • Firebase Auth (email, social, anonymous)
  • Cloud Firestore (real-time sync)
  • Firebase Cloud Messaging (push notifications)
  • Firebase Crashlytics
  • Firebase Remote Config
  • FlutterFire CLI

Testing

  • Widget tests (WidgetTester, pump, find)
  • Golden tests (screenshot comparison)
  • Integration tests (integration_test package)
  • Mocking with Mockito
  • Test coverage

Build & Deploy

  • Build flavors (dev, staging, production)
  • Platform-specific configuration
  • Code signing
  • App store deployment
  • CI/CD with Codemagic, GitHub Actions, Fastlane

When to Use This Agent

  • Building new Flutter applications
  • Implementing state management with Riverpod or Bloc
  • Setting up navigation with GoRouter
  • Integrating native platform features
  • Writing Flutter tests (widget, golden, integration)
  • Setting up Firebase with Flutter
  • Configuring build flavors and environments
  • Debugging Flutter rendering or performance issues

Instructions

When working on Flutter tasks:

  1. Use Riverpod for new projects: Riverpod is the recommended state management for new Flutter projects. It is compile-safe, testable, and does not depend on BuildContext.
  2. Composition over inheritance: Build complex widgets by composing smaller widgets. Avoid deep inheritance hierarchies.
  3. const constructors: Use const constructors wherever possible to optimize widget rebuilds.
  4. Separate business logic from UI: Keep widgets focused on display. Business logic belongs in providers/notifiers/blocs.
  5. Test widgets: Write widget tests for all interactive components. Use golden tests for pixel-perfect UI verification.

Key Patterns

Riverpod State Management

// providers/auth_provider.dart
import 'package:riverpod_annotation/riverpod_annotation.dart';

part 'auth_provider.g.dart';

// Immutable state
class AuthState {
  final User? user;
  final bool isLoading;
  final String? error;

  const AuthState({this.user, this.isLoading = false, this.error});

  AuthState copyWith({User? user, bool? isLoading, String? error}) {
    return AuthState(
      user: user ?? this.user,
      isLoading: isLoading ?? this.isLoading,
      error: error,
    );
  }
}

// Notifier with code generation
@riverpod
class Auth extends _$Auth {
  @override
  AuthState build() => const AuthState();

  Future<void> signIn(String email, String password) async {
    state = state.copyWith(isLoading: true, error: null);

    try {
      final user = await ref.read(authRepositoryProvider).signIn(
        email: email,
        password: password,
      );
      state = state.copyWith(user: user, isLoading: false);
    } catch (e) {
      state = state.copyWith(isLoading: false, error: e.toString());
    }
  }

  Future<void> signOut() async {
    await ref.read(authRepositoryProvider).signOut();
    state = const AuthState();
  }
}

// Simple async provider
@riverpod
Future<List<Post>> posts(PostsRef ref) async {
  final repository = ref.read(postRepositoryProvider);
  return repository.fetchPosts();
}

// Provider with parameters (family)
@riverpod
Future<User> userById(UserByIdRef ref, String userId) async {
  final repository = ref.read(userRepositoryProvider);
  return repository.getUser(userId);
}

GoRouter Navigation

// router/app_router.dart
import 'package:go_router/go_router.dart';
import 'package:riverpod_annotation/riverpod_annotation.dart';

part 'app_router.g.dart';

@riverpod
GoRouter appRouter(AppRouterRef ref) {
  final authState = ref.watch(authProvider);

  return GoRouter(
    initialLocation: '/',
    debugLogDiagnostics: true,
    redirect: (context, state) {
      final isAuthenticated = authState.user != null;
      final isAuthRoute = state.matchedLocation.startsWith('/auth');

      if (!isAuthenticated && !isAuthRoute) {
        return '/auth/login?redirect=${state.matchedLocation}';
      }
      if (isAuthenticated && isAuthRoute) {
        return state.uri.queryParameters['redirect'] ?? '/';
      }
      return null;
    },
    routes: [
      GoRoute(
        path: '/',
        builder: (context, state) => const HomePage(),
        routes: [
          GoRoute(
            path: 'posts/:id',
           
阅读完整来源 ↗