Community라이팅 & 에디팅github.com

macOS 앱 릴리스

Sparkle 업데이트, 공증, GitHub 릴리스, Homebrew, 마무리 작업을 수행하는 macOS 앱 릴리스 스킬입니다.

macOS 앱 릴리스란 무엇인가요?

이 스킬은 Sparkle 업데이트 방식을 사용하는 macOS 앱(예: BlackBar, RepoBar, CodexBar, Trimmy)의 완전한 릴리스 파이프라인을 자동화합니다. 앱 리포지토리에서 직접 작업하며 `.mac-release.env`라는 리포지토리 소유 매니페스트 파일을 사용하여 릴리스 관련 설정을 관리합니다. 주요 기능으로는 Sparkle 서명(Keychain 또는 파일 기반), 코드 서명(Developer ID with notarization), 공증(notarization), GitHub 릴리스 생성, 앱캐스트(appcast) 및 릴리스 노트 생성, Homebrew 업데이트 등이 포함됩니다. 또한 1Password와 통합하여 민감한 서명 키와 패키징 시크릿을 안전하게 관리하며, tmux 세션을 사용하여 읽기 일관성을 유지합니다. 이 스킬은 모든 단계를 자동화하고 사전 점검(precheck)을 통해 오류를 조기에 발견하여 전체 릴리스 프로세스의 안정성과 보안을 크게 향상시킵니다.

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

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Mac App Release

BlackBar, RepoBar, CodexBar, Trimmy 및 이와 유사한 Sparkle 업데이트 macOS 앱에 사용합니다.

규칙

  • 앱 리포지토리에서 작업합니다.
  • .mac-release.env를 읽습니다. 이 파일은 리포지토리가 소유한 릴리스 매니페스트입니다.
  • 이 스킬의 scripts/mac-release를 사용하여 공유 릴리스/앱캐스트/확인 작업을 수행합니다.
  • 앱별 빌드/패키징/서명 동작은 이미 매니페스트 기반이 아닌 경우 리포지토리 스크립트에 유지합니다.
  • 개인 키 자료를 출력하지 마십시오.
  • Keychain Sparkle 서명을 선호합니다. SPARKLE_PRIVATE_KEY_FILE은 명시적인 재정의일 때만 사용합니다.

명령어

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

매니페스트

각 리포지토리는 .mac-release.env를 소유합니다. 이 파일에는 비밀이 포함되어서는 안 됩니다.

필수:

  • 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 또는 MAC_RELEASE_SUPUBLIC_ED_KEY 중 하나
  • MAC_RELEASE_PACKAGE_CMD

일반적인 선택 사항:

  • MAC_RELEASE_PRECHECK
  • MAC_RELEASE_SOURCE_FILES (공백으로 구분된 앱 헬퍼 파일로, 아티팩트 이름을 확장하기 전에 소싱됨)
  • MAC_RELEASE_DSYM_ZIP
  • MAC_RELEASE_REQUIRE_DSYM=0 (앱 전용 릴리스의 경우)
  • 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 (로컬 대체 경로만 해당; 파일이 없으면 Keychain 사용)
  • 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 (필수 패키징 시크릿용). 릴리스 헬퍼는 하나의 지속적인 tmux 세션 내에서 op를 통해 알려진 항목을 한 번 읽은 다음, 패키지 명령을 위해 요청된 필드를 내보냅니다.
  • MAC_RELEASE_OP_ACCOUNT 기본값은 my.1password.com입니다. MAC_RELEASE_OP_VAULT, MAC_RELEASE_OP_TMUX_SESSION, MAC_RELEASE_OP_WAIT_SECONDS는 선택 사항입니다. 볼트가 없으면 해당 단일 op 읽기에 대해 서비스 계정 토큰 환경 변수가 설정 해제되어 개인 데스크톱 계정이 처리합니다.
  • MAC_RELEASE_CODESIGN_IDENTITY + MAC_RELEASE_CODESIGN_OP_ITEM + MAC_RELEASE_CODESIGN_KEYCHAIN_MANAGED=1은 비대화형 Developer ID 서명을 활성화합니다. 키체인은 교체 가능해야 하고, 릴리스 자동화 전용이며, 기본 키체인과 별개여야 하고, 대화형 사용과 공유되지 않아야 하며, 정확히 하나의 서명 개인 키를 포함해야 합니다. 헬퍼는 해당 키의 파티션 ACL을 apple-tool:,apple:,codesign:으로 영구적으로 정규화할 수 있습니다. 사전 점검 후, 동일한 tmux 자격 증명 패스가 keychain_path와 keychain_password를 읽고, 사용자별 릴리스 잠금을 획득하고, 비공개 파일 디스크립터를 통해 CLI PTY에 비밀번호를 제공하고, 기존 키체인을 숨기지 않고 전용 키체인을 앞에 추가하고, Developer ID Application canary를 확인하고, 임시 codesign --keychain 심을 통해 패키지 서명 범위를 지정한 다음, 일시적 상태를 복원하고, 다시 잠그고, 잠금을 해제합니다.
  • MAC_RELEASE_CODESIGN_OP_ACCOUNT, MAC_RELEASE_CODESIGN_OP_VAULT, MAC_RELEASE_CODESIGN_OP_USE_SERVICE_ACCOUNT, MAC_RELEASE_CODESIGN_OP_PATH_FIELD, MAC_RELEASE_CODESIGN_OP_PASSWORD_FIELD는 코드사인 자격 증명 항목 기본값을 재정의합니다. account, vault 및 service-account 모드는 그렇지 않으면 기본 항목 설정을 상속합니다. 개인 데스크톱 계정 항목의 경우 볼트를 비우고 서비스 계정 모드를 0으로 설정합니다. MAC_RELEASE_CODESIGN_KEYCHAIN + MAC_RELEASE_CODESIGN_KEYCHAIN_PASSWORD를 직접 대신 제공할 수 있습니다.
  • MAC_RELEASE_RUN_LOGIN_SHELL=1은 명령어 후크를 bash -lc로 되돌립니다. 기본 후크는 env -u BASH_ENV bash -c를 사용하므로 셸 시작 파일이 내보낸 릴리스 시크릿을 재정의할 수 없습니다.

1Password 규칙:

  • 이미 내보낸 환경 변수를 먼저 선호합니다. 모든 MAC_RELEASE_OP_FIELDS가 있으면 op 호출을 하지 않습니다.
  • 필드가 누락된 경우, 전체 릴리스에 대해 하나의 tmux 명령으로 구성된 패키지 및 코드사인 항목을 읽습니다.
  • 명시적인 볼트 또는 MAC_RELEASE_OP_USE_SERVICE_ACCOUNT=1이 있는 경우에만 서비스 계정 모드를 사용합니다.
  • 새 셸에서 op 읽기를 재시도하지 마십시오. 명시적인 사용자 지시 후에만 동일한 tmux 세션에서 다시 실행하십시오.
  • 준비되지 않은 Developer ID 키체인으로 앱 패키징에 도달하는 릴리스를 허용하지 마십시오. 릴리스 중 SecurityAgent 비밀번호 창이 나타나지 않아야 합니다. 먼저 서명 canary를 실패 처리하십시오.
  • 앱 릴리스 스크립트가 아닌 경우, 키체인 설정을 리포지토리에 복사하는 대신 codesign-run을 사용하십시오. .mac-release.env 또는 명시적인 MAC_RELEASE_CODESIGN_* 환경 구성을 통해 코드사인 매니페스트 필드를 제공하십시오. 기본적으로 코드사인 자격 증명만 로드합니다. 래핑된 릴리스 스크립트가 동일한 1Password 패스에서 구성된 패키지/공증 필드도 필요로 하는 경우 --with-package-secrets를 전달하십시오. 바운드 서명 canary를 실행하고, 관리형 키체인 심을 통해 codesign 범위를 지정하고, 반환하기 전에 복원/재잠금을 수행합니다.
  • 릴리스 시크릿을 로드하기 전에 셸 xtrace 및 verbose 모드를 비활성화하십시오. 키체인/검색 목록 변경 전에 정리를 준비하고, 전용 키체인의 원래 잠금 정책 및 사용자 검색 목록을 복원하고, 패키징 후 다시 잠급니다.

완료

  • 앱캐스트 항목에 URL, 길이, Sparkle 서명이 있습니다.
  • 다운로드된 enclosure가 Sparkle로 확인됩니다.
  • 추출된 앱이 codesign, spctl 및 stapler validate를 통과합니다.
  • GitHub 릴리스에 앱 zip, 구성된 경우 dSYM zip 및 앱별 추가 자산이 있습니다.
  • 릴리스 노트가 변경 로그 섹션과 일치합니다.
  • 확인된 릴리스 후, 앱 리포지토리의 변경 로그를 다음 패치 Unreleased로 범프합니다.

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.

관련 스킬