用途
flutter-executing 是一个用于执行 Flutter 实现计划的技能。当你已经有一份书面的实现计划，并希望以带审查检查点的分批方式推进时，可以使用它。其核心原则是：分批执行，并在批次之间设置检查点以供审查。
开始时应声明：“I'm using the flutter-executing skill to implement this plan.”
主要能力与流程
第 1 步：加载并审查计划
读取计划文件：
cat docs/plans/YYYY-MM-DD-<feature>-plan.md
先检查依赖：
cat pubspec.yaml
如有需要，安装新依赖：
flutter pub get
批判性审查：文件路径是否正确？是否遵循分层顺序（Domain → Data → Presentation）？计划中是否存在缺口？
如果有疑虑：在开始前提出。如果没有疑虑：创建 todo 条目（任务跟踪工具）并继续。
第 2 步：执行批次
默认：前 3 个任务。
对每个任务：
- 在任务跟踪器中标记为 in_progress
- 按计划创建/修改文件
- 编写完整代码（来自计划）
- 运行验证：
flutter analyze lib/features/<feature>/
- 提交：
git add <files>
git commit -m "<conventional commit message>"
- 在任务跟踪器中标记为 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 步：完成开发
所有任务完成并验证后，运行最终验证：
flutter analyze
flutter test
flutter build <target> --debug # per project platform (apk/ios/web/…)
声明：“I'm using the flutter-finishing skill to complete this work.”
必需子技能：使用 flutter-craft:flutter-finishing。验证测试，呈现 4 个选项（merge/PR/keep/discard），执行所选选项，如适用则清理 worktree。
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 中缺少依赖
- 计划说明不清晰
- 计划中的文件路径与项目结构不匹配
- 状态管理模式不明确
应请求澄清，而不是猜测。
分层顺序验证
执行前，验证计划遵循以下顺序：
-
Domain Layer 任务优先
- Entities
- Repository interfaces
- UseCases
-
Data Layer 任务其次
- Models
- DataSources
- Repository implementations
-
Presentation Layer 任务第三
- State Management
- Widgets
- Screens
-
测试任务在实现之后
- Repository tests（优先级 1）
- State tests（优先级 2）
- Widget tests（优先级 3，可选）
- Golden tests（优先级 4，可选，视觉回归）
如果计划不遵循此顺序，在开始前提出疑虑。
必需子技能
执行期间：每批之后，必须调用 → flutter-craft:flutter-verification（继续前先验证）。
所有任务完成后：必须调用 → flutter-craft:flutter-finishing（呈现完成选项）。
要点提醒
- 先批判性审查计划——不要盲目执行
- 遵循分层顺序——Domain → Data → Presentation
- 每批运行 flutter analyze——尽早发现错误
- 每个任务后提交——原子化提交
- 报告并等待——没有反馈不要继续
- 受阻时停止——不要猜测，要询问
适用场景
适用于已有书面 Flutter 实现计划、需要按批次执行并在批次之间获得审查反馈的开发流程。
限制
资料未提供关于收费、价格、平台支持范围或具体效果的信息。