daveebbelaar/bama

BAMA（构建任何 Mac 应用） 是一组代理技能，帮助 AI 编码代理将想法或现有应用转化为用 Swift 和 SwiftUI 编写的原生 macOS 应用。它设计为无需打开 Xcode 的图形界面即可工作——所有操作都通过代码和命令行工具完成。

功能：

• 你给代理一个提示，例如“将我的待办事项应用克隆为原生 Mac 应用”或“使用 BAMA 构建 window-snapper.md 中的应用”。
• 代理遵循三步流程：克隆（截取你喜欢的应用的每个屏幕并编写屏幕索引）、规划（将屏幕转化为带有验收标准的用户故事，并分组为里程碑）和构建（每个提交实现一个故事，在每次提交前拍摄浅色/深色快照并运行测试）。
• /bama 命令充当路由器：它检查你的项目并选择下一个合适的技能。

技能（共 21 个）：

• 开始： bama（路由器）、app-brief（将想法转化为一页简报）、new-mac-app（从模板创建可工作的应用，包含 SwiftData、构建脚本、快照模式、git）。
• 规划： research（并行研究市场、用户、功能、设计、macOS API）、clone（通过计算机使用或浏览器截取任何应用的屏幕）、user-stories（带有可检查验收标准的待办事项）。
• 代码： swift-swiftui（Swift 6 并发、状态、SwiftData、AppKit 桥接）、os-integrations（热键、菜单栏、浮动面板、屏幕捕获、快捷指令、URL 方案、CLI、权限）、performance（测量并修复主线程、GPU、图像、Instruments）、improve-architecture（每次提交重构一个热点）、agent-cli（可选 CLI 和 MCP 服务器用于外部控制）。
• 设计： ux-design（名称、流程、功能打开位置、可访问性）、mac-design（Liquid Glass、布局、工具栏、菜单、深色模式）、design-system（原生外观，带强调色、令牌、规则）、layout-grid（4pt 网格，带对齐检查）、design-kit（自定义部件、图标集、每个状态、部件库）、design-from-app（从截图重建应用外观，逐像素比较）、app-icon（Liquid Glass 图标，作为 Icon Composer 文件）。
• 发布： build-and-verify（构建、安装、在浅色/深色模式下截取每个页面）、test-mac-app（Swift Testing、应用内自测、调试桥接）、improve-loop（每次提交处理一个待办事项，直到里程碑完成）。

规格：

• specs/ 文件夹包含 12 个小型 Mac 应用的构建计划（窗口捕捉器、窗口切换器、启动器、剪贴板历史、截图、屏幕录制等）。你可以将一个复制到空文件夹中，并让代理构建它。

安装：

• 对于 Claude Code：/plugin marketplace add daveebbelaar/bama 然后 /plugin install bama@bama。
• 对于 Codex：codex plugin marketplace add daveebbelaar/bama 然后 codex plugin add bama@bama。
• 对于 任何其他代理（Cursor、Gemini CLI、Copilot）：使用 npx skills@latest add daveebbelaar/bama -a <agent>（或 --skill=clone 用于单个技能）。
• 手动安装：git clone https://github.com/daveebbelaar/bama.git 然后运行 bama/scripts/link-skills.sh 将技能链接到 ~/.claude/skills 和 ~/.agents/skills。

要求：

• macOS 26 或更高版本
• Xcode 26 或更高版本（用于 Swift 6.2 工具链，但你永远不会打开它）
• 支持技能的代理（Claude Code、Codex、Cursor、Gemini CLI）
• 对于原生应用的 clone 技能：计算机使用（Claude Pro 或 Max）

致谢：

• 想法和“任何”承诺来自 REA: Reverse Engineer Anything 的 morluto。
• 技能格式遵循 Matt Pocock 的 skills 和他的 writing-for-agents 技能。
• 与 Paul Hudson 的 SwiftUI Pro 和 Antoine van der Lee 的 SwiftUI Expert 配合良好。

许可证： MIT。