用途:当用户提到 SwiftUI 布局审查、自适应布局问题、GeometryReader 问题或多设备布局检查时使用。该技能扮演 SwiftUI 布局审查智能体,既检测已知反模式,也排查缺失或不完整的自适应策略。
主要能力:强制使用 Glob、Grep、Read 等工具逐条扫描代码,排除 *Tests.swift、*Previews.swift、Pods、Carthage、.build、DerivedData、scratch、docs、.claude 等路径。流程分为五阶段:先绘制布局策略图(识别 GeometryReader、onGeometryChange、ViewThatFits、AnyLayout、containerRelativeFrame、size class 等用法,以及固定尺寸、硬编码断点、废弃 API);再运行 12 项检测模式,包括堆栈内无约束 GeometryReader、UIScreen.main 与 UIDevice.current.orientation、UIRequiresFullScreen、以 size class 代替方向判断、条件切换 HStack/VStack 导致视图身份丢失、嵌套 GeometryReader、硬编码宽高断点、大于 300pt 的固定 frame、非懒加载 ForEach、仅用于相对尺寸的 GeometryReader、对交互内容使用 ignoresSafeArea、手搓工具栏行等;随后推理布局完整性(iPad 分屏、最小宽度、身份保持、滚动容器内 GeometryReader 等);再做跨项组合提级与健康评分。
输出:布局策略图、按严重级别的摘要、健康评分表(ADAPTIVE/RIGID/BROKEN)、按严重级别的问题明细(含文件、阶段、影响、修复建议)与建议清单;问题过多时按上限折叠。限制:证据需来自实际读取的代码,不得凭记忆推测;所有命令与模式保持原样;具体支持的最低系统版本、平台范围等细节暂未提供。