用途
该技能用于 Flutter + Dart 的 Android 与 iOS 应用架构的搭建、实现、审查与整改,目标是在应用持续增长时仍保持视图、视图模型、数据、原生与平台边界清晰可理解、可测试。它区分官方框架行为与 Hypercore 约定,不将后者强加于项目。
主要能力
- 按官方 MVVM 分层引导项目启动或重构,维护单一路由配置、严格的分析器设置与显式的功能边界。
- 提供按主题拆分的规则文件:项目结构(规模档位、归属、导入、迁移顺序、工作区布局)、路由与导航(导航模型、单一路由、守卫、深链接、返回处理)、数据与状态边界(状态归属、仓库、DTO、持久化、依赖注入)、原生平台与安全(原生目录、flavors、权限、密钥、互操作)、测试与验证(检查顺序、测试底线、必需场景、完成记录)。
- 附带一份带日期的官方 Flutter/Dart 参考(references/official/flutter-dart-2026-11-04.md),在工具链版本或 API 生命周期决定变更时用于比对。
- 定义有界验证-修复循环:运行检查、只修复观察到的失败,最多两轮;仅在格式检查、分析器、测试与相关安全门禁通过时保留改动。
- 输出项目本地的架构实现或审查结果,以及一份包含决策、变更文件、检查结果、版本与来源说明、残余风险的简明报告。
使用方式
先读取 architecture-rules.md 了解规则类别、权威顺序与阻断门禁;再按变更涉及的领域选择读取对应规则文件;仅当当前工具链行为或 API 生命周期决定变更时读取官方参考;完成前读取测试与验证规则。流程分为:确认项目事实(通过 flutter --version、pubspec.yaml 的 environment 块、存在的平台目录、flavors 与入口、状态库、路由、Swift Package Manager 与 CocoaPods 的选择、pub workspace 布局、material_ui 采用情况、项目命令、是否需要安装/签名/商店操作)→ 盘点功能、路由表、共享模块、状态与数据流、原生配置、测试与依赖方向 → 将发现分类为官方、安全或 Hypercore 约定 → 定义目标边界与最小垂直切片 → 实施安全可逆的改动 → 运行聚焦检查再运行项目级检查 → 以韩语报告。
适用场景
示例包括:为 Flutter 应用设定 feature 级目录与路由/状态归属边界;重构使 go_router 配置集中于一处、功能间不再互相导入内部实现;从架构角度审查 Android productFlavors 与 iOS scheme 的权限配置;用 go_router 和底部标签壳设置深链接并说明 Android 与 iOS 的差异。也适用于已上线或增长中的 Flutter 项目需要调整结构、路由、导入、平台接缝或验证顺序的审查请求。
限制
不适用于纯 Dart 命令行工具或服务端、独立包或插件开发、React Native 或 Expo 应用、非 Flutter 的纯 Web 项目、无架构影响的单一视觉改动、仅部署工作或仅文档总结。对既有项目,除非用户要求迁移或安全/正确性问题需要变更,否则保留可用约定。重新生成原生目录、替换依赖、签名、商店发布、项目级生成器和下载或执行二进制的构建钩子需要明确授权。不得从宿主单元测试、widget 测试或仅 Web 运行断言 Android/iOS 支持。不得将路由重定向视为授权,深链接、推送、路由 extra、持久化或 API 输入必须在边界校验。默认面向用户的交付物与报告使用韩语。
基准版本
按官方参考文件,基线为 Flutter 3.47.9 / Dart 3.13.7,来源日期不晚于当前。