mcpField
A
asc-xcode-cloud

asc-xcode-cloud

github.com/tddworks云与 DevOps588 次安装5 周前更新
代码仓库

关于 asc-xcode-cloud

这项技能通过 `asc` 命令行和 App Store Connect API 管理 Xcode Cloud 产品、工作流与构建运行，并指导用户查找工作流、启动构建和解读状态。

主要功能

  1. 01列出 Xcode Cloud 产品和工作流
  2. 02启动并查看构建运行
  3. 03触发清理构建
  4. 04使用预填 ID 的响应命令

适用场景

  1. 01启动应用工作流的构建
  2. 02检查构建是否成功或失败
  3. 03查看近期运行或启动清理构建

安装

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

$npx skills add https://github.com/tddworks/asc-cli-skills --skill asc-xcode-cloud

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

附带文件references/commands.md

详细介绍

使用 asc 管理 Xcode Cloud

通过 App Store Connect API 管理 Xcode Cloud 产品、工作流和构建运行。

身份验证

asc auth login --key-id <id> --issuer-id <id> --private-key-path ~/.asc/AuthKey.p8

如何导航（CAEOAS 辅助操作）

每个 JSON 响应都包含一个 "affordances" 字段，其中提供了可直接运行的命令，ID 已预先填入。这意味着你无需记住或手动复制粘贴 ID：只需运行上一个响应中辅助操作提供的命令。

例如，列出产品后，响应会明确告诉你接下来要运行什么：

{
  "id": "prod-abc123",
  "name": "My App",
  "affordances": {
    "listWorkflows": "asc xcode-cloud workflows list --product-id prod-abc123"
  }
}

列出工作流后，会出现 startBuild 辅助操作——但仅当工作流已启用时。如果缺少 startBuild，说明工作流已停用（isEnabled: false），无法触发。

{
  "id": "wf-xyz",
  "name": "CI Build",
  "isEnabled": true,
  "affordances": {
    "startBuild": "asc xcode-cloud builds start --workflow-id wf-xyz",
    "listBuildRuns": "asc xcode-cloud builds list --workflow-id wf-xyz"
  }
}

常见工作流

触发构建（分步操作）
# 1. Find the Xcode Cloud product for your app
asc xcode-cloud products list --app-id 6443417124 --pretty

# 2. Copy the listWorkflows affordance from the response and run it
asc xcode-cloud workflows list --product-id prod-abc123 --pretty

# 3. Copy the startBuild affordance from the workflow you want and run it
asc xcode-cloud builds start --workflow-id wf-xyz --pretty

也可以使用脚本：

PRODUCT_ID=$(asc xcode-cloud products list --app-id APP_ID | jq -r '.data[0].id')
WORKFLOW_ID=$(asc xcode-cloud workflows list --product-id "$PRODUCT_ID" \
  | jq -r '.data[] | select(.name == "CI Build") | .id')
asc xcode-cloud builds start --workflow-id "$WORKFLOW_ID"
检查构建状态
asc xcode-cloud builds get --build-run-id run-99 --pretty

先查看 executionProgress：如果其值为 COMPLETE，再检查 completionStatus，确认构建成功还是失败。

快速查看近期构建
asc xcode-cloud builds list --workflow-id wf-xyz --output table
清理构建（清除派生数据）
asc xcode-cloud builds start --workflow-id wf-xyz --clean

查看构建结果

executionProgress — 构建当前处于什么状态？

值含义
PENDING已排队，尚未开始
RUNNING正在构建
COMPLETE已完成 — 检查 completionStatus

completionStatus — 构建是否成功？（仅在状态为 COMPLETE 时设置）

值含义hasFailed
SUCCEEDED所有操作均已通过false
FAILED一个或多个操作失败true
ERRORED基础设施/系统错误true
CANCELED已手动取消false
SKIPPED已跳过构建false

完整命令参考

所有标志和示例请参见 commands.md。

评论

支持 Markdown