SKILL.md
readonly只读
name
asc-id-resolver
description
使用 asc 从人类友好的名称解析 App Store Connect ID(应用、构建版本、应用和数字商品版本、群组、测试员)。当命令需要 ID 时使用。
asc id resolver
使用此技能将名称映射为其他命令所需的 ID。
应用 ID
- 按 Bundle ID 或名称:
asc apps list --bundle-id "com.example.app"asc apps list --name "My App"
- 获取所有应用:
asc apps list --paginate
- 设置默认应用:
ASC_APP_ID=...
构建版本 ID
- 最新构建版本:
asc builds info --app "APP_ID" --latest --version "1.2.3" --platform IOS
- 最近的构建版本:
asc builds list --app "APP_ID" --sort -uploadedDate --limit 5
版本 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
输出提示
- 默认输出根据终端环境自适应:在终端中显示表格,在管道或 CI 中显示压缩 JSON。显式指定
--output优先。 - 自动化场景使用显式
--output json,仅在需要人类可读的 JSON 时添加--pretty。 - 人类查看时,使用
--output table或--output markdown。
安全护栏
- 在列表命令中优先使用
--paginate以避免遗漏 ID。 - 在可用的情况下使用
--sort使结果确定性。






