CommunitySchreiben & Editierengithub.com

steipete/release-mac-app

macOS App Release: Sparkle, Notarisierung, GitHub Release, Homebrew, Abschluss.

Was ist release-mac-app?

Diese Fähigkeit automatisiert den gesamten Release-Prozess für macOS-Apps, die Sparkle für Updates verwenden, wie BlackBar, RepoBar, CodexBar oder Trimmy. Sie kümmert sich um die Notarisierung, das Signieren mit Developer ID, das Erstellen von Appcast-Dateien, das Veröffentlichen auf GitHub und das Aktualisieren von Homebrew-Taps. Der Release-Ablauf wird durch ein Manifest (`.mac-release.env`) gesteuert, das pro Repository definiert wird und alle notwendigen Konfigurationen wie App-Namen, Bundle-ID, Download-URLs und Paketierungsbefehle enthält. Die Fähigkeit nutzt ein bereitgestelltes Skript `scripts/mac-release`, das verschiedene Unterbefehle bereitstellt, um den Status zu prüfen, Release-Notes zu generieren, Appcasts zu erstellen und zu verifizieren sowie den gesamten Release durchzuführen. Besonderes Augenmerk liegt auf sicherer Handhabung von Signing-Schlüsseln über die macOS Schlüsselbund oder 1Password, wobei interaktive Passwort-Dialoge vermieden werden. Die Fähigkeit unterstützt plattformspezifische Workflows wie nicht-interaktives Developer-ID-Signing mit einem dedizierten, austauschbaren Schlüsselbund, der für die Release-Automatisierung reserviert ist.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/release-mac-app

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Mac App Release

Verwenden für BlackBar, RepoBar, CodexBar, Trimmy und ähnliche macOS-Apps, die mit Sparkle aktualisiert werden.

Regeln

  • Arbeite im App-Repository.
  • Lese .mac-release.env; es ist das repositoreigene Release-Manifest.
  • Verwende scripts/mac-release aus dieser Fähigkeit für gemeinsame Release-/Appcast-/Verifizierungsarbeiten.
  • Behalte app-spezifisches Build-/Package-/Signierverhalten in Repo-Skripten, es sei denn, es wird bereits durch das Manifest gesteuert.
  • Gib niemals privates Schlüsselmaterial aus.
  • Bevorzuge das Signieren mit dem macOS-Schlüsselbund. SPARKLE_PRIVATE_KEY_FILE ist nur eine explizite Überschreibung.

Befehle

/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release status
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release notes [version] [output.md]
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release changelog-html <version> [CHANGELOG.md]
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release make-appcast <zip> [feed-url]
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release verify-appcast [version]
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release check-assets [tag]
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release release
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release codesign-run [--with-package-secrets] -- <command> [args...]

Manifest

Jedes Repository besitzt .mac-release.env. Es darf keine Geheimnisse enthalten.

Erforderlich:

  • MAC_RELEASE_APP_NAME
  • MAC_RELEASE_REPO
  • MAC_RELEASE_BUNDLE_ID
  • MAC_RELEASE_VERSION_FILE
  • MAC_RELEASE_APPCAST
  • MAC_RELEASE_FEED_URL
  • MAC_RELEASE_DOWNLOAD_URL_PREFIX
  • MAC_RELEASE_APP_ZIP
  • entweder MAC_RELEASE_INFO_PLIST oder MAC_RELEASE_SUPUBLIC_ED_KEY
  • MAC_RELEASE_PACKAGE_CMD

Häufig optional:

  • MAC_RELEASE_PRECHECK
  • MAC_RELEASE_SOURCE_FILES (durch Leerzeichen getrennte App-Helferdateien, die vor der Erweiterung von Artefaktnamen geladen werden sollen)
  • MAC_RELEASE_DSYM_ZIP
  • MAC_RELEASE_REQUIRE_DSYM=0 für reine App-Releases
  • MAC_RELEASE_ARTIFACT_PREFIX
  • MAC_RELEASE_TAG_SIGNED
  • MAC_RELEASE_TAG_FORCE
  • MAC_RELEASE_RELEASE_BRANCH
  • MAC_RELEASE_SPARKLE_ACCOUNT
  • MAC_RELEASE_SPARKLE_CHANNEL
  • MAC_RELEASE_GENERATE_APPCAST_ARGS
  • MAC_RELEASE_RUN_SPARKLE_UPDATE_TEST
  • MAC_RELEASE_SIGNING_KEY_FILE (nur lokaler Fallback-Pfad; der Schlüsselbund wird verwendet, wenn die Datei nicht vorhanden ist)
  • MAC_RELEASE_EXTRA_ASSET_PATTERNS
  • MAC_RELEASE_EXTRA_ASSET_WAIT_SECONDS
  • MAC_RELEASE_EXTRA_ASSET_WAIT_INTERVAL
  • MAC_RELEASE_OP_ITEM + MAC_RELEASE_OP_FIELDS für erforderliche Paketierungsgeheimnisse. Der Release-Helfer liest das bekannte Element einmal über op innerhalb einer persistenten tmux-Sitzung und exportiert dann die angeforderten Felder für den Paketierungsbefehl.
  • MAC_RELEASE_OP_ACCOUNT standardmäßig my.1password.com; MAC_RELEASE_OP_VAULT, MAC_RELEASE_OP_TMUX_SESSION, MAC_RELEASE_OP_WAIT_SECONDS sind optional. Ohne einen Tresor wird das Service-Account-Token-Umgebungsvariable für diesen einzelnen op-Lesevorgang entfernt, sodass das persönliche Desktop-Konto dies übernimmt.
  • MAC_RELEASE_CODESIGN_IDENTITY + MAC_RELEASE_CODESIGN_OP_ITEM + MAC_RELEASE_CODESIGN_KEYCHAIN_MANAGED=1 ermöglichen nicht-interaktives Developer-ID-Signing. Der Schlüsselbund muss austauschbar, für die Release-Automatisierung reserviert, vom Standard-Schlüsselbund getrennt, nicht für die interaktive Nutzung freigegeben sein und genau einen privaten Signierschlüssel enthalten. Der Helfer besitzt und kann die Partitions-ACL dieses Schlüssels dauerhaft auf apple-tool:,apple:,codesign: normalisieren. Nach der Vorprüfung liest derselbe tmux-Anmelde-Pass keychain_path und keychain_password, nimmt eine benutzerspezifische Release-Sperre, übergibt das Passwort über einen privaten Dateideskriptor an ein CLI-PTY, stellt den Schlüsselbund voran, ohne vorhandene Schlüsselbünde zu verstecken, verifiziert eine Developer-ID-Application-Canary, begrenzt das Paketsignieren durch einen temporären codesign --keychain-Shim, stellt dann den transienten Zustand wieder her, verriegelt den Schlüsselbund erneut und gibt die Sperre frei.
  • MAC_RELEASE_CODESIGN_OP_ACCOUNT, MAC_RELEASE_CODESIGN_OP_VAULT, MAC_RELEASE_CODESIGN_OP_USE_SERVICE_ACCOUNT, MAC_RELEASE_CODESIGN_OP_PATH_FIELD und MAC_RELEASE_CODESIGN_OP_PASSWORD_FIELD überschreiben die Standardeinstellungen für das Codesign-Anmeldeelement; Konto, Tresor und Service-Account-Modus erben andernfalls die Einstellungen des primären Elements. Setze Tresor leer und Service-Account-Mode auf 0 für ein persönliches Desktop-Konto-Element. MAC_RELEASE_CODESIGN_KEYCHAIN + MAC_RELEASE_CODESIGN_KEYCHAIN_PASSWORD können stattdessen direkt angegeben werden.
  • MAC_RELEASE_RUN_LOGIN_SHELL=1 schaltet Befehlshooks zurück auf bash -lc; Standard-Hooks verwenden env -u BASH_ENV bash -c, sodass Shell-Startup-Dateien exportierte Release-Geheimnisse nicht überschreiben können.

1Password-Regeln:

  • Bevorzuge bereits exportierte Umgebungsvariablen; kein op-Aufruf, wenn alle MAC_RELEASE_OP_FIELDS vorhanden sind.
  • Wenn Felder fehlen, lese die konfigurierten Paket- und Codesign-Elemente in einem tmux-Befehl für das gesamte Release.
  • Verwende den Service-Account-Modus nur mit einem expliziten Tresor oder MAC_RELEASE_OP_USE_SERVICE_ACCOUNT=1.
  • Wiederhole op-Lesevorgänge nicht in einer neuen Shell; führe sie nur aus derselben tmux-Sitzung nach expliziter Benutzeranweisung erneut aus.
  • Erlaube niemals, dass ein Release die App-Paketierung mit einem unvorbereiteten Developer-ID-Schlüsselbund erreicht. Keine SecurityAgent-Passwortfenster während des Releases; schlage zuerst bei der Signatur-Canary fehl.
  • Verwende für Nicht-App-Release-Skripte codesign-run anstatt die Schlüsselbund-Einrichtung in das Repository zu kopieren. Gib die Codesign-Manifest-Felder über .mac-release.env oder explizite MAC_RELEASE_CODESIGN_*-Umgebungskonfiguration an. Es lädt standardmäßig nur Codesign-Anmeldeinformationen; übergib --with-package-secrets, wenn das eingebundene Release-Skript auch die konfigurierten Paket-/Notar-Felder im selben 1Password-Durchlauf benötigt. Es führt die gebundene Signatur-Canary aus, begrenzt codesign über den verwalteten Schlüsselbund-Shim und stellt den Zustand wieder her/verriegelt erneut, bevor es zurückkehrt.
  • Deaktiviere Shell-xtrace und verbose-Modus vor dem Laden von Release-Geheimnissen. Rüste Bereinigung vor Schlüsselbund-/Suchlisten-Mutationen, stelle die ursprüngliche Sperrrichtlinie und die Benutzersuchliste des dedizierten Schlüsselbunds wieder her und verriegele ihn nach der Paketierung erneut.

Erledigt

  • appcast-Eintrag hat URL, Länge, Sparkle-Signatur.
  • heruntergeladener Anhang wird mit Sparkle verifiziert.
  • extrahierte App besteht codesign, spctl und stapler validate.
  • GitHub-Release enthält App-Zip, dSYM-Zip (wenn konfiguriert) sowie app-spezifische zusätzliche Assets.
  • Release-Notes stimmen mit dem Changelog-Abschnitt überein.
  • Nach verifiziertem Release: Erhöhe Changelog auf nächsten Patch Unreleased im App-Repository.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Verwandte Skills