Communitygithub.com

App Store 發布自動化

透過單一設定檔自動化 iOS 應用程式提交至 App Store Connect,建立一致且可靠的發布流程。

App Store 發布自動化 是什麼?

此技能透過 App Store Connect API,自動化整個 iOS 應用程式提交流程。使用者只需提供一次認證資訊與一個 `config.json` 設定檔,AI 代理便能處理從建置、上傳二進位檔、填寫中繼資料、螢幕截圖、定價、年齡分級、內容權利、審查資訊、訂閱項目,到最終提交審查的所有可自動化步驟。此技能支援 EAS/Expo 建置流程,並會偵測哪些步驟必須透過使用者介面手動操作(例如「App 隱私權」資料收集聲明與首次訂閱綁定),並提供精確的操作指示。所有指令皆可安全重複執行,確保發布流程的穩定性與可靠性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add threelipped-genushesperiphona524/appstore-release

在你喜歡的 AI 中提問

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

說明文件

App Store 發布自動化 是做什麼的?

透過 App Store Connect API 驅動完整的 iOS App Store 提交流程。設計目標:使用者只需提供一次認證資訊 + 一個 config.json 設定檔,代理程式就能執行所有可自動化的操作,僅在碰到 Apple 確實不提供 API 的少數事項時才中斷使用者。不要要求使用者再次確認已經在設定檔中或具有合理預設值的項目。

運作原則(請先閱讀)

  1. 設定驅動,而非提示驅動。 所有應用程式內容都存在 config.json 中。直接執行指令,不要反覆詢問使用者。
  2. 只有兩件事僅能透過 UI 操作(Apple 沒有 API):App 隱私權資料收集聲明 與 首次訂閱綁定與提交。工具會偵測到這些情況,並提供精確的點擊操作步驟。其餘所有步驟皆可透過腳本自動化。
  3. 僅在以下情況才詢問使用者:設定檔缺少必要欄位(告訴使用者具體是哪個欄位)、設定檔中未包含的業務決策(例如訂閱價格、發布時機),或在執行唯一次不可逆轉的操作(最終提交)之前。除此之外,直接繼續執行。
  4. 冪等性:每個指令都可安全重複執行。node cli.mjs release 可以反覆執行。

架構(遵循 SOLID 原則,以便擴充)

scripts/
  cli.mjs                 單一進入點/調度器 (node cli.mjs <command>)
  lib/                    注入式服務,每個服務負責單一職責
    env.mjs               解析並驗證環境變數(認證資訊、應用程式 ID)
    jwt.mjs               ES256 權杖提供者
    client.mjs            AscClient — 認證 + HTTP + 統一的錯誤處理
    discovery.mjs         透過自然鍵值查找 ASC 資源(不硬編碼 ID)
    assets.mjs            保留→上傳→提交二進位檔上傳器
    config.mjs            載入並驗證設定檔,列出缺少的項目
    log.mjs               結構化結果 + 機器可讀的摘要
    context.mjs           組合根(依賴注入)
  commands/               每個任務一個檔案,統一的合約 (請參閱 _contract.md)

新增功能 = 新增 commands/x.mjs(包含元資料 + run(ctx)),並在 cli.mjs 中註冊。

設定(一次性)— 請參閱 references/setup.md

  1. ASC API 金鑰(App Manager 權限):下載 AuthKey_XXXX.p8,記下金鑰 ID 與發行者 ID。
  2. 在 ASC 中已存在應用程式記錄(已註冊的 bundle ID)。ASC_APP_ID = 應用程式 ASC 網址中的數字 ID。
  3. 已設定 EAS 專案,已執行 eas login。
  4. 根據 references/config-template.json 填寫 config.json。隨時驗證:任何指令都會印出缺少的欄位。

環境變數

export ASC_KEY_ID=... ASC_ISSUER_ID=... ASC_P8_PATH=/abs/AuthKey_XXXX.p8   # 將 .p8 加入 gitignore
export ASC_APP_ID=1234567890
export APPSTORE_CONFIG=/abs/config.json
cd scripts   # 然後執行:node cli.mjs <command>

操作手冊

1. 檢查狀態

node cli.mjs status          # 完整的唯讀概覽
node cli.mjs check           # 就緒狀態 + 仍待處理的 UI-only 步驟

2. 建置二進位檔 (EAS)

  • 如果 eas build 因憑證過期失敗(*

相關技能