SuperAPI AI 工具集

axiom-audit-swiftui-architecture

编程与开发

查看项目

更新于 10-16 03:37

技能介绍

用途:审查 SwiftUI 架构,既查已知反模式,也查缺失或不完整的关注点分离,目标是发现不可测试、难维护、脆弱的代码。范围限于架构违规(视图内逻辑、不可测试边界),不处理微性能问题(格式化、排序),除非同时属于架构违规;性能问题应改用 swiftui-performance-analyzer。修复建议必须指明具体抽取目标(模型、计算属性、服务),不能只说“重构”。

主要能力:强制使用工具扫描,要求执行 Glob、Grep、Read,不得凭训练数据推理;每个 Grep 模式单独运行,不合并为巨型正则。排除 Tests.swift、Previews.swift、/Pods/、/Carthage/、/.build/、/DerivedData/、/scratch/、/docs/、/.claude/、/.claude-plugin/。

流程:Phase 1 映射视图/模型边界,识别架构模式(原生 SwiftUI、MVVM、TCA、coordinator)、逻辑位置、依赖注入、状态管理与可测试性,输出 8-12 行架构边界图。Phase 2 检测五类反模式:视图 body 内逻辑(HIGH)、异步边界违规(CRITICAL)、属性包装器误用(HIGH,如非 private 的 @State 复制父级数据)、God ViewModel(MEDIUM,超过 20 个存储属性或混合领域)、可测试性边界违规(MEDIUM,非 View 类型 import SwiftUI)。Phase 3 推理架构完整性,检查缺失项,如无单测的视图逻辑、超 100 行 body、模式不一致、模型内部状态暴露、视图自建依赖、导航与业务纠缠、跨视图重复逻辑。Phase 4 交叉引用,将组合问题升级严重度,并标注与其他审计器的重叠。Phase 5 输出架构健康评分表,评级为 CLEAN / TANGLED / MONOLITHIC。

使用方式:当用户提到 SwiftUI 架构审查、关注点分离、可测试性问题或“视图内逻辑”问题时触发;也可直接以 axiom-audit-swiftui-architecture 调用。输出包含架构边界图、按严重度分级的问题列表(文件、阶段、问题、影响、修复、跨审计器备注)与建议。

限制:超过 50 个同类问题只显示前 10 并给出总数与前 3 个文件;超过 100 个问题按类别汇总,仅详列 CRITICAL/HIGH。明确列出误报情形,如简单委托 Task { await viewModel.load() }、私有 @State 字面量初始化、小于 30 行视图的内联格式化、仅用值类型的设计系统 import SwiftUI、极小应用中的 God ViewModel、简单视图中小集合的 filter/sorted。相关工具包括 axiom-swiftui、swiftui-performance-analyzer、swiftui-nav-auditor、swift-simplifier。