SuperAPI AI 工具集

build-macos-app

通用与其它

查看项目

更新于 10-16 06:45

技能介绍

用途:面向原生 macOS SwiftUI/AppKit 应用的构建、审计与发布。触发场景包括新建脚手架、功能开发、重新设计、审计、从 macOS 14/15 迁移到 macOS 26(Tahoe)、质量钩子配置、快照测试、Convex + Clerk 云同步以及发布前检查。仓库中若含 .xcodeproj、.xcworkspace、Package.swift 或 macOS 应用目标的 Swift 文件即适用;仅 iOS/iPadOS/visionOS/watchOS/tvOS、无应用表面的通用 Swift 包、纯服务端 Convex/TypeScript 及非 Apple Swift 不在范围内。

主要能力:按请求路由到不同操作,包括 Bootstrap(新建项目)、Build(新增视图/窗口/命令)、Redesign(原生化、Liquid Glass 改造)、Audit(HIG 与设计预检)、Migrate(迁移到 macOS 26)、Install hooks(SwiftLint、SwiftFormat、pre-commit、CI)、Add visual tests(快照截图校验)、Wire cloud sync(Convex、Clerk、实时查询)与 Ship(发布清单)。HIG 始终为基线,Liquid Glass 为 macOS 26+ 的叠加视觉层,内容区域不用玻璃效果;Liquid Glass API 需用 #available(macOS 26, *) 并回退 NSVisualEffectView 或标准 SwiftUI。

核心规则(三条法律):每个动作都可从菜单栏触达;标准快捷键保留(Cmd-N/O/S/Shift-S/Z/Shift-Z/Q/W/Comma/F/A/C/V/X);设置即时生效,不设 Save/Cancel/Apply。写视图代码前先回答三个问题:是导航还是内容?唯一主操作是什么?是否与 Finder、Mail、Photos、Settings 并排仍显原生?

质量钩子:使用 git config core.hooksPath .githooks,禁止直写 .git/hooks;typecheck 需以 SWIFT_HOOK_TYPECHECK=1 选择启用;不得未经确认安装全局工具;不得提交空的 SwiftLint 基线。需从技能根复制 assets/swiftlint.yml、assets/swiftformat、assets/githooks/pre-commit、assets/scripts/swift-typecheck.sh 及 GitHub Actions 配置。

云同步:仅在涉及 ConvexMobile、ClerkKit、ClerkConvex、实时查询或鉴权云数据时启用;默认 Clerk 作为 Swift 鉴权路径,最低版本 clerk-convex-swift >= 0.1.0、clerk-ios >= 1.0.0、convex-swift >= 0.8.0;每进程一个 @MainActor 长期客户端,使用 ClerkKitUI 的 AuthView() 与 UserButton();Swift SDK 为在线重连而非离线优先;该路径仅支持 Apple Silicon macOS。不得承诺乐观更新、离线持久化、Catalyst、Intel Mac、watchOS、tvOS 或 visionOS 支持;不得信任客户端传入的 userId,以服务端 Clerk JWT 身份为授权边界;Convex 查询内不用 Date.now();Subscription 终止失败后需重建。

限制:Liquid Glass 目标为 macOS 26+ 与 Xcode 26 SDK;Clerk + Convex 仅限 Apple Silicon。资料未提供具体价格、计费方式或性能指标。