最近写了好几个的开源 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 ）+ 带徽章的
怎么用
兼容 Claude Code 、Cursor 、Codex 、Gemini 等 40+ A
通用安装：
npx skills add XueshiQiao/macos-app-scaffold
仅 Claude Code：
/plugin install github:XueshiQiao/macos-app-scaf
之后三个命令就够用：
/macos-app-scaffold # 自动判断是新建
/macos-app-scaffold-new MyApp # 直接新建
/macos-app-scaffold-enhance # 给已有项目按需 / logging ...）
适合谁
- 想做独立 macOS App 、不想在工程化琐事上耗一周的
- 已经有项目，但只补齐了核心功能，CI/CD 、自动更新还没做的
- 想让 AI 帮自己写 macOS App ，但被 AI 反复走弯路
仓库
GitHub： https://github.com/XueshiQiao/macos-app-scaffold
MIT 协议，欢迎 issue / PR ，也欢迎吐槽哪些地方还
Select Language