flutter-executing

执行 Flutter 实施计划

概述

加载计划，仔细审查，分批执行任务，运行 Flutter 验证，并在批次之间报告以供审查。

核心原则： 分批执行，并设置审查检查点。

开始时宣布：「我正在使用 flutter-executing 技能来实施此计划。」

流程

步骤 1：加载并审查计划

1. 读取计划文件

   cat docs/plans/YYYY-MM-DD-<feature>-plan.md
   

2. 先检查依赖项

   cat pubspec.yaml
   

3. 按需安装新依赖项

   flutter pub get
   

4. 仔细审查：

   • 文件路径是否正确？
   • 是否遵循分层顺序（Domain → Data → Presentation）？
   • 计划中是否有遗漏？

5. 如有疑虑： 开始前提出

6. 如无疑虑： 创建待办条目（任务跟踪工具），然后继续

步骤 2：执行批次

默认：前 3 个任务

对每个任务：

1. 在任务跟踪工具中将其标记为 in_progress
2. 按照指定内容创建/修改文件
3. 编写完整代码（来自计划）
4. 运行验证：

   flutter analyze lib/features/<feature>/
   

5. 提交：

   git add <files>
   git commit -m "<conventional commit message>"
   

6. 在任务跟踪工具中将其标记为 completed

步骤 3：验证批次

完成 3 个任务后，运行完整验证：

# Static analysis
flutter analyze
# Expected: No issues found!

# Run tests (if test files exist)
flutter test test/features/<feature>/
# Expected: All tests passed!

# Quick build check (optional — full build runs once in flutter-finishing)
flutter build <target> --debug   # apk / ios / web / windows … per project platform
# Expected: Built successfully

步骤 4：报告

批次完成后，报告：

## Batch N Complete

**Tasks completed:**
1. ✅ Task 1: [description]
2. ✅ Task 2: [description]
3. ✅ Task 3: [description]

**Verification:**
- flutter analyze: No issues found
- flutter test: X/X passed

**Files created/modified:**
- lib/features/.../entity.dart
- lib/features/.../repository.dart
- ...

**Ready for feedback.**

步骤 5：继续

根据反馈：

• 如有需要，应用更改
• 执行下一批 3 个任务
• 重复以上步骤，直至所有任务完成

步骤 6：完成开发

所有任务完成并验证通过后：

1. 运行最终验证：

   flutter analyze
   flutter test
   flutter build <target> --debug  # per project platform (apk/ios/web/…)
   

2. 宣布：「我正在使用 flutter-finishing 技能来完成这项工作。」

3. 必需的子技能： 使用 flutter-craft:flutter-finishing

   • 验证测试
   • 提供 4 个选项（合并/PR/保留/丢弃）
   • 执行所选操作
   • 如适用，清理工作树

Flutter 专用验证命令

阶段	命令	预期输出
单文件	flutter analyze lib/path/file.dart	No issues found
单批次	flutter analyze lib/features/<feature>/	No issues found
测试	flutter test test/features/<feature>/	All tests passed
最终	flutter build <target> --debug	Built successfully

何时停止并寻求帮助

出现以下情况时，立即停止执行：

• flutter analyze 显示错误（不只是警告）
• 测试失败且原因不明确
• 缺少 pubspec.yaml 中未声明的依赖项
• 计划中的指示不明确
• 计划中的文件路径与项目结构不符
• 状态管理模式不明确

请寻求澄清，不要猜测。

分层顺序验证

执行前，验证计划是否遵循此顺序：

1. Domain Layer tasks first
   ├── Entities
   ├── Repository interfaces
   └── UseCases

2. Data Layer tasks second
   ├── Models
   ├── DataSources
   └── Repository implementations

3. Presentation Layer tasks third
   ├── State Management
   ├── Widgets
   └── Screens

4. Test tasks after implementation
   ├── Repository tests (priority 1)
   ├── State tests (priority 2)
   ├── Widget tests (priority 3, optional)
   └── Golden tests (priority 4, optional, visual regression)

如果计划未遵循此顺序，请在开始前提出疑虑。

必需的子技能

执行期间

每批完成后，你必须调用： → flutter-craft:flutter-verification（继续前进行验证）

所有任务完成后

你必须调用： → flutter-craft:flutter-finishing（提供完成选项）

请记住

• 先仔细审查计划——不要盲目执行
• 遵循分层顺序——Domain → Data → Presentation
• 每批运行 flutter analyze——尽早发现错误
• 每个任务完成后提交——保持提交原子性
• 报告并等待——收到反馈前不要继续
• 受阻时停止——不要猜测，应寻求帮助