分享一个开源 macOS App 脚手架 Skill：用 AI Agent 自动搭建生产级脚手架

最近写了好几个开源 macOS App 项目。我估计写过独立 macOS App 的人大概都有同感：把核心功能写出来，其实只完成了一半。剩下那一半基本都是琐事，比如：

写到一半才发现用 XcodeGen + project.yml 管理工程更舒服
GitHub Actions 怎么跑通签名 + 公证 + DMG + Release
自动更新走 Sparkle 还是自己轮询 GitHub API
开机自启用 SMAppService 的正确姿势
日志、设置窗口、辅助功能权限引导、本地化、Sandbox 开关
国际化多语言支持
……

这些东西每个单独看都不难，但加起来很耗时；交给 AI 自己摸索的话，又经常走弯路（比如选了已经废弃的 API、写出能跑但不能上架的配置）。

所以我把自己几个已上架 App 里反复用到的模式抽了出来，做成了一个 AI Agent Skill：macos-app-scaffold。丢给 AI，一次性把这些都搞定 —— 很适合睡前丢给它，早上起来全弄好了。

它做什么

一句话：新建项目 + 给已有项目按需补功能，全程交互式，不强加任何东西。

项目初始化

菜单栏 / 窗口 / 混合模式三选一
XcodeGen 作为唯一配置源
SwiftUI 启动代码、.gitignore、Git 初始化
AGENTS.md + CLAUDE.md 软链，方便多 Agent 协作

构建与分发

GitHub Actions：构建 → 签名 → 公证 → 打 DMG → 发 Release
Universal Binary（arm64 + x86_64）
推 v* tag 自动发版
多语言 Release Notes
Homebrew Cask 公式

没有 Apple 开发者账号也能用，会自动跳过签名 / 公证那几步，产物是未签名 DMG，照样能分发。

应用层常见功能

自动更新（GitHub API 轮询或 Sparkle）
开机自启（SMAppService）
辅助功能权限引导
设置窗口、文件日志、本地化、引导页
Aptabase（隐私友好的分析）

工程化

SwiftLint 默认规则
XCTest 测试 target
Sandbox 开关（带上架说明）
LICENSE（MIT / GPL-3.0 / Apache-2.0）+ 带徽章的 README

怎么用

兼容 Claude Code、Cursor、Codex、Gemini 等 40+ AI 工具。

通用安装：

1	npx skills add XueshiQiao/macos-app-scaffold

仅 Claude Code：

1	/plugin install github:XueshiQiao/macos-app-scaffold

之后三个命令就够用：

1
2
3

/macos-app-scaffold              # 自动判断是新建还是增强
/macos-app-scaffold-new MyApp    # 直接新建项目
/macos-app-scaffold-enhance      # 给已有项目按需补功能（CI/CD、自动更新、logging…）

适合谁

想做独立 macOS App、又不想在工程化琐事上耗一周的
已经有项目，但只补齐了核心功能，CI / CD、自动更新都还没做的
想让 AI 帮自己写 macOS App，但总被 AI 反复带偏走弯路的

仓库

GitHub：https://github.com/XueshiQiao/macos-app-scaffold

MIT 协议，欢迎 issue / PR，也欢迎吐槽哪些地方还能改进。