用途:为 Flutter 跨平台移动应用(iOS、Android、macOS、Web)开发提供统一技术栈与工作流规范,适用于创建应用、添加页面、用 Riverpod 管理状态、用 go_router 实现声明式路由与深链。
主要能力:技术栈固定为 Flutter(UI)、Riverpod(状态管理,不用 Provider/ChangeNotifier)、go_router(路由)、dio(带拦截器的 HTTP 客户端)、storybook_toolkit(带设备边框的组件开发)。默认不做代码生成,模型手写 fromJson/toJson;唯一例外是可选 drift(本地 SQLite),用于离线优先应用,会生成类型化查询代码。
使用方式:用 asdf 管理 Flutter 及工具版本,例如 asdf plugin add flutter、asdf set flutter latest,并生成 .tool-versions;不使用官方安装器、mise 等。项目根目录可创建 .mcp.json 接入 dart mcp-server,以便驱动应用、检查组件、截图与分析文件。常用命令包括 flutter pub get、flutter run -d macos、flutter run -d chrome、flutter analyze lib/;依赖一律用 flutter pub add 添加,不直接编辑 pubspec.yaml。架构分层为 Screens→Providers→Repositories→API/本地数据库,页面不直接调用仓库,仓库为抽象接口并提供真实与假实现,假实现通过 Riverpod override 注入测试与 Storybook。
适用场景:需要统一 Flutter 工程结构、状态管理与路由方案的新项目或功能开发,以及离线优先、组件驱动开发与 CI 质量门禁(flutter analyze、dart format 检查、flutter test)。
限制:资料未提供具体收费、价格与效果数据;drift 与 riverpod_lint 的兼容性、macOS 权限与签名等细节需参考其配套文档,部分内容暂未提供。