Agent Skills › robinebers/openusage › build-and-run-macos-app

build-and-run-macos-app

GitHub

用于在 macOS 项目中创建或更新 build_and_run.sh 脚本，作为默认构建和运行入口。支持 Xcode 和 SwiftPM，可处理应用停止、构建及启动流程，并提供调试、日志等模式。

.agents/skills/build-and-run-macos-app/SKILL.md robinebers/openusage

Trigger Scenarios

需要为 macOS 项目设置统一的构建和运行脚本初始化或更新项目的本地构建自动化脚本

Install

npx skills add robinebers/openusage --skill build-and-run-macos-app -g -y

More Options

Non-standard path

npx skills add https://github.com/robinebers/openusage/tree/main/.agents/skills/build-and-run-macos-app -g -y

Use without installing

npx skills use robinebers/openusage@build-and-run-macos-app

指定 Agent (Claude Code)

npx skills add robinebers/openusage --skill build-and-run-macos-app -a claude-code -g -y

安装 repo 全部 skill

npx skills add robinebers/openusage --all -g -y

预览 repo 内 skill

npx skills add robinebers/openusage --list

SKILL.md

Frontmatter

{
    "name": "build-and-run-macos-app",
    "description": "Slash command that creates or updates the project-local macOS `script\/build_and_run.sh` and uses it as the default build\/run entrypoint. Invoke explicitly with \/build-and-run-macos-app — this skill never self-triggers.",
    "disable-model-invocation": true
}

Build And Run macOS App

Create or update the project-local macOS build_and_run.sh script, then use that script as the default build/run entrypoint.

Arguments

scheme: Xcode scheme name (optional)
workspace: path to .xcworkspace (optional)
project: path to .xcodeproj (optional)
product: SwiftPM executable product name (optional)
mode: run, debug, logs, telemetry, or verify (optional, default: run)
app_name: process/app name to stop before relaunching (optional)

Workflow

Detect whether the repo uses an Xcode workspace, Xcode project, or SwiftPM package.
If the workspace is not inside git yet, run git init at the project root so git-backed editor features unlock.
Create or update script/build_and_run.sh so it always stops the current app, builds the macOS target, and launches the fresh result.
For SwiftPM, keep raw executable launch only for true CLI tools; for AppKit/SwiftUI GUI apps, create a project-local .app bundle and launch it with /usr/bin/open -n.
Support optional script flags for --debug, --logs, --telemetry, and --verify.
Follow the canonical bootstrap contract in ../build-run-debug/references/build-script.md for the exact script shape.
Run the script in the requested mode and summarize any build, script, or launch failure.

Guardrails

Do not initialize a nested git repo inside an existing parent checkout.
Keep the no-flag script path simple: kill, build, run.
Use --debug, --logs, --telemetry, or --verify only when the user asks for those modes.