CommunityRedacción y edicióngithub.com

steipete/release-mac-app

Publicación de apps para macOS: Sparkle, notarización, GitHub Release, Homebrew y cierre.

¿Qué es release-mac-app?

Este skill automatiza el proceso completo de release de aplicaciones macOS que utilizan Sparkle para actualizaciones. Es ideal para apps como BlackBar, RepoBar, CodexBar o Trimmy, y gestiona tareas como firma de código, notarización, subida de assets a GitHub, generación de appcast de Sparkle, verificación de integridad y actualización del changelog. Funciona principalmente con repositorios que poseen un manifiesto `.mac-release.env` y un script compartido `scripts/mac-release`. Soporta firmado con llaves de Sparkle desde Keychain, firma de Developer ID no interactiva con un llavero dedicado, y recuperación de credenciales desde 1Password en una sola sesión tmux persistente. El skill está diseñado para agentes de IA como Claude Code, Cursor o Codex, y proporciona comandos para estado, notas de release, generación de appcast, verificación, y ejecución del release completo.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Publicación de App macOS

Útil para BlackBar, RepoBar, CodexBar, Trimmy y otras apps macOS que se actualizan mediante Sparkle.

Reglas

  • Trabaja desde el repositorio de la app.
  • Lee .mac-release.env; es el manifiesto de release propiedad del repositorio.
  • Usa scripts/mac-release de este skill para tareas compartidas de release/appcast/verificación.
  • Mantén el comportamiento específico de compilación/empaquetado/firma de la app en scripts del repositorio, a menos que ya esté controlado por manifiesto.
  • Nunca imprimas material de llave privada.
  • Prefiere la firma Sparkle desde el Llavero. SPARKLE_PRIVATE_KEY_FILE es una anulación explícita solo.

Comandos

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

Manifiesto

Cada repositorio es dueño de .mac-release.env. No debe contener secretos.

Obligatorio:

  • 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
  • ya sea MAC_RELEASE_INFO_PLIST o MAC_RELEASE_SUPUBLIC_ED_KEY
  • MAC_RELEASE_PACKAGE_CMD

Opcionales comunes:

  • MAC_RELEASE_PRECHECK
  • MAC_RELEASE_SOURCE_FILES (archivos auxiliares de la app separados por espacios para cargar antes de expandir nombres de artefactos)
  • MAC_RELEASE_DSYM_ZIP
  • MAC_RELEASE_REQUIRE_DSYM=0 para releases solo de app
  • 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 (ruta de respaldo local únicamente; se usa el Llavero cuando el archivo no está presente)
  • 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 para secretos de empaquetado requeridos. El asistente de release lee el ítem conocido una vez mediante op dentro de una sesión tmux persistente, luego exporta los campos solicitados para el comando de empaquetado.
  • MAC_RELEASE_OP_ACCOUNT por defecto es my.1password.com; MAC_RELEASE_OP_VAULT, MAC_RELEASE_OP_TMUX_SESSION, MAC_RELEASE_OP_WAIT_SECONDS son opcionales. Sin bóveda, el token de la cuenta de servicio se desactiva para esa única lectura de op para que la cuenta de escritorio personal lo maneje.
  • MAC_RELEASE_CODESIGN_IDENTITY + MAC_RELEASE_CODESIGN_OP_ITEM + MAC_RELEASE_CODESIGN_KEYCHAIN_MANAGED=1 habilita la firma no interactiva de Developer ID. El llavero debe ser reemplazable, dedicado a la automatización de releases, separado del llavero predeterminado, no compartido con uso interactivo y contener exactamente una llave privada de firma. El asistente es dueño y puede normalizar permanentemente la ACL de partición de esa llave a apple-tool:,apple:,codesign:. Después de la preverificación, la misma sesión tmux lee keychain_path y keychain_password, toma un bloqueo de release por usuario, suministra la contraseña a través de un descriptor de archivo privado a un PTY de CLI, antepone el llavero sin ocultar los llaveros existentes, verifica un canary de Developer ID Application, delimita la firma del paquete mediante un shim temporal de codesign --keychain, luego restaura el estado transitorio, vuelve a bloquear y libera el bloqueo.
  • MAC_RELEASE_CODESIGN_OP_ACCOUNT, MAC_RELEASE_CODESIGN_OP_VAULT, MAC_RELEASE_CODESIGN_OP_USE_SERVICE_ACCOUNT, MAC_RELEASE_CODESIGN_OP_PATH_FIELD y MAC_RELEASE_CODESIGN_OP_PASSWORD_FIELD anulan los valores predeterminados del ítem de credenciales de codesign; de lo contrario, la cuenta, la bóveda y el modo de cuenta de servicio heredan la configuración del ítem principal. Establece la bóveda vacía y el modo de cuenta de servicio en 0 para un ítem de cuenta de escritorio personal. MAC_RELEASE_CODESIGN_KEYCHAIN + MAC_RELEASE_CODESIGN_KEYCHAIN_PASSWORD se pueden suministrar directamente en su lugar.
  • MAC_RELEASE_RUN_LOGIN_SHELL=1 hace que los hooks de comando vuelvan a usar bash -lc; los hooks predeterminados usan env -u BASH_ENV bash -c para que los archivos de inicio del shell no puedan anular los secretos de release exportados.

Reglas de 1Password:

  • Prefiere variables de entorno ya exportadas primero; no llames a op si todos los MAC_RELEASE_OP_FIELDS están presentes.
  • Si faltan campos, lee los ítems configurados de paquete y codesign en un solo comando tmux para todo el release.
  • Usa el modo de cuenta de servicio solo con una bóveda explícita o MAC_RELEASE_OP_USE_SERVICE_ACCOUNT=1.
  • No reintentes lecturas op en un shell nuevo; vuelve a ejecutar solo desde la misma sesión tmux después de una instrucción explícita del usuario.
  • Nunca permitas que un release llegue al empaquetado de la app con un llavero de Developer ID no preparado. Sin ventanas de contraseña de SecurityAgent durante el release; primero falla el canary de firma.
  • Para scripts de release que no son de la app, usa codesign-run en lugar de copiar la configuración del llavero en el repositorio. Proporciona los campos del manifiesto de codesign a través de .mac-release.env o configuración explícita de entorno MAC_RELEASE_CODESIGN_*. Carga solo credenciales de codesign por defecto; pasa --with-package-secrets cuando el script de release envuelto también necesita los campos de paquete/notaría configurados en la misma pasada de 1Password. Ejecuta el canary de firma acotado, delimita codesign mediante el shim de llavero gestionado y restaura/vuelve a bloquear antes de devolver el control.
  • Desactiva el modo xtrace y verbose del shell antes de cargar los secretos de release. Prepara la limpieza antes de las mutaciones del llavero/lista de búsqueda, restaura la política de bloqueo original del llavero dedicado y la lista de búsqueda del usuario, y vuelve a bloquearlo después del empaquetado.

Hecho

  • La entrada del appcast tiene URL, tamaño, firma Sparkle.
  • El enclosure descargado se verifica con Sparkle.
  • La app extraída pasa codesign, spctl y stapler validate.
  • El release de GitHub tiene el zip de la app, el zip de dSYM cuando está configurado, y assets extra específicos de la app.
  • Las notas de release coinciden con la sección del changelog.
  • Después del release verificado, se incrementa el changelog a la próxima versión parche Unreleased en el repositorio de la app.

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 relacionados