JaminZhou/asc-tooling

asc-tooling 是做什么的？

当使用 asc_tooling（可重复使用的 App Store Connect CLI 工具包）时，使用此技能。

安全规则

• 切勿要求用户粘贴 .p8 密钥内容、JWT、Cookie、App Store Connect 账户数据或未发布的产品机密。
• 将产品特定的截图生成、审核说明、元数据文件和发布状态保留在消费产品仓库中。
• 将 experimental/ 浏览器会话助手视为仅限本地且不受支持；不要在 CI 或共享发布脚本中使用它们。
• 变更命令必须明确。在创建或更新 App Store Connect 状态的操作之前，优先使用 --dry-run。
• 如果 Apple API 行为不确定，请报告已验证的内容以及仍需手动在 App Store Connect 确认的内容。

CLI 入口点

优先使用统一 CLI（如可用）：

asc-tooling commands
asc-tooling review status --bundle-id com.example.app
asc-tooling metadata status --bundle-id com.example.app --locale en-US
asc-tooling beta status --bundle-id com.example.app
asc-tooling sales units --bundle-id com.example.app --vendor-number 12345678 --report-date 2026-04-10
asc-tooling screenshots status --bundle-id com.example.app --locale en-US --display-type APP_DESKTOP
asc-tooling iap status --bundle-id com.example.app
asc-tooling version create --bundle-id com.example.app --version 1.2.0 --platform ios --dry-run
asc-tooling availability status --bundle-id com.example.app
asc-tooling store-setup status --bundle-id com.example.app --app-version 1.0.0 --platform ios

旧的可执行文件名仍受支持：

• asc-review
• asc-metadata
• asc-beta
• asc-sales
• asc-screenshots
• asc-iap
• asc-version
• asc-availability
• asc-store-setup

环境

大多数命令需要 App Store Connect API 凭证：

export ASC_KEY_ID=...
export ASC_ISSUER_ID=...
export ASC_KEY_PATH=~/.config/appstoreconnect/AuthKey_XXXX.p8

asc-sales 还需要 ASC_VENDOR_NUMBER，除非通过 --vendor-number 传递。

工作流

1. 确定产品仓库和命令界面：审核、元数据、Beta、销售、截图、内购、版本、可用性或商店设置。
2. 首先阅读产品本地的发布文档或脚本；将产品特定的值保留在那里。
3. 在变更命令之前，先使用 status 或 dry-run 命令。
4. 总结运行的命令、使用的输入、事实来源以及仍需要在 App Store Connect Web UI 中确认的内容。
5. 切勿将机密或浏览器会话导出保存到仓库中。

技能安装

通过捆绑的 CLI 安装或更新此技能：

asc-tooling init --client codex --force
asc-tooling init --client agents --force
asc-tooling init --client claude --force
asc-tooling init --print

--client codex 安装在 $CODEX_HOME/skills 或 ~/.codex/skills 下。 --client agents 安装在开放的 Agent Skills 用户文件夹 ~/.agents/skills 下。 --client claude 安装在 $CLAUDE_CONFIG_DIR/skills 或 ~/.claude/skills 下。