Community研究與資料分析github.com

xxjrq/easy-app-store

App Store Connect 自動上架 Agent Skill,支援 Claude Code、Codex、OpenCode、WorkBuddy,基於 Easy WebBridge。

easy-app-store 是什麼?

這個 Skill 讓 AI Agent(如 Claude Code、Codex、OpenCode、WorkBuddy)能夠自動將 iOS 專案從本地工程帶到 App Store。它會根據專案實際情況(Xcode、Flutter、React Native、Unity、Fastlane 等)自動識別構建命令,並透過 Easy WebBridge 操控已登入的 App Store Connect 瀏覽器,執行從構建、上傳、填寫商店資料、隱私合規、審核資訊到提交審核與追蹤狀態的完整流程。支援多種專案類型與常見構建工具,無需手動操作瀏覽器。使用者只需提供專案路徑與目標版本,Agent 即可依序完成所有步驟,並在遇到審核退回時讀取審核意見、定位問題、協助修正後重新提交。這極大簡化了 iOS 應用的上架流程,尤其適合 CI/CD 整合或需要頻繁更新商店資訊的開發團隊。

相容平台✓Claude Code✓Codex CLI~Cursor✓OpenCode
npx skills add xxjrq/easy-app-store

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

easyAppStore

將一個 iOS 專案從本地工程帶到 App Store。Agent 根據專案實際情況自動決定構建命令,並透過 Easy WebBridge 操作已經登入的 App Store Connect。本 Skill 遵循 Agent Skills 標準,可由 Claude Code、Codex、OpenCode、WorkBuddy 及其他相容 Agent 使用。

先確認可以執行

在本 Skill 根目錄執行:

node scripts/easy-webbridge-client.mjs preflight

自檢會確認 Node.js、Easy WebBridge、存取權杖和線上瀏覽器,並回傳可選瀏覽器的名稱與 browserId。若執行時尚未安裝,按自檢結果先完成一次 Easy WebBridge 安裝;後續所有 Easy WebBridge 業務 Skill 共用這套執行環境。

能做什麼

  • 識別 Xcode、Flutter、React Native、Unity、Fastlane 等專案,找到正確的 App、Bundle ID、版本號和構建號。
  • 檢查簽名與發佈配置,按專案現有工具構建或找到可上傳的 IPA。
  • 上傳構建包、App 圖示、各尺寸截圖、預覽影片和審核附件。
  • 填寫應用名稱、副標題、描述、關鍵字、分類、支援網址、隱私政策和版本說明。
  • 填寫年齡分級、隱私資訊、出口合規、內容版權和審核聯絡資訊。
  • 按需要填寫審核帳號、示範步驟、QR Code 或測試附件。
  • 選擇正確構建版本,提交 App Review,並繼續檢查真實審核狀態。
  • 讀取審核意見,判斷應修改程式碼、截圖、商店文案還是審核資料,然後完成修正和重新提交。

開始

  1. 讀取應用專案和現有發佈配置,沿用專案當前構建體系。
  2. 確認目標 App、版本、市場、發佈範圍和使用者期望的終點。
  3. 根據自檢結果選擇已經登入 App Store Connect 的瀏覽器。
  4. 為本次上架建立一個 easy-app-store-<run-id> 標籤組;後續操作重複使用組內當前頁面。
  5. 彙總本次需要的文字、圖片、影片、帳號和審核附件;能從專案可靠讀取的內容直接讀取。

執行

  1. 使用專案已有的 Xcode、構建腳本或 Fastlane 完成 Release 構建和上傳。
  2. 在 App Store Connect 選擇正確應用和版本,關聯剛上傳的構建。
  3. 填完版本頁面、商店資料、隱私與合規頁面、審核資訊。
  4. 上傳所需截圖和附件,並等待頁面顯示處理完成。
  5. 使用者要求「上架」或「提交審核」時,繼續完成提交;使用者只要求準備或檢查時,停在對應結果頁。
  6. 提交後重新讀取頁面,記錄實際顯示的版本、構建號和狀態。
  7. 若被退回,讀取完整審核資訊,定位問題,修改對應內容並重新走本次流程。

Easy WebBridge 使用方式

  • Easy WebBridge 位址固定為 127.0.0.1:17777。
  • 一次任務固定控制一個 browserId。
  • 順序步驟重複使用同一標籤頁;確實需要對照時才在同一任務組增加標籤頁。
  • 使用本 Skill 的 scripts/easy-webbridge-client.mjs 呼叫 list、navigate、snapshot、click、fill、upload 和 command;它直接連線執行中的 Easy WebBridge,不依賴另一個 Skill 的本地路徑。
  • 使用 upload 上傳絕對路徑檔案;頁面變化後重新讀取頁面再繼續。
  • 任務結束時只關閉本 Skill 建立的標籤組,保留使用者原來的頁面。

完成標準

向使用者清楚給出:

  • App 名稱、Bundle ID、版本號和構建號。
  • IPA 的產生或上傳結果。
  • 商店資料、截圖、隱私合規和審核資料的完成情況。
  • App Store Connect 當前真實狀態,例如「準備提交」「正在等待審核」「審核中」「被拒絕」「可供銷售」。
  • 若有審核問題,給出具體原因、已修改內容和下一步。

分別記錄「上傳成功」「提交成功」「審核通過」和「商店可見」,以 App Store Connect 最終頁面為準。

相關技能