CommunityRédaction et éditiongithub.com

steipete/release-mac-app

Automatisation de la publication d'applications macOS : Sparkle, notarisation, GitHub Release, Homebrew, clôture.

Qu'est-ce que release-mac-app ?

Cette compétence (skill) pour agents IA permet d'automatiser entièrement le processus de publication d'applications macOS mises à jour via Sparkle, comme BlackBar, RepoBar, CodexBar ou Trimmy. Elle gère la signature de code, la notarisation, la génération de l'appcast Sparkle, la création d'une release GitHub, et la mise à jour du fichier CHANGELOG. Le système s'appuie sur un manifeste `.mac-release.env` dans le dépôt pour configurer tous les paramètres (nom, identifiant bundle, commandes de paquetage). Les secrets tels que les clés de signature Sparkle et les certificats 1Password sont lus depuis 1Password via une session tmux persistante, ce qui évite leur affichage dans les logs. La compétence inclut également un mécanisme de signature Developer ID non interactive en créant un trousseau dédié, et un binaire `codesign-run` qui permet aux scripts de release de l'agent de bénéficier du même environnement signé sans dupliquer la configuration du trousseau.

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

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Publication d'application macOS

À utiliser pour BlackBar, RepoBar, CodexBar, Trimmy et applications macOS similaires mises à jour via Sparkle.

Règles

  • Travailler depuis le dépôt de l'application.
  • Lire .mac-release.env ; il s'agit du manifeste de publication appartenant au dépôt.
  • Utiliser scripts/mac-release de cette compétence pour le travail partagé de publication/appcast/vérification.
  • Conserver le comportement de construction/empaquetage/signature spécifique à l'application dans les scripts du dépôt, sauf s'il est déjà piloté par le manifeste.
  • Ne jamais afficher le matériel de clé privée.
  • Privilégier la signature Sparkle via le trousseau (Keychain). SPARKLE_PRIVATE_KEY_FILE est un remplacement explicite uniquement.

Commandes

/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...]

Manifeste

Chaque dépôt possède .mac-release.env. Il ne doit contenir aucun secret.

Obligatoires :

  • 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
  • soit MAC_RELEASE_INFO_PLIST soit MAC_RELEASE_SUPUBLIC_ED_KEY
  • MAC_RELEASE_PACKAGE_CMD

Optionnels courants :

  • MAC_RELEASE_PRECHECK
  • MAC_RELEASE_SOURCE_FILES (fichiers d'aide de l'application séparés par des espaces à sourcer avant d'étendre les noms des artefacts)
  • MAC_RELEASE_DSYM_ZIP
  • MAC_RELEASE_REQUIRE_DSYM=0 pour les publications sans dSYM
  • 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 (chemin de repli local uniquement ; le trousseau est utilisé si le fichier est absent)
  • 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 pour les secrets d'empaquetage requis. L'assistant de publication lit l'élément connu une fois via op dans une session tmux persistante, puis exporte les champs demandés pour la commande de paquetage.
  • MAC_RELEASE_OP_ACCOUNT par défaut my.1password.com ; MAC_RELEASE_OP_VAULT, MAC_RELEASE_OP_TMUX_SESSION, MAC_RELEASE_OP_WAIT_SECONDS sont optionnels. Sans coffre, le jeton de compte de service est désactivé pour cette unique lecture op, de sorte que le compte de bureau personnel le gère.
  • MAC_RELEASE_CODESIGN_IDENTITY + MAC_RELEASE_CODESIGN_OP_ITEM + MAC_RELEASE_CODESIGN_KEYCHAIN_MANAGED=1 activent la signature Developer ID non interactive. Le trousseau doit être remplaçable, dédié à l'automatisation des publications, séparé du trousseau par défaut, non partagé avec une utilisation interactive, et contenir exactement une clé privée de signature. L'assistant possède et peut normaliser de manière permanente la liste de contrôle de partition (ACL) de cette clé en apple-tool:,apple:,codesign:. Après la pré-vérification, la même passe d'identification de session tmux lit keychain_path et keychain_password, prend un verrou de publication par utilisateur, fournit le mot de passe via un descripteur de fichier privé à un PTY CLI, ajoute le trousseau sans masquer les trousseaux existants, vérifie un canary Developer ID Application, limite la signature du paquet via un shim temporaire codesign --keychain, puis restaure l'état transitoire, reverrouille et libère le verrou.
  • MAC_RELEASE_CODESIGN_OP_ACCOUNT, MAC_RELEASE_CODESIGN_OP_VAULT, MAC_RELEASE_CODESIGN_OP_USE_SERVICE_ACCOUNT, MAC_RELEASE_CODESIGN_OP_PATH_FIELD et MAC_RELEASE_CODESIGN_OP_PASSWORD_FIELD remplacent les valeurs par défaut de l'élément d'identification codesign ; le compte, le coffre et le mode compte de service héritent sinon des paramètres de l'élément principal. Définir un coffre vide et le mode compte de service sur 0 pour un élément de compte de bureau personnel. MAC_RELEASE_CODESIGN_KEYCHAIN + MAC_RELEASE_CODESIGN_KEYCHAIN_PASSWORD peuvent être fournis directement à la place.
  • MAC_RELEASE_RUN_LOGIN_SHELL=1 réactive les hooks de commande dans bash -lc ; les hooks par défaut utilisent env -u BASH_ENV bash -c afin que les fichiers de démarrage du shell ne puissent pas surcharger les secrets de publication exportés.

Règles 1Password :

  • Privilégier les variables d'environnement déjà exportées ; aucun appel op si tous les MAC_RELEASE_OP_FIELDS sont présents.
  • Si des champs sont manquants, lire les éléments de paquetage et de codesign configurés en une seule commande tmux pour toute la publication.
  • Utiliser le mode compte de service uniquement avec un coffre explicite ou MAC_RELEASE_OP_USE_SERVICE_ACCOUNT=1.
  • Ne pas relire op dans un shell frais ; relancer uniquement depuis la même session tmux après une directive explicite de l'utilisateur.
  • Ne jamais permettre à une publication d'atteindre l'empaquetage de l'application avec un trousseau Developer ID non préparé. Pas de fenêtre de mot de passe SecurityAgent pendant la publication ; échouer d'abord le canary de signature.
  • Pour les scripts de publication non applicatifs, utiliser codesign-run au lieu de copier la configuration du trousseau dans le dépôt. Fournir les champs du manifeste de codesign via .mac-release.env ou une configuration explicite de variable d'environnement MAC_RELEASE_CODESIGN_*. Il charge uniquement les identifiants de codesign par défaut ; passer --with-package-secrets lorsque le script de publication encapsulé a également besoin des champs de paquetage/notaire configurés dans le même passage 1Password. Il exécute le canary de signature limité, encapsule codesign via le shim du trousseau géré, et restaure/reverrouille avant de revenir.
  • Désactiver les modes xtrace et verbose du shell avant de charger les secrets de publication. Armer le nettoyage avant les mutations du trousseau/de la liste de recherche, restaurer la politique de verrouillage originale du trousseau dédié et la liste de recherche utilisateur, et le reverrouiller après l'empaquetage.

Terminé

  • L'entrée appcast a l'URL, la longueur et la signature Sparkle.
  • L'enclosure téléchargée est vérifiée par Sparkle.
  • L'application extraite passe les vérifications codesign, spctl et stapler validate.
  • La release GitHub contient le zip de l'application, le zip dSYM si configuré, ainsi que les ressources supplémentaires spécifiques à l'application.
  • Les notes de version correspondent à la section du changelog.
  • Après une publication vérifiée, mettre à jour le changelog en ajoutant Unreleased pour la prochaine version de correctif dans le dépôt de l'application.

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.

Skills associés