用途:本技能用于指导运行或设计面向 App Store Connect 的 asc 命令,覆盖命令发现、动词规范、标志、输出、认证与超时。
命令发现:始终用 --help 查看命令与标志,如 asc --help、asc builds --help、asc builds list --help。已知工作流但不确定命令路径时,用 asc search 做本地确定性发现,例如 asc search "submit app for review"、asc search --output table "upload build"。设计面向 API 的命令前,用 asc schema 查看内置端点模式与请求/查询字段,如 asc schema --pretty "GET /v1/apps"、asc schema --method POST appStoreVersions。用 asc capabilities 了解 CLI 支持、部分支持、仅网页及公共 API 受限的工作流覆盖,如 asc capabilities --area release --output table、asc capabilities --status not-public-api --output markdown。
规范动词:只读命令优先用 view 而非旧别名 get,如 asc apps view --id "APP_ID"、asc versions view --version-id "VERSION_ID"、asc pricing availability view --app "APP_ID"。仅更新的可用性界面及其他规范编辑流程优先用 edit,如 asc pricing availability edit --app "APP_ID" --territory "USA,GBR" --available true、asc app-setup availability edit --app "APP_ID" --territory "USA,GBR" --available true、asc xcode version edit --build-number "42"。当 CLI 有意建模更高层替换/配置流程且 --help 仍显示 set 为规范动词时,保留 set。
标志约定:使用显式长标志(如 --app、--output);自动化中优先显式标志,部分较新命令交互运行时可提示缺失字段;破坏性操作需 --confirm;需要全部页面时用 --paginate。
输出格式:默认感知 TTY,交互终端为 table,管道或非交互为 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 web auth capabilities 检查 API 密钥角色覆盖,该功能属实验性 web 认证界面,默认解析当前本地认证,也可用 --key-id 检查指定密钥。
超时:ASC_TIMEOUT / ASC_TIMEOUT_SECONDS 控制请求超时;ASC_UPLOAD_TIMEOUT / ASC_UPLOAD_TIMEOUT_SECONDS 控制上传超时。