mcpField
F
flutter-navigation

flutter-navigation

github.com/thienqo开发1576 次安装今天更新
代码仓库

关于 flutter-navigation

面向 Flutter 开发者的导航技能,指导围绕应用状态设计路由,涵盖 URL、深层链接、状态恢复、认证重定向和嵌套导航,并强调保留现有路由方案。

主要功能

  1. 01检查路由与平台需求
  2. 02验证类型化路由和参数
  3. 03设计确定性重定向
  4. 04保持多导航器的返回行为
  5. 05处理深层链接与状态恢复
  6. 06将导航副作用移出 build

适用场景

  1. 01审查现有 Flutter 路由
  2. 02为安全目的地添加深层链接
  3. 03支持标签页历史与嵌套导航
  4. 04测试重定向和导航恢复

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/thienqo/flutter-skills --skill flutter-navigation

安装后在 Claude Code 中输入/flutter-navigation确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

evals/
cases.json
references/
deep-link-and-restoration.md
nested-shell-navigation.md

详细介绍

Flutter 导航

当 URL、深层链接、状态恢复或多个导航器需要将导航建模为应用状态时,请这样做;对于真正局部的流程,则使用更简单的命令式导航。

先检查

确认当前路由器、路由归属、身份验证流程、标签页/外壳结构、支持的平台、URL 要求和状态恢复预期。除非要求迁移,否则保留现有路由包。

规则

  • 路由名称、路径参数和参数解码应采用类型化方式,或进行集中验证。
  • 让重定向逻辑具有确定性,并避免重定向循环。
  • 保留 Android 系统返回、浏览器历史记录、iOS 手势、嵌套导航器和模态界面中的预期返回行为。
  • 仅在标签页外壳等具有独立历史记录的场景中使用嵌套导航。
  • 将深层链接解析为符合领域规则的安全状态,并为未知或未经授权的目标定义处理方式。
  • 不要在 widget 的 build 方法之外执行导航副作用。
  • 不要将大型领域对象直接放入 URL 或状态恢复数据中。

验证

测试冷启动深层链接、热启动链接、前进/后退行为、身份验证重定向、无效参数、所需场景下的状态恢复,以及每个受支持外壳/标签页的历史记录。

参考资料

涉及标签页外壳模式或独立返回历史记录时,请遵循嵌套外壳导航参考。 处理深层链接或状态恢复时,请遵循深层链接与状态恢复参考。

来源

评论

支持 Markdown