Community影像github.com

store-pack

構建應用程式的 Google Play 與 App Store 提報包(圖示、帶框螢幕截圖、功能圖、符合字數限制的商店文案、控制台表單回答、阻礙因素分析),輸出至專案的 store/ 資料夾。當需要讓應用程式「準備好上架 Play Store / App Store」或準備商店素材、文案、控制台表單回答時使用。

store-pack 是什麼?

store-pack 是一個專為開發者與 AI 代理設計的技能,能自動化產生應用程式上架 Google Play 與 App Store 所需的所有素材與文件。它會將圖示、帶框螢幕截圖(符合精確的商店尺寸)、功能圖、符合字數限制的商店文案、控制台表單回答以及阻礙因素分析表輸出至專案的 store/ 資料夾中。此技能支援 Flutter 應用程式(透過 Flutter 測試腳本產生螢幕截圖),也支援網頁、桌面或混合式應用程式(透過瀏覽器自動化工具驅動 app 自有伺服器來捕捉螢幕截圖)。執行時,它會先檢查應用程式的事實(套件 ID、版本、權限、SDK、帳號與付款機制、隱私權政策 URL 等),然後生成原始螢幕截圖(使用虛構數據並避免生產環境),接著透過 Python 腳本執行合成作業:將螢幕截圖裱框、產生功能圖與圖示、產生符合字數限制的商店文案、以及撰寫包含阻礙因素清單的文件。使用者無需手動上傳或提交任何內容;材料準備好後由使用者自行決定如何上傳。store-pack 還內建常見上架阻礙因素檢查(如付款規則、帳號刪除路徑、Apple 登入要求、測試廣告 ID、權限宣告、審查者存取權等),有助於避免在應用程式審查階段被拒絕。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nowfalsalahudeen/store-pack/tree/HEAD

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

store-pack 是做什麼的?

在專案根目錄中產生 store/ 資料夾:包含圖示、帶框螢幕截圖、功能圖、商店文案、控制台表單回答以及一份阻礙因素 README。絕不提交、上傳或部署;這些留給使用者自行處理。

需求:Python 3、Flutter SDK(影像合成工具是 Flutter 測試,無需應用程式本體)、以及 macOS(用於影像檢查與圖示尺寸的 sips 指令)。原始螢幕截圖來自應用程式本身。

工作流程

  1. 檢查應用程式的事實(絕不虛構):套件/綑綁 ID、版本、權限(AndroidManifest, Info.plist)、pubspec、Cargo.toml 或 package.json 中的 SDK(廣告、分析、崩潰回報、計費、登入)、帳號與付款機制、隱私權政策與支援 URL、簽署配置、裝置系列。請閱讀專案自身的貢獻者文件以了解其規則。
  2. 原始螢幕截圖。 從真實應用程式中捕捉,使用真實但虛構的數據。絕對不要使用生產環境數據或生產環境帳號。
    • Flutter:一個 widget 測試框架,使用真實字型(debugDisableShadows = false,否則陰影會渲染為硬邊緣);手機 440x956 在 3x 解析度 = 1320x2868。
    • 網頁、桌面或混合式應用程式:在暫存資料庫上執行應用程式自己的伺服器,透過 API 植入數據,並使用瀏覽器自動化工具驅動。使用獨立的瀏覽器上下文,設定 deviceScaleFactor 為 3(手機,視口 440x956)或 2(平板,1032x1376),並在每次截圖前隱藏捲軸:*::-webkit-scrollbar{display:none!important}*{scrollbar-width:none!important}。
    • 只終結一個監聽在你自己的暫存連接埠上的程序(lsof -ti tcp:PORT -sTCP:LISTEN),不要用名稱來終結。
    • 目視檢查每張截圖。如果某個寬度下有截圖損壞,就捨棄該截圖並通知使用者。
  3. store/app.json(參見 docs/config-reference.md),然後執行 python3 scripts/make_pack.py store/app.json。它會將螢幕截圖裱框在品牌漸層背景上並加上說明文字,建構功能圖與圖示,並執行 scripts/check_pack.py。
    • 圖示:通常只存在帶有內建圓角或文字的圖案;icon 工作會將標記裁剪到平坦的滿版背景上。告知使用者仍然需要向量圖或乾淨的 1024 像素來源。
  4. 商店文案: store/listings.json,然後執行 python3 scripts/write_listings.py store/listings.json(fastlane 佈局,強制字數限制)。只描述該建置真的做了什麼,以及該平台建置包含了什麼。
  5. 文件: store/README.md(首先列出阻礙因素表格)、google-play/console-forms.md、app-store/connect-forms.md。

商店規格(請在控制台中確認;Apple 的頁面可能無法載入)

  • Play:圖示 512 像素(<= 1 MB);功能圖 1024x500,無透明通道;2-8 張手機截圖,每邊 320-3840 像素,長邊 <= 短邊的 2 倍(使用 1080x1920);可選 7"/10" 平板截圖(1200x1920,1600x2560);標題 30 字元、簡短說明 80 字元、完整說明 4000 字元。
  • App Store:iPhone 6.9" 1320x2868(必填)、6.5" 1284x2778;iPad 13" 2064x2752(如果支援 iPad);每種最多 10 張;無透明通道;圖示 1024 像素,無透明通道;名稱 30 字元、副標題 30 字元、促銷文字 170 字元、關鍵字 100 字元。
  • 兩者都會拒絕帶有透明通道的螢幕截圖;合成工具會寫入 RGB PNG。

每個應用程式中都應檢查的阻礙因素(經驗累積)

  • 付款: 在應用程式內部透過網頁付款提供者銷售數位解鎖或授權,會違反 Play Billing / Apple IAP 規定。對於 iOS,上傳時不包含購買 UI,或者加入 StoreKit。行動裝置建置中不得出現價格或購買連結。
  • 帳號刪除: 任何會建立帳號的應用程式都需要一個應用程式內的刪除路徑,以及(Play)一個公開的網頁 URL 來說明其流程。
  • Apple 登入: 只要 iOS 上提供了 Google 或其他第三方登入,就必須要有 Apple 登入。
  • 測試廣告 ID 遺留在正式發行版本中;缺少真實的廣告 ID。
  • Play 應用程式簽署: 將 Play 的應用程式簽署 SHA-1 加入 Google OAuth Android 用戶端,否則透過 Play 安裝的應用程式會無法登入。
  • 受限制或需宣告的權限: REQUEST_IGNORE_BATTERY_OPTIMIZATIONS、前台服務類型(需要宣告與影片)、位置(即使使用 maxSdkVersion)、藍牙 neverForLocation。
  • 審查者存取權: 需要伺服器或授權的應用程式需要一個展示伺服器、PIN 碼與操作步驟(Play 應用程式存取權、Apple 準則 2.1)。
  • 隱私權政策 URL 必須存在;提供聯絡地址與電話以符合 EU/UK 商家身份。
  • 正式發行簽署已配置;版本號碼遞增;Play 使用 AAB;Apple 團隊與綑綁 ID;ITSAppUsesNonExemptEncryption;隱私權資訊清單。
  • 新的個人 Play 帳號: 在正式發佈前,需要一個 12 名測試者、為期 14 天的封閉測試。
  • 資料安全: 「僅暫時處理」僅用於在記憶體中處理且從不儲存的資料(例如傳送給 AI 服務的照片);電子郵件或 ID 存放在伺服器上則不屬於暫時處理。廣告 ID:只有在沒有廣告或轉換 SDK 且已移除廣告 ID 權限時,才回答「否」。
  • 目標受眾:除非應用程式是真正為兒童設計,否則應設定為 18 歲以上。
  • 最小化縮減器 (R8) 可能在選用函式庫上失敗: 如果正式發行建置因「Missing classes」而失敗,請為指定的套件新增 -dontwarn 規則。

檔案

  • scripts/make_pack.py:執行所有工作;scripts/compose/:Flutter 合成工具(STORE_JOBS=jobs.json flutter test);scripts/build_icons.py;scripts/check_pack.py;scripts/write_listings.py。
  • templates/app.example.json、templates/listings.example.json:要複製的配置範本。examples/:一個完整的實際範例,包含一個虛構應用程式及其輸出。
  • docs/:入門指南、配置參考、運作原理。

相關技能