CommunityEscrita e Ediçãogithub.com

steipete/release-mac-app

Lançamento de aplicativos macOS: Sparkle, notarização, GitHub Release, Homebrew, encerramento.

O que é release-mac-app?

Esta skill automatiza o processo de lançamento de aplicativos macOS que utilizam o framework Sparkle para atualizações. Seu propósito é unificar e simplificar tarefas complexas como assinatura de código, notarização, criação de lançamentos no GitHub e geração de appcasts. É ideal para aplicativos como BlackBar, RepoBar, CodexBar e Trimmy. A skill é projetada para ser executada a partir do repositório do aplicativo e utiliza um arquivo de manifesto (`.mac-release.env`) para configurar todos os parâmetros do lançamento. Através de scripts shell fornecidos (localizados em `scripts/mac-release`), ela oferece comandos para verificar o status, gerar notas de lançamento, criar appcasts, verificar ativos e executar o lançamento completo. Um recurso importante é o suporte a chaves de assinatura gerenciadas pelo Keychain, com fallback para arquivos. A skill também gerencia credenciais através do 1Password, garantindo que segredos não sejam expostos. Para ambientes de automação, ela oferece um modo de assinatura de código não-interativo, que cria e gerencia um keychain dedicado para selos de Desenvolvedor, assegurando que nenhuma janela de senha interrompa o processo. Ela suporta tanto o macOS padrão quanto a automação via CI/CD, desde que o ambiente seja configurado corretamente. As plataformas suportadas são macOS e GitHub Releases, com integração opcional com Homebrew para distribuição. A lógica principal está nos scripts shell, que garantem que cada etapa do lançamento (construção, empacotamento, assinatura, notarização, upload) seja executada de forma consistente e segura.

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

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Lançamento de Aplicativos macOS

Use para BlackBar, RepoBar, CodexBar, Trimmy e aplicativos macOS similares atualizados via Sparkle.

Regras

  • Trabalhe a partir do repositório do aplicativo.
  • Leia o arquivo .mac-release.env; ele é o manifesto de lançamento de propriedade do repositório.
  • Use scripts/mac-release desta skill para o trabalho compartilhado de lançamento/appcast/verificação.
  • Mantenha o comportamento de construção/empacotamento/assinatura específico do aplicativo em scripts do repositório, a menos que já seja orientado pelo manifesto.
  • Nunca imprima material de chave privada.
  • Prefira assinatura Sparkle via Keychain. SPARKLE_PRIVATE_KEY_FILE é uma substituição explícita apenas.

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 [versão] [saída.md]
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release changelog-html <versão> [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 [versão]
/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] -- <comando> [args...]

Manifesto

Cada repositório possui seu próprio .mac-release.env. Ele não deve conter segredos.

Obrigatórios:

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

Opcionais comuns:

  • MAC_RELEASE_PRECHECK
  • MAC_RELEASE_SOURCE_FILES (arquivos auxiliares do aplicativo, separados por espaço, para carregar antes de expandir nomes de artefatos)
  • MAC_RELEASE_DSYM_ZIP
  • MAC_RELEASE_REQUIRE_DSYM=0 para lançamentos apenas do aplicativo
  • 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 (caminho de fallback local apenas; o Keychain é usado quando o arquivo está ausente)
  • 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 segredos de empacotamento necessários. O auxiliar de lançamento lê o item conhecido uma vez via op dentro de uma sessão tmux persistente, então exporta os campos solicitados para o comando de empacotação.
  • MAC_RELEASE_OP_ACCOUNT assume como padrão my.1password.com; MAC_RELEASE_OP_VAULT, MAC_RELEASE_OP_TMUX_SESSION, MAC_RELEASE_OP_WAIT_SECONDS são opcionais. Sem um cofre, o token de conta de serviço não é definido no ambiente para essa única leitura op, para que a conta pessoal da área de trabalho a manipule.
  • MAC_RELEASE_CODESIGN_IDENTITY + MAC_RELEASE_CODESIGN_OP_ITEM + MAC_RELEASE_CODESIGN_KEYCHAIN_MANAGED=1 habilita a assinatura não interativa de Developer ID. O keychain deve ser substituível, dedicado à automação de lançamentos, separado do keychain padrão, não compartilhado com uso interativo, e conter exatamente uma chave privada de assinatura. O auxiliar possui e pode normalizar permanentemente a ACL de partição dessa chave para apple-tool:,apple:,codesign:. Após a pré-verificação, a mesma transmissão de credenciais tmux lê keychain_path e keychain_password, obtém um bloqueio de lançamento por usuário, fornece a senha através de um descritor de arquivo privado para um PTY CLI, adiciona o keychain sem ocultar keychains existentes, verifica um canary de Developer ID Application, define o escopo da assinatura do pacote através de um shim temporário codesign --keychain, então restaura o estado transitório, rebloqueia e libera o bloqueio.
  • MAC_RELEASE_CODESIGN_OP_ACCOUNT, MAC_RELEASE_CODESIGN_OP_VAULT, MAC_RELEASE_CODESIGN_OP_USE_SERVICE_ACCOUNT, MAC_RELEASE_CODESIGN_OP_PATH_FIELD e MAC_RELEASE_CODESIGN_OP_PASSWORD_FIELD substituem os padrões do item de credencial codesign; conta, cofre e modo de conta de serviço, caso contrário, herdam as configurações do item principal. Defina o cofre vazio e o modo de conta de serviço como 0 para um item de conta pessoal da área de trabalho. MAC_RELEASE_CODESIGN_KEYCHAIN + MAC_RELEASE_CODESIGN_KEYCHAIN_PASSWORD podem ser fornecidos diretamente como alternativa.
  • MAC_RELEASE_RUN_LOGIN_SHELL=1 faz os hooks de comando retornarem ao bash -lc; os hooks padrão usam env -u BASH_ENV bash -c para que os arquivos de inicialização do shell não possam sobrescrever segredos de lançamento exportados.

Regras do 1Password:

  • Prefira variáveis de ambiente já exportadas primeiro; nenhuma chamada op se todos os MAC_RELEASE_OP_FIELDS estiverem presentes.
  • Se os campos estiverem faltando, leia os itens de pacote e codesign configurados em um comando tmux para todo o lançamento.
  • Use o modo de conta de serviço apenas com um cofre explícito ou MAC_RELEASE_OP_USE_SERVICE_ACCOUNT=1.
  • Não tente novamente leituras op em um shell novo; execute novamente apenas a partir da mesma sessão tmux após direção explícita do usuário.
  • Nunca permita que um lançamento atinja o empacotamento do aplicativo com um keychain de Developer ID não preparado. Nenhuma janela de senha do SecurityAgent durante o lançamento; falhe primeiro no canary de assinatura.
  • Para scripts de lançamento que não são de aplicativos, use codesign-run em vez de copiar a configuração do keychain para o repositório. Forneça os campos do manifesto de codesign através de .mac-release.env ou configuração explícita de ambiente MAC_RELEASE_CODESIGN_*. Ele carrega apenas credenciais de codesign por padrão; passe --with-package-secrets quando o script de lançamento encapsulado também precisar dos campos de pacote/notário configurados na mesma passagem do 1Password. Ele executa o canary de assinatura delimitado, define o escopo de codesign através do shim do keychain gerenciado e restaura/rebloqueia antes de retornar.
  • Desative o modo xtrace e verbose do shell antes de carregar segredos de lançamento. Arme a limpeza antes de mutações no keychain/lista de pesquisa, restaure a política de bloqueio original do keychain dedicado e a lista de pesquisa do usuário e rebloqueie-o após o empacotamento.

Concluído

  • A entrada do appcast possui URL, tamanho e assinatura Sparkle.
  • O anexo baixado verifica com o Sparkle.
  • O aplicativo extraído passa por codesign, spctl e stapler validate.
  • O lançamento do GitHub possui o zip do aplicativo, o zip do dSYM quando configurado, além de ativos extras específicos do aplicativo.
  • As notas de lançamento correspondem à seção do changelog.
  • Após o lançamento verificado, incrementa o changelog para o próximo patch Unreleased no repositório do aplicativo.

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.

Habilidades Relacionadas