daveebbelaar/bama

选用指南

AI 根据 README 整理 · 2026/10/28 08:21:29

适用场景

适用于从零开始构建 macOS 应用、克隆现有应用的外观和功能、规划用户故事、进行设计、编码、测试和优化等场景。

查看 README 依据

**1. Clone** Your agent opens the app you like and screenshots every screen. It writes a screen index. </td> <td width="33%" valign="top"> **2. Plan** It turns the screens into user stories with checkable acceptance criteria, in milestones. </td> <td width="33%" valign="top"> **3. Build** It builds one story per commit. Before each commit it snapshots every page in light and dark mode and runs the tests. </td> </tr> </table> ## Skills <table> <tr><th>Stage</th><th>Skill</th><th>What it does</th></tr>

<tr><td rowspan="3" valign="top"><b>Start</b></td><td nowrap><a href="skills/start/bama/SKILL.md"><samp>bama</samp></a></td><td>Router: finds where you are and calls the right skill</td></tr> <tr><td nowrap><a href="skills/start/app-brief/SKILL.md"><samp>app-brief</samp></a></td><td>Turns an idea into a one-page brief</td></tr> <tr><td nowrap><a href="skills/start/new-mac-app/SKILL.md"><samp>new-mac-app</samp></a></td><td>A working app from a template: Swift package, SwiftData, build script, snapshot mode, git</td></tr>

<tr><td rowspan="3" valign="top"><b>Plan</b></td><td nowrap><a href="skills/plan/research/SKILL.md"><samp>research</samp></a></td><td>Parallel researcher agents: market, users, features, design, macOS APIs</td></tr> <tr><td nowrap><a href="skills/plan/clone/SKILL.md"><samp>clone</samp></a></td><td>Screenshots every screen of any app with computer use or a browser, writes a screen index</td></tr> <tr><td nowrap><a href="skills/plan/user-stories/SKILL.md"><samp>user-stories</samp></a></td><td>A backlog with checkable acceptance criteria, in milestones</td></tr>

使用方式

通过命令行安装，例如使用 npx skills@latest add daveebbelaar/bama，然后向代理发出指令，如“克隆我的待办事项应用为原生 Mac 应用”。也可作为 Claude Code 或 Codex 的插件安装。

查看 README 依据

[](LICENSE) **[Quick start](#quick-start) · [How it works](#how-it-works) · [Skills](#skills) · [Specs](#specs) · [Install](#install)** </div> ## Quick start ```bash npx skills@latest add daveebbelaar/bama ``` Then ask your agent: ```text Clone my to-do app as a native Mac app. Screenshot every screen, write the user stories, and build milestone 1. ``` Not sure where to start? Type `/bama`. It looks at your project and picks the next skill. ## How it works <table> <tr> <td width="33%" valign="top">

## Specs Not sure what to build? [specs/](specs/) has 12 build plans for small Mac apps: a window snapper, a window switcher, a launcher, clipboard history, screenshots, a screen recorder, and more. I took them apart from Onyx, my own menu bar app. Copy one into an empty folder and tell your agent: ```text Build the app in window-snapper.md with BAMA. ``` ## Install Pick one route per agent. Two routes install every skill twice. <details open> <summary><b>Claude Code</b></summary> ```text /plugin marketplace add daveebbelaar/bama /plugin install bama@bama ``` </details> <details>

部署要求

需要 macOS 26 或更高版本，以及 Xcode 26 或更高版本（用于 Swift 6.2 工具链，但无需打开）。需要一个支持 skills 的代理，如 Claude Code、Codex、Cursor 或 Gemini CLI。对于克隆原生应用，需要 computer use（Claude Pro 或 Max）。

查看 README 依据

bama/scripts/link-skills.sh # links every skill into ~/.claude/skills and ~/.agents/skills ``` </details> ## Requirements - macOS 26 or later - Xcode 26 or later, for the Swift 6.2 toolchain (you never open it) - An agent that supports skills: Claude Code, Codex, Cursor, Gemini CLI - For `clone` on native apps: computer use (Claude Pro or Max) ## Credits - The idea and the "any" promise come from [REA: Reverse Engineer Anything](https://github.com/morluto/rea) by morluto. REA showed that an agent can reverse engineer any app. BAMA takes that idea to the Mac.

已知限制

克隆原生应用需要 computer use 功能（Claude Pro 或 Max）。

查看 README 依据

bama/scripts/link-skills.sh # links every skill into ~/.claude/skills and ~/.agents/skills ``` </details> ## Requirements - macOS 26 or later - Xcode 26 or later, for the Swift 6.2 toolchain (you never open it) - An agent that supports skills: Claude Code, Codex, Cursor, Gemini CLI - For `clone` on native apps: computer use (Claude Pro or Max) ## Credits - The idea and the "any" promise come from [REA: Reverse Engineer Anything](https://github.com/morluto/rea) by morluto. REA showed that an agent can reverse engineer any app. BAMA takes that idea to the Mac.