flutter-parallel-agents

并行调度 Flutter Agent

概述

当你有多个互不相关的任务（不同的功能、不同的测试文件、不同的 Bug）时，按顺序逐一处理会浪费时间。每项调查都是独立的，可以并行进行。

核心原则： 每个独立的问题领域分配一个 Agent，让它们并行工作。

开始时声明：“我将使用 flutter-parallel-agents skill 来处理这些任务。”

适用场景

Multiple tasks/failures?
├─ NO  → Single agent handles it
└─ YES → Are they independent?
         ├─ NO (related) → Single agent investigates all
         └─ YES → Can they work in parallel?
                  ├─ NO (shared state/files) → Sequential agents
                  └─ YES → Parallel dispatch (this skill)

适用于：

• 多个测试文件因不同根本原因而失败
• 需要在不同区域实现多个功能
• 每个问题都可以在不了解其他问题背景的情况下理解
• 调查之间没有共享状态
• 需要处理不同的 Clean Architecture 层

不适用于：

• 故障之间存在关联（修复一个问题可能会解决其他问题）
• 任务会修改相同的文件
• 任务之间存在依赖关系
• 需要先了解整个系统的状态

Flutter 专用并行场景

独立的分层任务

lib/features/auth/
├── domain/      ← Agent 1: Implement entities & interfaces
├── data/        ← Agent 2: Implement models & datasources
└── presentation/ ← Wait for Agents 1 & 2 (has dependencies)

可以并行： Domain + Data 层（不同文件） 不能并行： Presentation 依赖于 Domain

独立的功能任务

lib/features/
├── auth/        ← Agent 1: Auth feature
├── profile/     ← Agent 2: Profile feature
└── settings/    ← Agent 3: Settings feature

可以并行： 全部三个（不同的功能文件夹）

独立的测试修复

test/features/
├── auth/data/repositories/auth_repo_test.dart      ← Agent 1
├── profile/presentation/bloc/profile_bloc_test.dart ← Agent 2
└── settings/data/datasources/settings_ds_test.dart  ← Agent 3

可以并行： 不同测试文件、不同功能

工作模式

1. 确定独立领域

按受影响的内容对任务分组：

• 功能 A：用户身份验证
• 功能 B：个人资料管理
• 功能 C：设置存储

每个领域都是独立的——修复身份验证不会影响设置。

2. 创建专注的 Agent 任务

每个 Agent 都应获得：

• 具体范围： 一个功能或测试区域
• 明确目标： 需要实现或修复的内容
• 约束： 不要更改其他功能
• 预期输出： 已完成工作的摘要

3. 并行调度

实现时使用 subagent_type: "flutter-craft:flutter-dart-specialist" agents——其定义包含 Flutter/Dart 规范（Riverpod 模式、 widget 原则、推荐的软件包），因此提示词只需描述任务。

Task("Implement auth domain layer - entities and repository interface")
Task("Implement profile domain layer - entities and repository interface")
Task("Implement settings domain layer - entities and repository interface")
// All three run concurrently, each as flutter-craft:flutter-dart-specialist

4. 审查并集成

Agent 返回结果后：

• 阅读每份摘要
• 确认修复之间没有冲突
• 运行 flutter analyze
• 运行 flutter test
• 集成所有更改

Agent 提示词结构

Implement the [Layer] layer for [Feature] feature.

## Scope
lib/features/[feature]/[layer]/

## Files to Create
- entities/[entity].dart
- repositories/[repository].dart (interface)

## Requirements
[Paste specific requirements from plan]

## Constraints
- ONLY modify files in lib/features/[feature]/[layer]/
- Do NOT touch other features
- Follow Clean Architecture principles
- Run flutter analyze before committing

## Expected Output
- Summary of what you created
- flutter analyze result
- Commit message used

示例：并行实现功能

场景： 需要为 3 个功能实现 Domain 层

决策： 每个 Domain 层都是独立的

调度：

Agent 1 → Implement auth/domain/ (User entity, AuthRepository interface)
Agent 2 → Implement profile/domain/ (Profile entity, ProfileRepository interface)
Agent 3 → Implement settings/domain/ (Settings entity, SettingsRepository interface)

结果：

• Agent 1：创建了 User 实体、AuthRepository ✅
• Agent 2：创建了 Profile 实体、ProfileRepository ✅
• Agent 3：创建了 Settings 实体、SettingsRepository ✅

集成：

flutter analyze  # All clean
flutter test     # All pass
git log --oneline -3  # See all three commits

常见错误

❌ 范围太广：“实现所有功能”——Agent 会不知所措 ✅ 范围明确：“实现 auth/domain 层”——范围清晰

**❌ 并行处理有依赖关系的任务：**先处理 Data 层，再处理 Domain **✅ 正确顺序：**先处理 Domain，然后并行处理 Data

**❌ 编辑相同文件：**两个 Agent 都编辑 pubspec.yaml **✅ 避免冲突：**为每个 Agent 分配隔离的文件范围

不适用场景

• **存在顺序依赖：**Data 层需要先有 Domain 层
• **共享文件：**多个 Agent 需要使用同一文件
• **跨功能依赖：**功能 B 从功能 A 导入内容
• **需要全局上下文：**理解问题需要查看整个应用

验证

Agent 返回结果后：

1. 审查每份摘要——了解更改内容
2. 检查冲突——Agent 是否编辑了相同文件？
3. 运行 flutter analyze——确认所有代码没有问题
4. 运行 flutter test——确认测试通过
5. 检查导入——没有循环依赖

flutter analyze
flutter test
git diff --stat  # See all changes

优势

1. 并行处理——同时实现多个任务
2. 专注——每个 Agent 的范围都很窄
3. 互不干扰——Agent 之间不会相互影响
4. 速度——解决 N 个问题只需解决 1 个问题的时间