mcpField
A
asc-crash-triage

asc-crash-triage

github.com/rorkaiテスト・品質1.1k6.4k 回インストール2 日前に更新
リポジトリ

asc-crash-triage について

asc-crash-triageは、TestFlightのクラッシュレポート、ベータフィードバック、パフォーマンス診断を分析するスキルです。asc CLIでデータを取得・絞り込み、人が読める形で結果をまとめます。

主な機能

  1. 01クラッシュレポートの一覧表示と絞り込み
  2. 02ベータフィードバックとスクリーンショットの確認
  3. 03ハング、ディスク書き込み、起動診断の調査
  4. 04パフォーマンス指標のダウンロード
  5. 05重大度と頻度に基づく結果の要約

活用シーン

  1. 01特定ビルドの最近のクラッシュを探す
  2. 02デバイスモデルやOS別にクラッシュを比較
  3. 03スクリーンショット付きのベータフィードバックを確認
  4. 04重要度の高いパフォーマンス診断シグネチャを特定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/rorkai/app-store-connect-cli-skills --skill asc-crash-triage

インストール後、Claude Code で/asc-crash-triageを入力して読み込まれたか確認します。

詳細

asc クラッシュのトリアージ

TestFlight のクラッシュレポート、ベータ版へのフィードバック、パフォーマンス診断を取得、分析、要約するには、このスキルを使用します。

ワークフロー

  1. 指定されていない場合は、アプリ ID を確認します（asc apps list を使用）。
  2. 適切なコマンドでデータを取得します。解析するレスポンスには --output json を使用します。performance download の場合、--output は保存先ファイルのパスです。
  3. JSON 出力を解析し、人が読みやすい形式で要約します。

TestFlight のクラッシュレポート

最近のクラッシュを新しい順に一覧表示します。

  • asc testflight crashes list --app "APP_ID" --sort -createdDate --limit 10
  • ビルドで絞り込む：asc testflight crashes list --app "APP_ID" --build-id "BUILD_ID" --sort -createdDate --limit 10
  • デバイス／OS で絞り込む：asc testflight crashes list --app "APP_ID" --device-model "iPhone16,2" --os-version "18.0"
  • すべてのクラッシュ：asc testflight crashes list --app "APP_ID" --paginate
  • テーブル表示：asc testflight crashes list --app "APP_ID" --sort -createdDate --limit 10 --output table

TestFlight のベータ版へのフィードバック

最近のフィードバックを新しい順に一覧表示します。

  • asc testflight feedback list --app "APP_ID" --sort -createdDate --limit 10
  • スクリーンショット付き：asc testflight feedback list --app "APP_ID" --sort -createdDate --limit 10 --include-screenshots
  • ビルドで絞り込む：asc testflight feedback list --app "APP_ID" --build-id "BUILD_ID" --sort -createdDate
  • すべてのフィードバック：asc testflight feedback list --app "APP_ID" --paginate

パフォーマンス診断（ハング、ディスク書き込み、起動）

ビルド ID が必要です。asc builds info --app "APP_ID" --latest --platform IOS または asc builds list --app "APP_ID" --sort -uploadedDate --limit 5 で確認します。

  • 診断シグネチャを一覧表示する：asc performance diagnostics list --build-id "BUILD_ID"
  • 種類で絞り込む：asc performance diagnostics list --build-id "BUILD_ID" --diagnostic-type "HANGS"
    • 種類：HANGS、DISK_WRITES、LAUNCHES
  • シグネチャのログを表示する：asc performance diagnostics view --id "SIGNATURE_ID"
  • すべてのメトリクスをダウンロードする：asc performance download --build-id "BUILD_ID" --output ./metrics.json

ID の確認

  • 名前からアプリ ID を確認する：asc apps list --name "AppName" または asc apps list --bundle-id "com.example.app"
  • 最新のビルド ID：asc builds info --app "APP_ID" --latest --platform IOS
  • 最近のビルド：asc builds list --app "APP_ID" --sort -uploadedDate --limit 5
  • デフォルトを設定する：export ASC_APP_ID="APP_ID"

要約形式

結果を提示するときは、重大度と頻度に基づいて整理します。

  1. 合計件数 — 結果に含まれるクラッシュ／フィードバックの件数。
  2. 主なクラッシュシグネチャ — 例外の種類またはクラッシュの理由ごとに分類し、件数順に並べます。
  3. 影響を受けたビルド — 影響を受けたビルドのバージョン。
  4. デバイスと OS の内訳 — 影響が最も大きいデバイスモデルと OS バージョン。
  5. タイムライン — クラッシュの発生時期または急増した時期。

パフォーマンス診断では、重みが最も大きいシグネチャを先に取り上げます。

注意事項

  • 読み取りコマンドの出力形式は、ターミナルではデフォルトでテーブル、パイプまたは CI では JSON です。結果を解析する場合は、形式を明示的に指定してください。
  • 全ページを取得して完全な分析を行うには、--paginate を使用します。
  • コマンド出力のデバッグには、JSON とともに --pretty を使用します。
  • App Store Connect のクラッシュデータには、24～48 時間の遅延が生じる場合があります。

コメント

Markdown 対応