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按设备型号和操作系统版本比较崩溃
  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 崩溃报告、Beta 反馈和性能诊断数据。

工作流

  1. 如果未提供 App 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 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-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

  • 根据名称获取 App 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-48h。

评论

支持 Markdown