BAMA:任意 Mac 应用构建技能包
把喜欢的应用重做成你自己的原生 Mac 应用:用 Swift 与 SwiftUI,由 Agent 技能完成从调研到上架 Dock 的全流程。
- Star 数
- ★ 1.9k
- 最近更新
- 16 天前
- License
- MIT
- 主语言
- Swift
- FA 评分
- 61/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 独立开发者看到一个喜欢的待办或笔记类应用,想把它复刻成只属于自己的原生 Mac 应用
- 不适合
- 仍在使用 macOS 15 或更早系统的团队
- 希望用 Flutter、Electron 等跨平台方案一次覆盖多端的开发者
- 没有 Claude Pro/Max 订阅却要克隆原生应用界面的用户
- 维护状态
- 近 30 天有提交最近提交 2026-11-05最新版本 bama--v1.1.1(2026-11-05)近 7 天每天 +17.1 ★
- 源码审查
- 61/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
BAMA 是一套面向编码 Agent 的 macOS 应用构建技能集,仓库中共有 21 个技能,覆盖 Start、Plan、Code、Design、Ship 五个阶段。它以 Claude Code 插件、Codex 插件或 skills.sh 技能包的形式交付,让 Agent 通过 computer use 截取目标应用的每个界面、编写用户故事与验收标准,再用 Swift 6.2 与 SwiftUI 逐个里程碑地实现,全程不需要打开 Xcode 图形界面。技能层面明确分工:swift-swiftui 处理并发与 SwiftData,os-integrations 处理全局快捷键、菜单栏与权限,design-from-app 依据截图逐像素比对还原视觉,build-and-verify 在浅色与深色模式下对每个页面截图核查。仓库还提供 specs/ 下 12 份小型 Mac 应用构建方案,可复制到空目录后直接交给 Agent 执行。产物是一个本地数据、原生窗口的 Mac 应用,运行时要求 macOS 26 与 Xcode 26 工具链。
Agent 读取 BAMA 提供的 SKILL.md 指令文件后按阶段执行:clone 技能用 computer use 或浏览器截取目标应用的全部界面并写出 screen index;research 技能并行启动多个研究 Agent 分析市场、用户、功能、设计与 macOS API;user-stories 技能产出带可勾选验收标准的里程碑 backlog;new-mac-app 技能从模板生成 Swift package、SwiftData 持久层、构建脚本、快照模式与 git 仓库;swift-swiftui、os-integrations、performance、improve-architecture 等技能负责具体编码与性能修复;design 系列技能输出 4 pt 栅格校验、设计令牌与 Icon Composer 图标;build-and-verify 与 test-mac-app 负责构建安装、Swift Testing 自测、浅色深色快照比对与 Agent 可驱动的调试桥。最终每个用户故事对应一次提交。
- 独立开发者看到一个喜欢的待办或笔记类应用,想把它复刻成只属于自己的原生 Mac 应用
- 需要给现有 mac 工具补齐全新的 SwiftUI 界面,并让 Agent 在无 Xcode 图形界面的环境下完成编译与截图核对
- 想从一个空目录快速起步:把 specs/ 里的 window-snapper.md 等方案复制进去,让 Agent 直接搭出可运行骨架
- 产品经理希望把截图转成带验收标准的里程碑 backlog,再由编码 Agent 逐条实现
- 团队要在每个提交前自动获得浅色/深色两套界面快照与单元测试结果,作为回归依据
- 希望为自己构建的 Mac 应用额外提供一个命令行或 MCP 服务器,让 Claude Code、Codex 与脚本可以驱动它
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npx skills@latest add daveebbelaar/bama -a <agent>npx skills@latest add daveebbelaar/bama --skill=clone
- 安装说明涉及
- macOS
如何安装或部署这个 Agent?
任选一种安装途径,不要在同一 Agent 上叠加两种,否则技能会被安装两次。
Claude Code:
/plugin marketplace add daveebbelaar/bama
/plugin install bama@bamaCodex:
codex plugin marketplace add daveebbelaar/bama
codex plugin add bama@bama其他 Agent(Cursor、Gemini CLI、Copilot 等)通过 skills.sh 安装,也可用 --skill 只装单个技能:
npx skills@latest add daveebbelaar/bama -a <agent>
npx skills@latest add daveebbelaar/bama --skill=clone手动安装:
git clone https://github.com/daveebbelaar/bama.git
bama/scripts/link-skills.sh运行环境需要 macOS 26 或更高版本与 Xcode 26(Swift 6.2 工具链),克隆原生应用界面时需要 computer use 能力(Claude Pro 或 Max)。
如何使用这个 Agent?
安装后直接向 Agent 描述目标,或输入 /bama 让路由技能根据当前项目状态挑选下一步。
Clone my to-do app as a native Mac app.
Screenshot every screen, write the user stories, and build milestone 1.没有现成想法时,把 specs/ 中的方案复制到空目录后再指示 Agent:
Build the app in window-snapper.md with BAMA.之后 Agent 会按里程碑推进:每个用户故事一次提交,提交前对所有页面做浅色与深色快照并运行测试。
这个 Agent 有哪些优点和局限?
- 21 个技能按 Start/Plan/Code/Design/Ship 分阶段组织,边界清晰,Agent 可按需单独加载某个技能
- 克隆流程把截图、screen index、用户故事、验收标准到逐提交实现串成闭环,产物可审计
- build-and-verify 与 layout-grid 把浅色/深色快照、4 pt 栅格检查纳入提交前流程,界面问题可自动暴露
- 附带 specs/ 下 12 份现成的小型 Mac 应用构建方案,从零起步不必先想产品
- 同时提供 Claude Code 插件、Codex 插件与 skills.sh 通道,对多数主流编码 Agent 可用
- 硬性要求 macOS 26 与 Xcode 26,旧系统用户无法使用
- 克隆原生应用界面依赖 computer use,需要 Claude Pro 或 Max 订阅
- 产品本身免费但实际使用要自备 Agent 的模型额度,成本不可忽略
- 文档明确警告同一 Agent 上安装两条路由会导致技能重复注册
- 仓库以技能指令与模板为主,构建质量的最终保障仍取决于所用 Agent 的执行能力
这个 Agent 与同类方案有什么区别?
README 点名了三个参照项目:morluto 的 REA(Reverse Engineer Anything)提供了“逆向任意应用”的原始思路;Matt Pocock 的 skills 仓库定义了技能格式与写作规则;Paul Hudson 的 SwiftUI Pro 与 Antoine van der Lee 的 SwiftUI Expert 是可搭配使用的 SwiftUI 技能。另提供面向 Windows 的姊妹项目 BAWA:Build Any Windows App。
与相关度最高的同类 agent 并排比较关键指标。
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
os-integrations 明确要求“优先选择无需权限的 API”,权限在用到时申请并解释,agent-cli 将破坏性命令默认只报告、需 --yes 才执行,这些体现了最小权限与用户确认(各 2)。performance 技能明确警告 .trace 会包含 shell 令牌、不得提交或分享,属于敏感数据处理(2)。但数据流透明性仅靠架构图示意,未说明 socket 通信的访问控制或数据去向(1);依赖安全方面仅提到 npx skills@latest 与外部 skills.sh,无锁定或校验说明(1);回滚方面只有“旧路径保留一个里程碑”的局部提示,缺少整体撤销机制(1);来源归属在 README Credits 中明确致谢 REA、Matt Pocock 等(2)。
AGENTS.md 与 README、plugin.json 的技能清单一致,写作规则自洽(2)。依赖可用性方面要求 macOS 26+/Xcode 26/Swift 6.2 等前沿环境,且 clone 依赖 computer use(Claude Pro/Max),门槛高且未提供降级路径(1)。失败信息方面 agent-cli 要求 AgentError 附带修复提示,性能技能给出具体诊断命令(2)。
面向 Claude Code、Codex、Cursor、Gemini CLI 多代理,场景覆盖从想法到发布(2)。capability_boundaries 通过“CLI/MCP/App Intents”对比表和“可选”标注划清边界(2)。触发精度上各 SKILL.md 的 description 采用“Use when”加分支触发,较精确(2)。环境适配限定 macOS 26+,Windows 用户被引导至 BAWA,边界清晰但覆盖面窄(2)。
信息架构按 start/plan/code/design/ship 五阶段组织,结构清晰(3)。安装说明提供 Claude Code、Codex、其他代理、手动四种路径并警告不要重复安装(3)。命名稳定性有 plugin.json 版本号与发布流程,但技能名与目录耦合、未见弃用策略(2)。示例与 FAQ 有 Quick start 与 specs 示例,但无独立 FAQ(2)。已知限制仅零散提及(如 clone 需 computer use),无集中限制章节(1)。MIT 许可证完整(3)。版本管理有 plugin.json version 与发布步骤,但无 CHANGELOG(2)。维护责任仅指向个人作者,无治理或联系方式说明(1)。
输出可用性上技能给出可检查的“Done when”与具体命令,产物较可用(2)。边际价值在于把 macOS 原生开发流程结构化,但部分内容与通用 SwiftUI 技能重叠(2)。成本收益上技能数量多、上下文开销需按需加载,整体合理但未量化(2)。
claim_traceability 方面 README 的“21 skills”“12 specs”等声明与 plugin.json 部分对应,但 specs 未在包内全部可见,无法完全核实(1)。cross_source_corroboration 上 README、AGENTS.md、plugin.json 相互印证技能清单,但缺少测试或运行证据(1)。fact_inference_separation 上文档多为指导性断言,未区分已验证事实与建议(1)。
- 依赖 macOS 26+/Xcode 26/Swift 6.2 等前沿环境,clone 技能还需 computer use(Claude Pro/Max),普通用户可能无法满足。
- 通过 npx skills@latest 与外部 skills.sh 安装,未提供版本锁定或完整性校验,存在供应链风险。
- agent-cli 通过私有 socket 让代理驱动运行中的应用,socket 的访问控制与数据流向未在文档中说明。
- 发布者身份未经 FollowAgents 企业注册表验证,维护责任仅指向个人作者。
- README 声称的 21 个技能与 12 个 specs 未在包内全部可见,无法完全核实。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
bama--v1.1.1 BAMA 1.1.1
发布说明摘录
What's Changed * Fix the app shell's grid guidance and check edges across areas by @daveebbelaar in https://github.com/daveebbelaar/bama/pull/16 * Release 1.1.1 by @daveebbelaar in https://github.com/daveebbelaar/bama/pull/17 Full Changelog: https://github.com/daveebbelaar/bama/compare/bama--v1.1.0...bama--v1.1.1在 GitHub 查看 ↗ -
bama--v1.1.0 BAMA 1.1.0
发布说明摘录
What's Changed * Update the screenshots and launcher specs from Onyx by @daveebbelaar in https://github.com/daveebbelaar/bama/pull/3 * Keep new-app.sh going when the folder already has files by @daveebbelaar in https://github.com/daveebbelaar/bama/pull/5 * Find the app bundle when the agent CLI runs from PATH by @daveebbelaar in https://github.com/daveebbelaar/bama/pull/6 * Point Windows users to BAWA in the README by @daveebbelaar in https://github.com/daveebbelaar/bama/pull/9 …在 GitHub 查看 ↗
常见问题
BAMA 本身是一个模型或应用吗?
为什么必须 macOS 26 与 Xcode 26?
克隆某个应用会不会用到它的源码或资源?
同一个 Agent 能同时用插件和 skills.sh 安装吗?
支持 Windows 吗?
BAMA:任意 Mac 应用构建技能包 免费吗?
BAMA:任意 Mac 应用构建技能包 安全吗?
BAMA:任意 Mac 应用构建技能包 还在维护吗?
BAMA:任意 Mac 应用构建技能包 是谁开发的?
谢谢反馈,我们会据此改进页面。