Communityライティング&編集github.com

steipete/release-mac-app

macOSアプリのリリース作業(Sparkle更新、公証、GitHubリリース、Homebrew、クローズアウト)を自動化するスキルです。

release-mac-app とは?

このスキルは、Sparkleによる更新機能を備えたmacOSアプリ(BlackBar、RepoBar、CodexBar、Trimmyなど)のリリースプロセス全体を自動化します。アプリリポジトリ内の `.mac-release.env` マニフェストファイルに基づき、バージョン更新、リリースノート生成、アプリケーションのビルド・署名・公証、Sparkle用アプリキャストの作成、GitHubリリースへのアップロード、そしてHomebrewやその他の配布チャンネルの更新を一貫して実行します。特に、Developer ID署名のためのキーチェーン管理や1Passwordとの統合、tmuxセッションを利用した安全なクレデンシャル取得といった高度な機能をサポートしており、開発者は手動で複雑な手順を踏むことなく、安全かつ再現性のあるリリースを実現できます。Claude CodeやCursorなどのAIエージェントから利用できるよう設計されており、`scripts/mac-release` 内のサブコマンド(status, notes, release, codesign-runなど)を介して各フェーズを個別に実行することも、まとめて実行することも可能です。

対応~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 (必要なパッケージングシークレット用。リリースヘルパーは、1つの永続的なtmuxセッション内で op を介して既知のアイテムを一度読み取り、パッケージコマンド用に要求されたフィールドをエクスポートします。)
  • MAC_RELEASE_OP_ACCOUNT のデフォルトは my.1password.com。MAC_RELEASE_OP_VAULT、MAC_RELEASE_OP_TMUX_SESSION、MAC_RELEASE_OP_WAIT_SECONDS はオプションです。ボールトがない場合、その1回の op 読み取りのためにサービスアカウントトークン環境変数は設定解除され、個人のデスクトップアカウントがそれを処理します。
  • MAC_RELEASE_CODESIGN_IDENTITY + MAC_RELEASE_CODESIGN_OP_ITEM + MAC_RELEASE_CODESIGN_KEYCHAIN_MANAGED=1 により、非対話型のDeveloper ID署名が有効になります。キーチェーンは交換可能で、リリース自動化専用であり、デフォルトのキーチェーンとは別で、対話型使用と共有せず、正確に1つの署名秘密鍵を含む必要があります。ヘルパーはそのキーのパーティションACLを apple-tool:,apple:,codesign: に所有し、永続的に正規化する場合があります。事前チェック後、同じtmuxクレデンシャルパスが keychain_path と keychain_password を読み取り、ユーザーごとのリリースロックを取得し、プライベートファイルディスクリプタを介してCLI PTYにパスワードを供給し、既存のキーチェーンを隠さずにキーチェーンを先頭に追加し、Developer ID Applicationのカナリアを検証し、一時的な 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 は、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 を使用するため、シェル起動ファイルはエクスポートされたリリースシークレットを上書きできません。

1Passwordのルール:

  • すでにエクスポートされた環境変数を優先します。すべての MAC_RELEASE_OP_FIELDS が存在する場合、op 呼び出しは行いません。
  • フィールドが不足している場合、設定されたパッケージアイテムとcodesignアイテムを、リリース全体で1つのtmuxコマンドで読み取ります。
  • 明示的なボールトまたは MAC_RELEASE_OP_USE_SERVICE_ACCOUNT=1 がある場合にのみサービスアカウントモードを使用します。
  • 新しいシェルで op 読み取りを再試行しないでください。明示的なユーザー指示があった場合にのみ、同じtmuxセッションから再実行します。
  • 準備ができていないDeveloper IDキーチェーンでリリースがアプリのパッケージ化に達することを決して許可しないでください。リリース中にSecurityAgentのパスワードウィンドウを表示させず、最初に署名カナリアを失敗させてください。
  • アプリ以外のリリーススクリプトの場合は、キーチェーン設定をリポジトリにコピーする代わりに codesign-run を使用してください。.mac-release.env または明示的な MAC_RELEASE_CODESIGN_* 環境設定を介してcodesignマニフェストフィールドを提供します。デフォルトではcodesignクレデンシャルのみをロードします。ラップされたリリーススクリプトが同じ1Passwordパスで設定されたパッケージ/公証フィールドも必要とする場合は、--with-package-secrets を渡します。バインドされた署名カナリアを実行し、管理キーチェーンラッパーを介して codesign をスコープし、復元/再ロックしてから戻ります。
  • リリースシークレットをロードする前に、シェルのxtraceおよびverboseモードを無効にします。キーチェーン/検索リストの変更の前にクリーンアップを設定し、専用キーチェーンの元のロックポリシーとユーザー検索リストを復元し、パッケージ化後に再ロックします。

完了時

  • アプリキャストエントリにURL、長さ、Sparkle署名がある。
  • ダウンロードされたenclosureがSparkleで検証される。
  • 抽出されたアプリが codesign、spctl、および stapler validate に合格する。
  • GitHubリリースにアプリzip、設定されている場合はdSYM zip、およびアプリ固有の追加アセットがある。
  • リリースノートがCHANGELOGのセクションと一致する。
  • 検証済みリリース後、アプリリポジトリのCHANGELOGを次のパッチの 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.

関連スキル