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,並繼續檢查真實審核狀態。
- 讀取審核意見,判斷應修改程式碼、截圖、商店文案還是審核資料,然後完成修正和重新提交。
開始
- 讀取應用專案和現有發佈配置,沿用專案當前構建體系。
- 確認目標 App、版本、市場、發佈範圍和使用者期望的終點。
- 根據自檢結果選擇已經登入 App Store Connect 的瀏覽器。
- 為本次上架建立一個
easy-app-store-<run-id>標籤組;後續操作重複使用組內當前頁面。 - 彙總本次需要的文字、圖片、影片、帳號和審核附件;能從專案可靠讀取的內容直接讀取。
執行
- 使用專案已有的 Xcode、構建腳本或 Fastlane 完成 Release 構建和上傳。
- 在 App Store Connect 選擇正確應用和版本,關聯剛上傳的構建。
- 填完版本頁面、商店資料、隱私與合規頁面、審核資訊。
- 上傳所需截圖和附件,並等待頁面顯示處理完成。
- 使用者要求「上架」或「提交審核」時,繼續完成提交;使用者只要求準備或檢查時,停在對應結果頁。
- 提交後重新讀取頁面,記錄實際顯示的版本、構建號和狀態。
- 若被退回,讀取完整審核資訊,定位問題,修改對應內容並重新走本次流程。
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 最終頁面為準。