mcpField
A
asc-id-resolver

asc-id-resolver

github.com/rorkai开发1.1k7.6k 次安装2 天前更新
代码仓库

关于 asc-id-resolver

asc-id-resolver 是指导使用 asc CLI 将 App Store Connect 资源名称或关联信息解析为命令所需 ID 的技能，适用于需要继续执行管理操作的开发者。它覆盖应用、构建、版本、数字商品及 TestFlight 等资源，并提供输出与列表查询建议。

主要功能

  1. 01查找应用与构建 ID
  2. 02解析版本及数字商品 ID
  3. 03查找 TestFlight 和审核 ID
  4. 04建议分页及确定性排序
  5. 05提供终端与自动化输出建议

适用场景

  1. 01按应用名称查找应用 ID
  2. 02为版本或上传操作定位构建
  3. 03解析订阅及 IAP 版本 ID
  4. 04查找 TestFlight 测试组 ID

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rorkai/app-store-connect-cli-skills --skill asc-id-resolver

安装后在 Claude Code 中输入/asc-id-resolver确认已加载。

详细介绍

asc ID 解析器

使用此技能将名称映射为其他命令所需的 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
  • 附加或提交时可跳过查询：asc versions attach-build 和 asc review submit 支持 --app、--version 和 --build-number "45"。

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，使结果具有确定性。

评论

支持 Markdown