BAMA:任意 Mac 应用构建技能包

把喜欢的应用重做成你自己的原生 Mac 应用:用 Swift 与 SwiftUI,由 Agent 技能完成从调研到上架 Dock 的全流程。

Star 数
★ 1.9k
最近更新
16 天前
License
MIT
主语言
Swift

30 秒速览

运行形态
Agent 插件 / 技能命令行工具
可在哪里用
兼容但需适配Codex · Claude Code
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
macOS 26 或更高版本Xcode 26 或更高版本(Swift 6.2 工具链)带有 npx 的 Node.js(用于 skills.sh 安装)Claude Pro 或 Max(用于基于 computer use 克隆原生应用)Shell / 命令行网络访问本地文件系统
典型场景
独立开发者看到一个喜欢的待办或笔记类应用,想把它复刻成只属于自己的原生 Mac 应用
不适合
  • 仍在使用 macOS 15 或更早系统的团队
  • 希望用 Flutter、Electron 等跨平台方案一次覆盖多端的开发者
  • 没有 Claude Pro/Max 订阅却要克隆原生应用界面的用户
维护状态
近 30 天有提交最近提交 2026-11-05最新版本 bama--v1.1.1(2026-11-05)近 7 天每天 +17.1 ★

这个 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 可驱动的调试桥。最终每个用户故事对应一次提交。

  1. 独立开发者看到一个喜欢的待办或笔记类应用,想把它复刻成只属于自己的原生 Mac 应用
  2. 需要给现有 mac 工具补齐全新的 SwiftUI 界面,并让 Agent 在无 Xcode 图形界面的环境下完成编译与截图核对
  3. 想从一个空目录快速起步:把 specs/ 里的 window-snapper.md 等方案复制进去,让 Agent 直接搭出可运行骨架
  4. 产品经理希望把截图转成带验收标准的里程碑 backlog,再由编码 Agent 逐条实现
  5. 团队要在每个提交前自动获得浅色/深色两套界面快照与单元测试结果,作为回归依据
  6. 希望为自己构建的 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@bama

Codex:

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 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
BAMA:任意 Mac 应用构建技能包 当前 61 · 存在缺口 Agent 插件 / 技能免费 + 模型费 ★ 1.9k 16 天前 Swift Codex · Claude Code
Yardlet 80 · 表现良好 桌面应用免费 ★ 46 今天 Swift Codex · Claude Code
Chops 51 · 缺口较多 桌面应用免费 ★ 2.1k 2 个月前 Swift —
Perch 73 · 存在缺口 桌面应用免费 ★ 31 5 天前 Swift Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
存在缺口
61/ 100 五分制 3.1 / 5
信任安全 16/29
可靠稳定 8/14
适用触发 12/18
规范维护 13/18
有效结果 9/13
证据核验 3/8
查看各维度的扣分理由
信任安全16 / 29 · 2.8/5

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)。

可靠稳定8 / 14 · 2.9/5

AGENTS.md 与 README、plugin.json 的技能清单一致,写作规则自洽(2)。依赖可用性方面要求 macOS 26+/Xcode 26/Swift 6.2 等前沿环境,且 clone 依赖 computer use(Claude Pro/Max),门槛高且未提供降级路径(1)。失败信息方面 agent-cli 要求 AgentError 附带修复提示,性能技能给出具体诊断命令(2)。

适用触发12 / 18 · 3.3/5

面向 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)。

规范维护13 / 18 · 3.6/5

信息架构按 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)。

有效结果9 / 13 · 3.5/5

输出可用性上技能给出可检查的“Done when”与具体命令,产物较可用(2)。边际价值在于把 macOS 原生开发流程结构化,但部分内容与通用 SwiftUI 技能重叠(2)。成本收益上技能数量多、上下文开销需按需加载,整体合理但未量化(2)。

证据核验3 / 8 · 1.9/5

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 未在包内全部可见,无法完全核实。
证据充分度:低 评估于 2026年11月10日 审查版本 22dc792ea040
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/bama.svg?lang=zh)](https://followagents.com/zh/agents/bama)
<a href="https://followagents.com/zh/agents/bama"><img src="https://followagents.com/badge/bama.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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 查看 ↗
  2. 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 本身是一个模型或应用吗?
不是。它是一组给编码 Agent 读的 SKILL.md 技能与模板,实际推理与代码生成由你使用的 Claude Code、Codex、Cursor 或 Gemini CLI 完成。
为什么必须 macOS 26 与 Xcode 26?
技能面向 Swift 6.2 工具链与 macOS 26 的 Liquid Glass 设计,构建脚本依赖该版本工具链;低版本系统无法满足要求。
克隆某个应用会不会用到它的源码或资源?
clone 技能的做法是打开应用并逐屏截图,生成 screen index 作为参照,随后基于截图重写用户故事与实现,并不涉及原应用代码。
同一个 Agent 能同时用插件和 skills.sh 安装吗?
README 明确不建议:会为每个 Agent 选一条安装路径,两条路径并存会把全部技能装两遍。
支持 Windows 吗?
不支持。README 指向单独的姊妹项目 BAWA:Build Any Windows App 处理 Windows 场景。
BAMA:任意 Mac 应用构建技能包 免费吗?
软件本身免费,但 BAMA:任意 Mac 应用构建技能包 要调用 AI 模型,模型的调用费用由你向模型服务商支付(也可以接本地模型)。
BAMA:任意 Mac 应用构建技能包 安全吗?
FollowAgents 的 FARS 评审(2026年11月10日)给 BAMA:任意 Mac 应用构建技能包 的“信任与安全”打了 16/29 分。评审检查的 8 项安全措施没有完全缺失的。
BAMA:任意 Mac 应用构建技能包 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-05,在最近 30 天内。最新版本是 bama--v1.1.1(2026-11-05)。
BAMA:任意 Mac 应用构建技能包 是谁开发的?
BAMA:任意 Mac 应用构建技能包 由 GitHub 账号 daveebbelaar 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念