asc-crash-triage

asc crash triage

使用此 Skill 來擷取、分析並統整 TestFlight 閃退報告、Beta 測試回饋與效能診斷資料。

工作流程

1. 若未提供 App ID，先解析取得 App ID（使用 asc apps list）。
2. 使用對應的命令擷取資料。
3. 解析 JSON 輸出並呈現易於閱讀的摘要。

TestFlight 閃退報告

列出近期閃退（按時間由新到舊排序）：

• asc testflight crashes list --app "APP_ID" --sort -createdDate --limit 10
• 按特定版本篩選：asc testflight crashes list --app "APP_ID" --build "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 Beta 測試回饋

列出近期回饋（按時間由新到舊排序）：

• 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 "BUILD_ID" --sort -createdDate
• 取得所有回饋：asc testflight feedback list --app "APP_ID" --paginate

效能診斷（卡頓、磁碟寫入、啟動）

需要提供 Build ID。可透過 asc builds info --app "APP_ID" --latest --platform IOS 或 asc builds list --app "APP_ID" --sort -uploadedDate --limit 5 來解析取得。

• 列出診斷特徵（signatures）：asc performance diagnostics list --build "BUILD_ID"
• 按類型篩選：asc performance diagnostics list --build "BUILD_ID" --diagnostic-type "HANGS"
  • 類型：HANGS（卡頓）、DISK_WRITES（磁碟寫入）、LAUNCHES（啟動）
• 檢視特定特徵的日誌：asc performance diagnostics view --id "SIGNATURE_ID"
• 下載所有指標：asc performance download --build "BUILD_ID" --output ./metrics.json

解析相關 ID

• 依名稱取得 App ID：asc apps list --name "AppName" 或 asc apps list --bundle-id "com.example.app"
• 最新 Build 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. 受影響版本 — 受影響的 Build 版本。
4. 裝置與 OS 分佈 — 受影響最嚴重的裝置型號與 OS 版本。
5. 時間軸 — 閃退開始發生或暴增的時間點。

針對效能診斷，請優先標示出權重最高的特徵（signatures）。

注意事項

• 預設輸出格式為 JSON；欲快速人工查閱可使用 --output table 或 --output markdown。
• 進行完整分析時，請使用 --paginate 擷取所有頁面的資料。
• 偵錯命令輸出時，可搭配 JSON 的 --pretty 參數。
• 來自 App Store Connect 的閃退資料可能會有 24 到 48 小時的延遲。