用途:在 Swift 与 SwiftUI 项目中构建、重构、审查和调试原生 Apple 平台软件,适合处理 .swift 文件、SwiftUI 视图和基于 Observation 的状态。
按任务选路线:新功能或新页面先明确目标平台、应用类型、主要操作、核心状态、导航模型和数据归属;重构保持行为不变、简化结构、让状态归属清晰;修 bug 先用失败测试复现,再列出 2 至 3 个假设后改代码;性能卡顿先代码审查再考虑性能分析;Liquid Glass 等新设计 API 使用原生材质与可用性判断,不做自定义模糊仿制;macOS 相关工作把菜单命令、键盘流程、窗口、侧边栏、工具栏和文本行为当产品需求而非润色。
核心规则:优先系统结构(NavigationStack、NavigationSplitView、TabView、List、Form、Table、Commands 和内置材质);为加载、空、错误、离线、部分和权限受限等状态设计;状态就近视图,默认用 @State、@Binding、@Environment、@Observable、@Query 和 .task;保持 body 轻量、身份稳定,不在 body 内排序、过滤、格式化、解码图像、创建 UUID 或做 I/O;用显式输入组合小视图;把无障碍与动效当一等约束,检查动态字体、VoiceOver、减弱动效、降低透明度、对比度、焦点顺序和触摸目标;遵循各平台交互习惯。
参考文档:架构与状态、UI 模式、性能与调试、macOS 质量标准、Liquid Glass。交付时先说明目标平台、应用类型和主要交互模型,架构不明显时说明状态与数据流方案,审查按正确性、平台不匹配、无障碍缺口、性能风险、风格的优先级报告,调试时给出主要假设与证据,最后给验证步骤,如测试、构建或 lint 命令、性能分析和仍需的手工检查。具体命令与价格暂未提供。