asc-tooling 是做什麼的？
當您使用 asc_tooling 這個可重複使用的 App Store Connect CLI 工具包時，請使用此技能。
安全規則
- 切勿要求使用者貼上
.p8金鑰內容、JWT、cookies、App Store Connect 帳戶資料或未公開的產品機密。 - 將特定產品的截圖生成、審查備註、中繼資料檔案與發佈狀態保留在消費端的產品儲存庫中。
- 將
experimental/瀏覽器工作階段輔助工具視為僅限本機且不受支援；請勿在 CI 或共用發佈腳本中使用它們。 - 變更命令必須明確。在執行會建立或更新 App Store Connect 狀態的動作之前，請優先使用
--dry-run。 - 若對 Apple API 的行為不確定，請報告已驗證的內容以及仍需要手動在 App Store Connect 中確認的事項。
CLI 進入點
若可用，請優先使用統一的 CLI：
asc-tooling commands
asc-tooling review status --bundle-id com.example.app
asc-tooling metadata status --bundle-id com.example.app --locale en-US
asc-tooling beta status --bundle-id com.example.app
asc-tooling sales units --bundle-id com.example.app --vendor-number 12345678 --report-date 2026-04-10
asc-tooling screenshots status --bundle-id com.example.app --locale en-US --display-type APP_DESKTOP
asc-tooling iap status --bundle-id com.example.app
asc-tooling version create --bundle-id com.example.app --version 1.2.0 --platform ios --dry-run
asc-tooling availability status --bundle-id com.example.app
asc-tooling store-setup status --bundle-id com.example.app --app-version 1.0.0 --platform ios
舊版執行檔名稱仍然支援：
asc-reviewasc-metadataasc-betaasc-salesasc-screenshotsasc-iapasc-versionasc-availabilityasc-store-setup
環境設定
多數命令需要 App Store Connect API 憑證：
export ASC_KEY_ID=...
export ASC_ISSUER_ID=...
export ASC_KEY_PATH=~/.config/appstoreconnect/AuthKey_XXXX.p8
asc-sales 還需要 ASC_VENDOR_NUMBER，除非已透過 --vendor-number 傳入。
工作流程
- 確認產品儲存庫與命令範圍：審查、中繼資料、Beta、銷售、截圖、IAP、版本、可用性或商店設定。
- 先讀取產品本機的發佈文件或腳本；並將產品特定的值保留在其中。
- 在執行變更命令之前，請先使用狀態或乾執行命令。
- 摘要說明所執行的命令、使用的輸入、資料來源，以及仍需在 App Store Connect 網頁介面中確認的任何事項。
- 切勿將機密或瀏覽器工作階段匯出內容儲存在儲存庫中。
技能安裝
透過整合的 CLI 安裝或更新此技能：
asc-tooling init --client codex --force
asc-tooling init --client agents --force
asc-tooling init --client claude --force
asc-tooling init --print
--client codex 會安裝在 $CODEX_HOME/skills 或 ~/.codex/skills 下。
--client agents 會安裝在開放的 Agent Skills 使用者資料夾 ~/.agents/skills 下。
--client claude 會安裝在 $CLAUDE_CONFIG_DIR/skills 或 ~/.claude/skills 下。