gpc-vitals について
コマンドラインから Android アプリの健全性指標を確認するスキルです。Google Play アプリを監視するチーム向けに、クラッシュ、ANR、起動・描画指標を調べ、期間ごとの比較を支援します。
主な機能
- 01アプリの健全性概要の確認
- 02クラッシュ率と ANR 率の取得
- 03起動・描画パフォーマンスの確認
- 04ウェイクアップ、ウェイクロック、メモリの監視
- 05エラー数とグループ化された問題の表示
活用シーン
- 01最近のアプリ健全性の傾向把握
- 02リリース前後の指標変化の評価
- 03クラッシュや ANR の調査
- 04起動、描画、メモリ状況の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ androidpoet/ playconsole-cli-skills --skill gpc-vitalsインストール後、Claude Code で/gpc-vitalsを入力して読み込まれたか確認します。
詳細
Android Vitals
アプリの健全性指標、クラッシュ率、ANR 率、パフォーマンス指標を監視する際に、このスキルを使用します。
概要
gpc vitals overview --package com.example.app
gpc vitals overview --days 28 --package com.example.app
個別の指標
クラッシュ率
gpc vitals crashes --package com.example.app
gpc vitals crashes --days 7 --package com.example.app
ANR 率
gpc vitals anr --package com.example.app
gpc vitals anr --days 7 --package com.example.app
起動の遅延
gpc vitals slow-start --package com.example.app
レンダリングの遅延(カクつき)
gpc vitals slow-rendering --package com.example.app
過剰なウェイクアップ
gpc vitals wakeups --package com.example.app
ウェイクロックのスタック
gpc vitals wakelocks --package com.example.app
低メモリキラー
gpc vitals memory --package com.example.app
エラー追跡
エラー数を表示する
gpc vitals errors --package com.example.app
gpc vitals errors --days 7 --package com.example.app
グループ化されたエラーの問題を一覧表示する
gpc vitals errors issues --package com.example.app
健全性チェックのワークフロー
健全性を総合的に評価します。
gpc vitals overview --days 7 --package com.example.app -o table
gpc vitals crashes --days 7 --package com.example.app -o table
gpc vitals anr --days 7 --package com.example.app -o table
エージェントの動作
- 最近の傾向には
--days 7、全体的な健全性には--days 28をデフォルトで使用します。 - ユーザーへの提示には
-o table、データ処理には-o jsonを使用します。 - 指標が Google Play の不適切な動作のしきい値を超えている場合は、警告します。
- クラッシュ率 > 1.09%
- ANR 率 > 0.47%
- リリース前後を比較して、リグレッションを検出します。
注意事項
- Vitals データには Play Developer Reporting API v1beta1 を使用します。
- データには 24〜48 時間の遅延が生じる場合があります。
- クラッシュスタックを読みやすくするため、ProGuard マッピングをアップロードします(
gpc deobfuscation upload)。 - 難読化解除ファイルのアップロードについては、
gpc-build-lifecycleスキルを参照してください。
コメント
Markdown 対応