用途:该技能面向 Flutter 与 Dart 开发,用于在编写或审查代码时套用统一的工程规范,覆盖 Widget 组合、状态管理、平台集成与性能优化。
主要能力:核心规则要求适配既有项目架构并保持整洁代码,使用 Flutter 3.x 特性与 Material 3 设计,落实空安全、命名约定、Widget 组合与拆分、const 构造、Widget key 与布局原则。功能规则要求采用 BLoC 模式的整洁架构、状态管理原则、依赖注入(GetIt)、错误处理。通用最佳实践补充平台特定设计指南与本地化技术。性能规则涉及图片缓存、列表优化、build 方法优化、状态管理模式、内存管理、平台通道与编译优化。
铁律与反模式:始终对不依赖可变状态的 Widget 使用 const 构造;禁止在 build() 中直接执行异步操作;始终用 BLoC、Riverpod 或同类模式分离业务逻辑与 UI;禁止用 setState 管理跨 Widget 共享状态;完整实现空安全,不对用户或网络数据使用 ! 强制解包。反模式表列出非 const 无状态 Widget、在 build() 中调用 Future、Widget 内写业务逻辑、setState 处理跨组件状态、强制解包可空 API 数据,并给出对应正确做法。
使用方式:资料提供记忆协议,开始前执行 cat .claude/context/memory/learnings.md,完成后记录新发现的模式或例外;并提示上下文可能重置,未写入记忆即视为未发生。
适用场景:Flutter 项目代码编写与评审、架构与状态管理选型、性能与内存优化、平台集成与本地化。
限制:资料未提供安装命令、收费、价格、平台支持范围或具体效果数据;该技能由 1 个独立技能合并而成,其余细节暂未提供。