Community寫作與編輯github.com

steipete/release-mac-app

macOS 應用程式發布:Sparkle、公證、GitHub Release、Homebrew、收尾。

release-mac-app 是什麼?

這是一個專為 macOS 應用程式(例如 BlackBar、RepoBar、CodexBar、Trimmy)設計的 AI 助手技能,用於自動化整個發布流程。它支援 Sparkle 更新框架、Apple 公證 (notarization)、GitHub Release、以及 Homebrew 公式更新。此技能會從應用程式儲存庫中的 `.mac-release.env` 清單讀取設定,並使用 `scripts/mac-release` 腳本處理發布狀態檢查、版本更新日誌生成、appcast 製作與驗證、程式碼簽署(支援 Keychain 和 1Password 整合)、以及最終發布。它特別強調安全性,例如避免印出私鑰、使用專用的 Keychain 進行非互動式 Developer ID 簽署,並透過 tmux session 管理 1Password 憑證。發布完成後,還會自動更新更新日誌並將版本號推進到下一個開發迭代。此技能主要透過 Claude Code 等 AI 編碼代理使用,能將複雜的 macOS 發布流程簡化為一個可靠的、可重複的指令。

相容平台~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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Mac App Release

用於 BlackBar、RepoBar、CodexBar、Trimmy 以及類似使用 Sparkle 更新的 macOS 應用程式。

規則

  • 在應用程式儲存庫中工作。
  • 讀取 .mac-release.env;這是儲存庫擁有的發布清單。
  • 使用此技能的 scripts/mac-release 進行共享的發布/appcast/驗證工作。
  • 將應用程式特定的建置/打包/簽署行為保留在儲存庫腳本中,除非它已經由清單驅動。
  • 絕不列印私鑰資料。
  • 優先使用 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 session 使用 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 簽署。Keychain 必須是可替換的、專用於發布自動化、與預設 Keychain 分開、不與互動使用共用,並且只包含一個簽署私鑰。輔助程式擁有該金鑰,並可能會永久將其分割區 ACL 標準化為 apple-tool:,apple:,codesign:。在預檢完成後,相同的 tmux 憑證傳遞會讀取 keychain_path 和 keychain_password,取得每個使用者的發布鎖,透過私有的檔案描述符將密碼提供給 CLI PTY,在不隱藏現有 Keychain 的情況下前置 Keychain,驗證 Developer ID Application 的 canary,透過暫時的 codesign --keychain shim 限定套件簽署範圍,然後恢復暫時狀態、重新鎖定並釋放鎖。
  • 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 會覆寫 codesign 憑證項目的預設值;帳號、保管庫和服務帳號模式否則繼承主要項目的設定。將保管庫設為空且服務帳號模式設為 0 以使用個人桌面帳號項目。也可以直接提供 MAC_RELEASE_CODESIGN_KEYCHAIN + MAC_RELEASE_CODESIGN_KEYCHAIN_PASSWORD。
  • MAC_RELEASE_RUN_LOGIN_SHELL=1 讓指令掛鉤回到 bash -lc;預設掛鉤使用 env -u BASH_ENV bash -c,因此 shell 啟動檔案無法覆蓋匯出的發布機密。

1Password 規則:

  • 優先使用已經匯出的環境變數;如果所有 MAC_RELEASE_OP_FIELDS 都已存在,則不進行 op 呼叫。
  • 如果欄位缺失,則在一個 tmux 指令中為整個發布讀取配置的套件和 codesign 項目。
  • 僅在指定了保管庫或 MAC_RELEASE_OP_USE_SERVICE_ACCOUNT=1 時使用服務帳號模式。
  • 不要在新的 shell 中重試 op 讀取;僅在明確的使用者指示後,從同一個 tmux session 重新執行。
  • 絕不允許在 Developer ID Keychain 未準備好的情況下進行應用程式打包發布。發布期間不應出現 SecurityAgent 密碼視窗;應先讓簽署 canary 失敗。
  • 對於非應用程式發布腳本,使用 codesign-run 而不是將 keychain 設定複製到儲存庫中。透過 .mac-release.env 或明確的 MAC_RELEASE_CODESIGN_* 環境配置提供 codesign 清單欄位。它預設僅載入 codesign 憑證;當包裝的發布腳本在同一次 1Password 傳遞中也需要配置的套件/公證欄位時,傳遞 --with-package-secrets。它會執行綁定的簽署 canary,透過受管理的 keychain shim 限定 codesign 範圍,並在返回前恢復/重新鎖定。
  • 在載入發布機密之前停用 shell xtrace 和 verbose 模式。在 keychain/搜尋清單變更之前清理。恢復專用 keychain 的原始鎖定策略和使用者搜尋清單,並在打包後重新鎖定它。

完成

  • appcast 條目包含 URL、長度、Sparkle 簽章。
  • 下載的 enclosure 可通過 Sparkle 驗證。
  • 解壓縮後的應用程式通過 codesign、spctl 和 stapler validate。
  • GitHub Release 包含應用程式 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.

相關技能