用途:针对 SwiftUI 导航架构与正确性做审计,适用于用户提到 SwiftUI 导航问题、深链失效、状态恢复缺陷或导航架构评审的场景。范围限于导航架构,性能问题交由 swiftui-performance-analyzer。
主要能力:强制使用工具扫描,而非凭训练数据推断;对每个 Glob、Grep、Read 按其写法逐个执行。先在第 1 阶段生成导航架构图:识别 NavigationStack、NavigationSplitView、TabView、UINavigationController 等容器,梳理 NavigationPath、@State.*path、.navigationDestination(for:)、NavigationLink、.sheet、.fullScreenCover、.onOpenURL、@SceneStorage 的使用情况。第 2 阶段检测 10 类已知反模式:缺少 NavigationPath、深链缺口、状态恢复问题、容器误用、类型安全冲突、Tab 与导航集成、缺少状态保存、已废弃 NavigationLink API、协调器模式违规、缺少 NavigationSplitViewVisibility。第 3 阶段推理导航完整性,如孤立路径类型、深链覆盖不全、模态与栈冲突等。第 4 阶段交叉引用复合发现并升严重度。第 5 阶段给出导航健康评分(SOLID / FRAGILE / BROKEN)。
使用方式:本代理可被直接调用,调用名为 axiom-audit-swiftui-nav。输出格式为 SwiftUI Navigation Audit Results,含架构图、按严重度分组的问题(文件、行、阶段、影响、修复、跨审计器备注)以及建议。排除 Tests.swift、Previews.swift、/Pods/、/Carthage/、/.build/、/DerivedData/、/scratch/、/docs/、/.claude/、/.claude-plugin/。大于 50 个同类问题只展示前 10 并给出总数与前 3 个文件;超过 100 个问题按类别汇总,仅展开 CRITICAL / HIGH。
限制:存在明确的误报排除项,如无深链与程序化导航的纯静态导航栈、按设计不支持状态恢复时不使用 @SceneStorage、小型应用不引入协调器等。其他收费、平台或价格信息暂未提供。