К основному содержанию
скилл CX Codex

build-and-verify — скилл для Claude Code: сборка и проверка

Скилл build-and-verify для Claude Code собирает SwiftUI-приложение для macOS и проверяет снимки страниц в двух темах. Агент запускает его после изменений интерфейса, ошибок сборки или просьбы проверить приложение.

MIT 1 000 установок ★ 1 933 обновлён 2026-11-05

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add daveebbelaar/bama --skill build-and-verify -a claude-code
Открыть на GitHub

Что делает build-and-verify

Скилл собирает приложение командой ./build.sh, устанавливает его и делает снимки каждой страницы и вкладки настроек в светлой и тёмной темах. Затем проверяет снимки, запускает тесты сетки и проверку взаимодействий; изменения интерфейса не считаются завершёнными по одному лишь исходному коду.

Для снимков используется тестовая база в /tmp, а не пользовательская база данных. Приложению, которое запускает screencapture, нужно разрешение Screen Recording: без него боковые панели и стеклянные элементы могут отображаться пустыми. Если проект не создан из шаблона new-mac-app, сначала нужно сопоставить команды через existing-app.md.

Скилл также предписывает открыть каждый PNG и проверить компоновку, читаемость тёмной темы и соответствие задаче. После успешной сборки и проверки снимков агент запускает tools/selftest.sh, добавляет проверки для новых действий и фиксирует изменения коммитом.

Какие задачи решает

  • собрать SwiftUI-приложение из командной строки
  • проверить страницы приложения в светлой и тёмной темах
  • найти обрезанный текст и пустые области в интерфейсе
  • проверить сетку макета и новые действия приложения

Примеры запросов агенту

  • После изменений интерфейса собери приложение и проверь снимки всех страниц.
  • Сборка завершилась с ошибкой — найди причину и повтори сборку.
  • Запусти приложение и проверь его интерфейс в светлой и тёмной темах.

Как установить build-and-verify

1Через Skills CLI (Vercel)

npx skills add daveebbelaar/bama --skill build-and-verify -a claude-code

2Вручную: положить файлы

~/.claude/skills/build-and-verify/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/build-and-verify/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о build-and-verify

Как установить build-and-verify в Claude Code?

Выполни npx skills add daveebbelaar/bama --skill build-and-verify -a claude-code. Скилл появится в ~/.claude/skills/build-and-verify/SKILL.md.

Что делает build-and-verify?

Скилл собирает SwiftUI-приложение для macOS, сохраняет снимки его страниц в двух темах, проверяет макет и запускает тесты взаимодействий.

Какое разрешение нужно для снимков build-and-verify?

Приложению, которое запускает screencapture — например, Terminal или Claude, — нужно разрешение Screen Recording в настройках macOS.

Исходный текст

SKILL.md · MIT
---
name: build-and-verify
description: Build a SwiftUI macOS app from the command line, install it, and check light and dark window snapshots of every page before calling a change done. Use after any UI code change, when a build fails, or when the user asks to run, screenshot, or check the app.
allowed-tools: Bash(./build.sh*) Bash(swift *) Bash(tools/*) Bash(*/Contents/MacOS/*) Bash(open *) Read
---

# Build and verify

A change is done when four things are true:

1. `./build.sh` finishes with no errors.
2. You looked at the light and dark snapshots of every page you touched.
3. The snapshots match what the user story or reference screenshot asks for.
4. The grid checks pass (`layout-grid` skill).

App not made from the `new-mac-app` template (Xcode, XcodeGen, a menu bar
utility, Swift 5)? Map the commands below with
[existing-app.md](existing-app.md) first.

Do not report a UI change as done from the code alone. SwiftUI code that
compiles can still render an empty sidebar, clipped text, or unreadable dark
mode.

## 1. Build

```bash
./build.sh            # release build, installs ~/Applications/<AppName>.app
./build.sh --debug    # faster build while iterating
./build.sh --open     # also restarts the app so the user sees the new build
```

Read the errors, fix them, and build again. Fix the first error first: later
errors often come from it. If a new file is "not in scope" right after you
created it, run `swift package clean --scratch-path ~/Library/Developer/<AppName>/build`.

## 2. Snapshot

Run the installed binary directly with a test database and a folder for the
images. The app opens, walks through every sidebar page and every Settings
tab in light and dark mode, saves one PNG per page and mode, and quits.

```bash
tools/snap.sh
# SNAPSHOT /tmp/<AppName>-shots/all-light.png
# ...
# SNAPSHOT done /tmp/<AppName>-shots
```

`tools/snap.sh` deletes the old test store (with its `-wal` and `-shm`
files) and the saved window state first, then runs with sample data
(`APP_SEED=1`). Without that, seed data goes stale, and one crashed run
leaves a "reopen windows?" alert that hangs every later run.

Use `APP_SNAPSHOT_PAGES=today,inbox` to limit the pages. Add `settings` to
include the Settings tabs.

In every image, look for three bugs agents often miss: a focus ring or
selected text that nobody asked for, a scroll bar with nothing to scroll,
and an empty band under short content. The fixes are in `mac-design`,
"Windows open calm".

To see scroll bars as people with a mouse see them, add
`-AppleShowScrollBars Always` after the binary path. It changes only this
run.

Always use `APP_STORE` with a path in `/tmp`. Never take snapshots against the
user's real database in `~/Library/Application Support/<AppName>/`.

### Seed data

Empty pages only show empty states. The template's
`Sources/<AppName>/SeedData.swift` fills an empty test store when
`APP_SEED=1` is set. Grow it with the app: 10 to 20 items with long and
short titles, dates in the past and future, every priority and status, and
only what a person can create in the app.

### Screen Recording permission

Snapshots use `screencapture -l <window>`, which shows glass, sidebars, and
materials exactly as on screen. It needs Screen Recording permission for the
app that runs the command (Terminal, Ghostty, or Claude). If a snapshot line
ends with `(fallback: ...)`, the permission is missing and sidebars and glass
render blank. Ask the user to allow it in System Settings > Privacy &
Security > Screen & System Audio Recording, then restart the terminal.

### Missing snapshots

If every snapshot fails, or `screencapture` says "could not create image
from window", the display is probably asleep: an unattended Mac turns it
off. The template's snapshot mode wakes the display itself. For captures
from outside the app (like `window-shot.sh`), run `caffeinate -u -t 2` first.

If some states print "no window" while others work, another app hid yours
during the run. Computer use does this to apps it does not control, and so
does Hide Others. The template's snapshot mode un-hides the app and brings
the window forward before each capture. Run it again, and avoid using
computer use in another session at the same time.

## 3. Check the grid

```bash
tools/grid-lint.sh
swift tools/check-layout.swift /tmp/<AppName>-shots/*-layout.json
```

Both print PASS. On a FAIL, call the Skill tool with `layout-grid`: it has
the rules, the overlay, and a table of fixes.

## 4. Look

Open every PNG with the Read tool and check, in this order:

- Nothing is blank, clipped, or overlapping. Text fits. Sidebars show their items.
- Dark mode is readable. No fixed white or black surfaces.
- The page matches the story or the reference screenshot (layout, labels, order).
- The `mac-design` rules hold: glass only on controls, one accent,
  SF Symbols, system text styles, empty states that invite the first action.

Describe what you see in one or two sentences per page in your report, and
name the PNG paths so the user can open them.

## 5. Interaction checks

Snapshots show state, not behavior. Run `tools/selftest.sh` (exit 0 when
every check passes) and add a check for each new action. The
`test-mac-app` skill covers unit tests, the self-test, key events, the
menu check from outside, and a debug bridge.

### Inactive windows

Gray traffic lights mean the window was not key when it was captured:
sidebar text, selection, and toggles look dimmer than in use. A snapshot of
an inactive window does not count as reviewed. Run the snapshots again
while nobody else uses the screen, and do not "fix" dim text you only see
there.

### Debug output and private screens

A GUI app started with its output going to a file buffers `print`, and the
lines are lost when the process is killed. Write debug lines to stderr
(`FileHandle.standardError.write`) behind an environment flag.

Do not take full-screen captures to check your app: they show the user's
other windows. Capture your own window, or add a mode to the app that
renders the state you want to see (prefilled text, an open sheet).

## 6. Commit

When the build is clean and the snapshots look right, commit with a message
that says what the user can now do: "Add tasks from the quick-add panel",
not "Update views".

Done when the four conditions at the top hold and the change is committed.

© daveebbelaar · MIT · daveebbelaar/bama

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
cmux-debugging manaflow-ai Скилл cmux-debugging для Claude Code и других платформ: добавляет отладочные логи и диагностирует проблемы UI и рантайма в cmux — терминальный рендеринг, вкладки, drag-and-drop, разные версии macOS. CX Codex +1 5 000установок build-swiftui-interface memi-design Скилл build-swiftui-interface задаёт правила проектирования и проверки интерфейсов SwiftUI для iOS и macOS. Помогает агенту учитывать доступность, состояния экранов и проверки в Xcode. CX Codex +1 ★ 51звёзд репо build-macos-apps Lex Christopherson Скилл build-macos-apps для Claude Code помогает создавать и развивать нативные macOS-приложения на SwiftUI и AppKit. Он подключается к задачам сборки, отладки, тестирования, оптимизации и выпуска. CX Codex +1 ★ 1 988звёзд репо verify-pi-gui raylee-ai Скилл verify-pi-gui для Claude Code проверяет основные диалоги pi-gui через видимый интерфейс Electron и реального провайдера. Он запускает сценарии отправки, потоковой выдачи, переключения веток, инструментов и перезапуска. CX Codex +1 ★ 364звёзд репо macos-design-guidelines platform-design-skills Скилл macos-design-guidelines передаёт агенту правила Apple Human Interface Guidelines для macOS. Он пригодится при вёрстке меню, окон и клавиатурных сокращений на SwiftUI или AppKit. CX Codex +1 4 600установок swiftui-design-skill wholiver Скилл swiftui-design-skill помогает проектировать экраны SwiftUI для iOS и macOS без шаблонного визуала. Пригодится при вёрстке прототипов и подборе дизайн-направления с нуля. CX Codex +1 1 300установок

Из того же набора21

Весь набор →
research Скилл research для Claude Code собирает онлайн-исследование перед разработкой macOS-приложения. Запускает параллельных субагентов для сравнения приложений, отзывов и возможностей macOS. CX Codex +1 1 000установок improve-loop Скилл improve-loop для Claude Code ведёт разработку macOS-приложения по историям из docs/STORIES.md. Он собирает приложение, сравнивает снимки экранов с образцами и фиксирует готовые истории в Git. CX Codex +1 1 000установок agent-cli Скилл agent-cli для Claude Code, Codex и Cursor добавляет командную строку и MCP-сервер к macOS-приложению, чтобы ИИ управлял им через локальный сокет. CX Codex +1 1 000установок performance Скилл performance для Claude Code, который измеряет нагрузку на CPU, память и энергию в macOS-приложениях. Помогает находить причины зависаний и переносить вычисления с основного потока на GPU. CX Codex +1 1 000установок improve-architecture Скилл improve-architecture для Claude Code разбирает архитектуру macOS-приложения на Swift и планирует безопасный рефакторинг. Срабатывает перед крупной функцией, в конце этапа или при повторяющихся проблемах в одной области. CX Codex +1 1 000установок app-brief Скилл app-brief для Claude Code и Cursor создаёт одностраничный файл docs/BRIEF.md для нового приложения под macOS до написания кода. CX Codex +1 1 000установок design-from-app Скилл design-from-app для Claude Code воссоздает дизайн любого приложения в виде нативной дизайн-системы SwiftUI по скриншотам. CX Codex +1 1 000установок os-integrations Скилл os-integrations для Claude Code помогает выбрать API macOS и нужные разрешения для системных функций приложения. Включается при добавлении глобальных горячих клавиш, захвата экрана или управления окнами других приложений. CX Codex +1 1 000установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой