关于 flutter-navigation
面向 Flutter 开发者的导航技能,指导围绕应用状态设计路由,涵盖 URL、深层链接、状态恢复、认证重定向和嵌套导航,并强调保留现有路由方案。
主要功能
- 01检查路由与平台需求
- 02验证类型化路由和参数
- 03设计确定性重定向
- 04保持多导航器的返回行为
- 05处理深层链接与状态恢复
- 06将导航副作用移出 build
适用场景
- 01审查现有 Flutter 路由
- 02为安全目的地添加深层链接
- 03支持标签页历史与嵌套导航
- 04测试重定向和导航恢复
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ thienqo/ flutter-skills --skill flutter-navigation安装后在 Claude Code 中输入/flutter-navigation确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
evals/cases.jsonreferences/deep-link-and-restoration.mdnested-shell-navigation.md详细介绍
Flutter 导航
当 URL、深层链接、状态恢复或多个导航器需要将导航建模为应用状态时,请这样做;对于真正局部的流程,则使用更简单的命令式导航。
先检查
确认当前路由器、路由归属、身份验证流程、标签页/外壳结构、支持的平台、URL 要求和状态恢复预期。除非要求迁移,否则保留现有路由包。
规则
- 路由名称、路径参数和参数解码应采用类型化方式,或进行集中验证。
- 让重定向逻辑具有确定性,并避免重定向循环。
- 保留 Android 系统返回、浏览器历史记录、iOS 手势、嵌套导航器和模态界面中的预期返回行为。
- 仅在标签页外壳等具有独立历史记录的场景中使用嵌套导航。
- 将深层链接解析为符合领域规则的安全状态,并为未知或未经授权的目标定义处理方式。
- 不要在 widget 的
build方法之外执行导航副作用。 - 不要将大型领域对象直接放入 URL 或状态恢复数据中。
验证
测试冷启动深层链接、热启动链接、前进/后退行为、身份验证重定向、无效参数、所需场景下的状态恢复,以及每个受支持外壳/标签页的历史记录。
参考资料
涉及标签页外壳模式或独立返回历史记录时,请遵循嵌套外壳导航参考。 处理深层链接或状态恢复时,请遵循深层链接与状态恢复参考。
来源
评论
支持 Markdown