mcpField
G
gpc-vitals

gpc-vitals

github.com/androidpoetテスト・品質440 回インストール17 週間前に更新
リポジトリ

gpc-vitals について

コマンドラインから Android アプリの健全性指標を確認するスキルです。Google Play アプリを監視するチーム向けに、クラッシュ、ANR、起動・描画指標を調べ、期間ごとの比較を支援します。

主な機能

  1. 01アプリの健全性概要の確認
  2. 02クラッシュ率と ANR 率の取得
  3. 03起動・描画パフォーマンスの確認
  4. 04ウェイクアップ、ウェイクロック、メモリの監視
  5. 05エラー数とグループ化された問題の表示

活用シーン

  1. 01最近のアプリ健全性の傾向把握
  2. 02リリース前後の指標変化の評価
  3. 03クラッシュや ANR の調査
  4. 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 スキルを参照してください。

コメント