用途:把 Flutter 项目现状转化为具体结构、代码组织、依赖规则与校验步骤,用于检查、决策、实现或评审,而非产出报告。适用设计、重构、评审、实现四类任务。
主要能力:先确认目标是 Flutter/Dart 包(查看 pubspec.yaml、lib/ 及既有状态管理、路由、DI、网络、持久化与测试约定)。选择最小够用架构:中大型应用、团队协作、频繁功能变更用 feature-first;小型应用、单人开发、简单 CRUD 用 layer-first;仅复杂、可复用或多仓储业务逻辑才引入 Domain 层,简单流程 ViewModel 可直接调用 Repository。保持 View 声明式且薄,ViewModel 负责 UI 状态与命令,Repository 作为应用数据唯一真源,Service 作为外部数据源的无状态包装。
使用方式:实现任务优先沿用本地模式改造,确认导入、SDK 特性、状态管理风格与命名匹配后再套用技能模板。按需读取参考:基本概念 concepts.md,层边界与测试 layers.md,feature-first 结构与迁移 feature-first.md,MVVM 关系 mvvm.md,命令/Result/DI/离线/乐观 UI 等 design-patterns.md,以及 command.dart、result.dart 模板和 examples/README.md 示例。
限制与校验:依赖规则为低层不得依赖高层;功能模块不得导入其他功能的实现文件,共享行为放入 shared/ 或经 DI 依赖稳定接口。不要为凑图而建空目录。完成前检查导入边界、ViewModel 不直接做平台/文件/网络 I/O、Repository 与 UI 无关且 Service 交互可测试,并尽量运行 flutter analyze、相关 flutter test 套件,模板资产用 dart format --output=none --set-exit-if-changed 校验,报告实际命令、失败、跳过项与残留风险。若项目不可用或非 Flutter 项目,只能基于所给上下文给出计划或评审并说明未做代码校验。产品边界、团队/应用规模、离线优先与同步冲突、迁移是否增量等高风险决策无法推断时才询问用户。官方收费、价格与平台信息暂未提供。