SKILL.md
readonlyread-only
name
asc-id-resolver
description
Resolve App Store Connect IDs (apps, builds, app and digital-goods versions, groups, testers) from human-friendly names using asc. Use when commands require IDs.
asc id resolver
使用此技能將名稱對應到其他指令所需的 ID。
App ID
- 依 bundle ID 或名稱:
asc apps list --bundle-id "com.example.app"asc apps list --name "My App"
- 取得全部:
asc apps list --paginate
- 設定預設值:
ASC_APP_ID=...
Build ID
- 最新建置:
asc builds info --app "APP_ID" --latest --version "1.2.3" --platform IOS
- 最近的建置:
asc builds list --app "APP_ID" --sort -uploadedDate --limit 5
Version ID
asc versions list --app "APP_ID" --paginate
數位商品版本 ID
API 4.4.1 版本 ID 不同於 IAP 產品、訂閱項目和訂閱群組 ID:
先解析擁有資源:
- IAP:
asc iap list --app "APP_ID" --paginate --output json - 訂閱群組:
asc subscriptions groups list --app "APP_ID" --paginate --output json - 訂閱項目:
asc subscriptions list --app "APP_ID" --paginate --output json
或asc subscriptions list --group-id "GROUP_ID" --paginate --output json
接著解析其版本 ID:
- IAP 版本:
asc iap versions list --iap-id "IAP_ID" --paginate --output json - 訂閱項目版本:
asc subscriptions versions list --subscription-id "SUB_ID" --paginate --output json - 訂閱群組版本:
asc subscriptions groups versions list --group-id "GROUP_ID" --paginate --output json
從對應的版本子樹解析子本地化或圖片 ID:
- IAP 本地化:
asc iap versions localizations list --version-id "VERSION_ID" --paginate --output json - IAP 主要圖片:
asc iap versions image --version-id "VERSION_ID" --output json - IAP 圖片集合:
asc iap versions images list --version-id "VERSION_ID" --paginate --output json - 訂閱項目本地化:
asc subscriptions versions localizations list --version-id "VERSION_ID" --paginate --output json - 訂閱項目主要圖片:
asc subscriptions versions images primary --version-id "VERSION_ID" --output json - 訂閱項目圖片集合:
asc subscriptions versions images list --version-id "VERSION_ID" --paginate --output json - 訂閱群組本地化:
asc subscriptions groups versions localizations list --version-id "VERSION_ID" --paginate --output json
TestFlight ID
- 群組:
asc testflight groups list --app "APP_ID" --paginate
- 測試人員:
asc testflight testers list --app "APP_ID" --paginate
預先發布版本 ID
asc testflight pre-release list --app "APP_ID" --platform IOS --paginate
審查提交 ID
asc review submissions-list --app "APP_ID" --paginate
輸出提示
- 輸出預設值會依 TTY 調整:在終端機中顯示表格,在管道或 CI 中顯示最小化 JSON。明確的
--output優先。 - 自動化時使用明確的
--output json,僅在需要人類可讀的 JSON 時加上--pretty。 - 供人類檢視時,使用
--output table或--output markdown。
防護措施
- 在列表指令中優先使用
--paginate,以避免遺漏 ID。 - 在可用之處使用
--sort,讓結果具有確定性。






