mcpField
A
asc-xcode-cloud

asc-xcode-cloud

github.com/tddworksクラウド・DevOps588 回インストール5 週間前に更新
リポジトリ

asc-xcode-cloud について

`asc` コマンドラインと App Store Connect API を使って、Xcode Cloud の製品、ワークフロー、ビルド実行を管理するスキルです。ワークフローの確認からビルド開始、実行状況の読み取りまでを案内します。

主な機能

  1. 01Xcode Cloud の製品とワークフローの一覧
  2. 02ビルド実行の開始と確認
  3. 03クリーンビルドの実行
  4. 04ID 入りコマンドを応答から利用

活用シーン

  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
FAILED1つ以上のアクションが失敗しましたtrue
ERROREDインフラストラクチャ／システムエラーtrue
CANCELED手動でキャンセルされましたfalse
SKIPPEDビルドがスキップされましたfalse

コマンドの完全なリファレンス

すべてのフラグと使用例については、commands.mdを参照してください。

コメント

Markdown 対応