| name | app-store-connect-skill |
|---|---|
| description | 掃描 App 專案並自動生成 App Store Connect 提交資料的 HTML 報告。觸發情境：使用者要準備/更新 App Store 上架資料、問「這次上架要填什麼」、要根據程式碼推斷 App Store Connect 各欄位、要做 App Store 提交前檢查清單。 |
App Store Connect Skill
掃描專案 → 依 Apple 官方選項與問卷結構推斷每個欄位 → 輸出可複製貼上的 HTML Artifact。 絕不憑空杜撰使用者專屬資料（帳密、私人 URL）；這類欄位一律標記 USER 並留空，不借用其他專案的真實值當範例。
適用範圍
支援任何有 iOS App（Expo / React Native bare / 純 Xcode 專案皆可）要準備 App Store Connect 上架或更新資料的情境。掃描邏輯不綁定特定框架，但檔案優先順序假設專案至少有 Info.plist 或等效的 iOS 設定檔。
流程
1. 掃描專案
依 references/scan-targets.md 的優先順序讀取專案檔案，蒐集：App 名稱/版本/Bundle ID、權限用途說明、第三方 SDK（廣告/分析/當機回報/訂閱）、i18n 語言、隱私政策文件、認證方式、後端環境變數等。
2. 分類每個欄位
每個 App Store Connect 欄位都要標上三種類型之一：
| 標籤 | 定義 | 呈現方式 |
|---|---|---|
SCAN | 直接從專案檔案讀到的值 | 照抄，附掃描來源（如 app.json:3） |
LLM 推斷 | 需要用 Apple 官方選項/問卷結構去比對專案內容才能得出的值 | 必須附「偵測依據」（掃到什麼）+「配對邏輯」（為什麼選這個選項，而不是其他選項）兩段推理 |
USER | 只有使用者自己知道的資料（帳密、私人 URL、法務版權聲明、SKU 等） | 留空，標記 USER，附一句提示文字，絕不虛構 |
完整欄位清單、每個欄位的類型、在 ASC 介面的實際位置 → references/field-structure.md
3. 多步驟問卷
年齡分級（7 步）與 App 隱私權（4 階段）不是單一欄位，是完整問卷，每一題都要照官方選項逐一推斷並附依據。完整結構 → references/questionnaires.md
4. 渲染 Artifact
用 assets/template.html 當骨架（已含深色/淺色主題、sticky 側邊欄、可點擊複製欄位、雙語 tab、即時字元計數樣式）。把掃描與推斷結果填入對應區塊；側邊欄結構、頁面排序要對應 App Store Connect 實際介面順序：
發佈 — iOS App 版本頁（第一站：預覽截圖／行銷文字／描述／關鍵字／URL／版本／App 審查資訊）
↓
一般資訊 — App 資訊頁（名稱／類別／年齡分級／規範與許可）
↓
App Store — 信任與安全（App 隱私權／App 輔助使用）
若專案偵測到 *.storekit 或訂閱相關 SDK（如 RevenueCat／StoreKit 2），額外加入「定價與供應狀況」「App 內購買」「訂閱」區塊；沒偵測到就不要生成這些區塊，避免無意義的空白內容。
用 Artifact 工具發布最終頁面，並回報連結。
硬性規則
- 字元上限一致，不分中英文：名稱 30、副標題 30、行銷宣傳文字 170、描述 4000、關鍵字 100 —— Apple 以字元數計算，中文字與英文字母同樣算 1 字元，不要誤判中英文有不同上限。
- USER 欄位絕不代填：帳密、私人 URL、SKU、版權聲明等即使掃描到專案裡有類似值（如測試用 email），也要跟使用者確認是否為正式提交用值，預設留空。
- 每個 LLM 推斷都要能被追問：使用者可能會問「為什麼選這個類別/這個分級」，推理過程要完整到能重現，不能只給結論。
- 多方案先討論：若欄位有超過一種合理推斷（例如主要類別可能符合兩個 Apple 分類），列出選項與取捨，不要自己決定後才呈現。
- 不確定就標記待確認，不要用高信心語氣包裝不確定的推斷。