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
• 按 Build 筛选：asc testflight crashes list --app "APP_ID" --build "BUILD_ID" --sort -createdDate --limit 10
• 按设备/系统版本筛选：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
• 按 Build 筛选：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 获取。

• 列出诊断特征：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
• 获取近期 Build 列表：asc builds list --app "APP_ID" --sort -uploadedDate --limit 5
• 设置默认环境变量：export ASC_APP_ID="APP_ID"

汇总格式

呈现结果时，请按严重程度和发生频率进行组织：

1. 总计数量 — 结果集中的崩溃/反馈数量。
2. 高频崩溃特征 — 按异常类型或崩溃原因分组，并按数量排序。
3. 受影响 Build — 具体波及的 Build 版本。
4. 设备与 OS 分布 — 受影响最多的设备型号与 OS 版本。
5. 时间线 — 崩溃开始出现或集中爆发的时间段。

对于性能诊断，优先突出权重最高的特征。

注意事项

• 默认输出格式为 JSON；如需快速人工查看，可使用 --output table 或 --output markdown。
• 进行完整分析时，使用 --paginate 获取所有页面的数据。
• 调试命令输出时，可结合 --pretty 参数查看 JSON。
• 来自 App Store Connect 的崩溃数据可能存在 24-48 小时延迟。