asc命令行工具使用指南Skill asc-cli-usage

---

name: asc-cli-usage description: 在本仓库中使用 asc 命令行工具的指南（标志、输出格式、分页、身份验证和发现）。当需要运行或设计 asc 命令或通过 CLI 与 App Store Connect 交互时使用。

asc cli 使用指南

当您需要为 App Store Connect 运行或设计 asc 命令时，请使用此技能。

命令发现

• 始终使用 --help 来发现命令和标志。
  • asc --help
  • asc builds --help
  • asc builds list --help

标志约定

• 使用显式的长标志（例如，--app, --output）。
• 无交互提示；破坏性操作需要 --confirm。
• 当用户想要所有页面时，使用 --paginate。

输出格式

• 默认输出是压缩的 JSON。
• 仅用于人类可读输出时，使用 --output table 或 --output markdown。
• --pretty 仅对 JSON 输出有效。

身份验证和默认值

• 优先通过 asc auth login 使用钥匙串身份验证。
• 备用环境变量：ASC_KEY_ID, ASC_ISSUER_ID, ASC_PRIVATE_KEY_PATH, ASC_PRIVATE_KEY, ASC_PRIVATE_KEY_B64。
• ASC_APP_ID 可以提供默认的应用 ID。

超时设置

• ASC_TIMEOUT / ASC_TIMEOUT_SECONDS 控制请求超时。
• ASC_UPLOAD_TIMEOUT / ASC_UPLOAD_TIMEOUT_SECONDS 控制上传超时。