该技能是 Flutter 框架版本变更与迁移的结构化参考资料，覆盖 Flutter 1.0 至今的发布、Widget 弃用、API 替换、Material 3 设计迁移、material_ui 与 cupertino_ui 独立包的解耦，以及旧版 Flutter 代码库的抢救流程。
主要能力包括：提供弃用 API 到现代替换的对照矩阵，例如 Color.withOpacity → Color.withValues(alpha: o)、MaterialState/MaterialStateProperty → WidgetState/WidgetStateProperty、WillPopScope → PopScope、FlatButton/RaisedButton/OutlineButton → TextButton/ElevatedButton/OutlinedButton、ThemeData.accentColor → ColorScheme.secondary、Scaffold.of(context).showSnackBar() → ScaffoldMessenger.of(context).showSnackBar()、BottomNavigationBar → NavigationBar、ToggleButtons → SegmentedButton 等；说明从 SDK 内置 material/cupertino 迁移到独立包 package:material_ui/material_ui.dart、package:cupertino_ui/cupertino_ui.dart，并可用 dart fix --apply --code=migrate_design_widgets 自动改写导入；提供 Material 2 到 Material 3 的迁移指南，包括 ColorScheme.fromSeed(seedColor: ...) 的种子主题与组件现代化；提供 Flutter 到 Dart 版本矩阵；以及旧应用升级的五阶段流程：工具链检查 → 空安全桥接 → Widget 弃用修复 → Material 3 主题 → 现代路由与响应式状态。
使用方式为查阅对应主题文档，按建议的 runbook 执行替换与迁移；涉及自动修复时运行上述 dart fix 命令并确认 pubspec.yaml 依赖。适用场景为 Flutter 版本升级、弃用 API 清理、Material 3 改造与遗留项目抢救。限制：资料未说明该技能的具体安装方式、运行环境要求、收费或价格信息，也未给出各版本迁移的完整兼容性保证，实际迁移需结合项目自行验证。