SuperAPI AI 工具集

coding-standards-enforcer

编程与开发

查看项目

更新于 10-16 00:20

技能介绍

用途:当 Swift 源码变更需要判断是否符合仓库的并发、观察与现代 API 标准时使用本技能。先分类工作类型(Swift 6.2 构建设置/语言模式、MainActor 与 actor 隔离/Sendable、Observation @Observable 与 SwiftUI @State/@Bindable 所有权、现代 API/风格/安全清理),只加载与类别匹配的参考文件。

审查顺序:先看编译器诊断与隔离边界,再看所有权与观察模型,最后看 API 现代化与安全。对偏差要明确修复或标注,不能让违规处于隐含状态。

参考文件加载时机:references/standards-review-map.md 用于审查顺序、路由与仓库级标准地图;references/concurrency-guidelines.md 用于 actor、@MainActor、Sendable、Task、async let、任务组或严格并发诊断;references/observation-modeling.md 用于 Observation @Observable、@ObservationIgnored、SwiftUI @State、@Bindable、@Binding 或类型化环境数据流;references/modern-swift-apis.md 用于 API 现代化、Foundation 替代、格式化、字符串匹配、强制解包或 Swift 原生风格。

工作流:检查变更的 Swift 文件并记录主要失败类别;加载最窄的相关参考文件;应用能恢复合规的最小改动;如可用则重新构建或重跑受影响的测试范围;总结已修复项、有意保留项与剩余迁移债务。

限制与边界:不要强加笼统的 @MainActor 策略,隔离选择须匹配所有权与运行时行为;新 SwiftUI 或 visionOS 代码中,除非用户明确说明兼容性约束或现有架构无法脱离 Combine 观察,不引入 ObservableObject、@StateObject、@ObservedObject;不要用不必要的 Task.detached、DispatchQueue.main.async 或 @unchecked Sendable 来“修复”并发警告;不要凭记忆假设 Swift 6.2 默认 actor 隔离;语义会改变时不要机械现代化 API。若核心问题是场景所有权、功能拆分或跨界面状态放置,切换到 spatial-app-architecture;若主阻塞是构建失败或运行时问题,切换到 build-run-debug;若主要是缩小失败测试范围,切换到 test-triage。输出应包含审查的文件或符号、应用的规范类别、已修复或仍存在的具体违规、所用验证步骤,以及阻塞不再是规范问题时的下一个技能。部分产品细节、收费与价格信息暂未提供。