asc-crash-triage

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

asc crash triage

asc 崩溃问题分类处理

Use this skill to fetch, analyze, and summarize TestFlight crash reports, beta feedback, and performance diagnostics.

使用该技能可获取、分析并汇总TestFlight崩溃报告、Beta版反馈和性能诊断信息。

Workflow

工作流程

Resolve the app ID if not provided (use
```
asc apps list
```
).
Fetch data with the appropriate command.
Parse JSON output and present a human-readable summary.

如果未提供App ID，先获取（使用
```
asc apps list
```
命令）。
使用合适的命令获取数据。
解析JSON输出结果，生成便于人工阅读的汇总内容。

TestFlight crash reports

TestFlight崩溃报告

List recent crashes (newest first):

asc crashes --app "APP_ID" --sort -createdDate --limit 10

Filter by build:

asc crashes --app "APP_ID" --build "BUILD_ID" --sort -createdDate --limit 10

Filter by device/OS:

asc crashes --app "APP_ID" --device-model "iPhone16,2" --os-version "18.0"

All crashes:
```
asc crashes --app "APP_ID" --paginate
```

Table view:

asc crashes --app "APP_ID" --sort -createdDate --limit 10 --output table

列出近期崩溃记录（按最新排序）：

asc crashes --app "APP_ID" --sort -createdDate --limit 10

按版本筛选：

asc crashes --app "APP_ID" --build "BUILD_ID" --sort -createdDate --limit 10

按设备/系统版本筛选：

asc crashes --app "APP_ID" --device-model "iPhone16,2" --os-version "18.0"

获取全部崩溃记录：
```
asc crashes --app "APP_ID" --paginate
```

表格格式输出：

asc crashes --app "APP_ID" --sort -createdDate --limit 10 --output table

TestFlight beta feedback

TestFlight Beta版反馈

List recent feedback (newest first):

asc feedback --app "APP_ID" --sort -createdDate --limit 10

With screenshots:

asc feedback --app "APP_ID" --sort -createdDate --limit 10 --include-screenshots

Filter by build:

asc feedback --app "APP_ID" --build "BUILD_ID" --sort -createdDate

All feedback:
```
asc feedback --app "APP_ID" --paginate
```

列出近期反馈（按最新排序）：

asc feedback --app "APP_ID" --sort -createdDate --limit 10

包含截图的反馈：

asc feedback --app "APP_ID" --sort -createdDate --limit 10 --include-screenshots

按版本筛选反馈：

asc feedback --app "APP_ID" --build "BUILD_ID" --sort -createdDate

获取全部反馈：
```
asc feedback --app "APP_ID" --paginate
```

Performance diagnostics (hangs, disk writes, launches)

性能诊断（卡顿、磁盘写入、启动）

Requires a build ID. Resolve via

asc builds latest --app "APP_ID" --platform IOS

asc builds list --app "APP_ID" --sort -uploadedDate --limit 5

List diagnostic signatures:

asc performance diagnostics list --build "BUILD_ID"

Filter by type:

asc performance diagnostics list --build "BUILD_ID" --diagnostic-type "HANGS"

Types:
```
HANGS
```
,
```
DISK_WRITES
```
,
```
LAUNCHES
```

Get logs for a signature:

asc performance diagnostics get --id "SIGNATURE_ID"

Download all metrics:

asc performance download --build "BUILD_ID" --output ./metrics.json

需要指定Build ID。可通过

asc builds latest --app "APP_ID" --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 get --id "SIGNATURE_ID"

下载所有指标数据：

asc performance download --build "BUILD_ID" --output ./metrics.json

Resolving IDs

ID获取方法

App ID from name:

asc apps list --name "AppName"

asc apps list --bundle-id "com.example.app"

Latest build ID:

asc builds latest --app "APP_ID" --platform IOS

Recent builds:

asc builds list --app "APP_ID" --sort -uploadedDate --limit 5

Set default:
```
export ASC_APP_ID="APP_ID"
```

通过应用名称获取App ID：

asc apps list --name "AppName"

或

asc apps list --bundle-id "com.example.app"

获取最新版本Build ID：

asc builds latest --app "APP_ID" --platform IOS

获取近期版本：

asc builds list --app "APP_ID" --sort -uploadedDate --limit 5

设置默认App ID：
```
export ASC_APP_ID="APP_ID"
```

Summary format

汇总内容格式

When presenting results, organize by severity and frequency:

Total count — how many crashes/feedbacks in the result set.
Top crash signatures — group by exception type or crash reason, ranked by count.
Affected builds — which build versions are impacted.
Device & OS breakdown — most affected device models and OS versions.
Timeline — when crashes started or spiked.

For performance diagnostics, highlight the highest-weight signatures first.

展示结果时，按严重程度和发生频次整理：

总数 — 结果集中包含的崩溃/反馈数量。
Top崩溃特征 — 按异常类型或崩溃原因分组，按数量排序。
受影响版本 — 哪些版本受到影响。
设备与系统版本分布 — 受影响最严重的设备型号和系统版本。
时间线 — 崩溃开始或激增的时间点。

对于性能诊断结果，优先展示权重最高的特征。

Notes

注意事项

Default output is JSON; use
```
--output table
```
or
```
--output markdown
```
for quick human review.
Use
```
--paginate
```
to fetch all pages when doing a full analysis.
Use
```
--pretty
```
with JSON for debugging command output.
Crash data from App Store Connect may have 24-48h delay.

默认输出格式为JSON；使用
```
--output table
```
或
```
--output markdown
```
参数可生成便于人工快速查看的格式。
进行全面分析时，使用
```
--paginate
```
参数获取所有分页数据。
调试命令输出时，可搭配
```
--pretty
```
参数格式化JSON结果。
App Store Connect的崩溃数据可能存在24-48小时的延迟。