session-report について
Claude Code のセッション利用データを、単体で閲覧できる HTML レポートにまとめるスキルです。分析結果をもとに利用状況の内訳を示し、簡潔な所見と提案を加えます。
主な機能
- 01指定期間のセッション利用状況を分析
- 02HTML テンプレートで JSON 指標を表示
- 03データに基づく所見を記載
- 04レポートの数値に沿った提案を追加
活用シーン
- 01最近の Claude Code トークン利用量を確認
- 02プロジェクトやスキルごとの利用量を比較
- 03キャッシュ切れや大きすぎるプロンプトを発見
- 04共有可能な HTML 利用レポートを保存
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ anthropics/ claude-plugins-official --skill session-reportインストール後、Claude Code で/session-reportを入力して読み込まれたか確認します。
同梱ファイルanalyze-sessions.mjstemplate.html
詳細
セッションレポート
Claude Code の使用状況をまとめた自己完結型の HTML レポートを作成し、現在の作業ディレクトリに保存します。
手順
-
データを取得します。 同梱のアナライザーを実行します(デフォルトの期間:過去 7 日間。ユーザーが
24h、30d、allなど別の期間を指定した場合は、それに従います)。スクリプトanalyze-sessions.mjsはこの SKILL.md と同じディレクトリにあります。絶対パスを使用してください。node <skill-dir>/analyze-sessions.mjs --json --since 7d > /tmp/session-report.json全期間を対象にする場合は、
--sinceを省略します。 -
読み取ります。
/tmp/session-report.jsonのoverall、by_project、by_subagent_type、by_skill、cache_breaks、top_promptsに目を通します。 -
テンプレートをコピーします。(この SKILL.md と同じ場所に同梱されています)現在の作業ディレクトリにある出力先へコピーしてください。
cp <skill-dir>/template.html ./session-report-$(date +%Y%m%d-%H%M).html -
出力ファイルを編集します。(Write ではなく Edit を使用し、テンプレートの JS/CSS を保持してください)
<script id="report-data" type="application/json">の内容を手順 1 の完全な JSON に置き換えます。ページの JS が、このデータからヒーローの合計値、すべての表、バー、詳細表示を自動的に描画します。- `` ブロックに、1 行で 3~5 件の所見を記入します。可能な限り、数値は総トークン数に占める割合で示してください(総数 =
overall.input_tokens.total + overall.output_tokens)。所見は 1 件につき 1 行とし、マークアップは次の形式にしてください。
クラス:無駄や異常には<div class="take bad"><div class="fig">41.2%</div><div class="txt"><b>cc-monitor</b> consumed 41% of the week across just 3 sessions</div></div>.take bad(赤)、健全な傾向には.take good(緑)、中立的な事実には.take info(青)を使用します。.figは短い数値(割合、件数、12×のような倍率)を 1 つ記入します。.txtはプロジェクト/スキル/プロンプト名を挙げた平易な英語の文を 1 文記入し、対象を<b>で囲みます。確認する項目:不釣り合いに多く消費しているプロジェクトやスキル、キャッシュヒット率が 85% 未満のもの、総数の 2% を超える単一プロンプト、1 回あたりの平均トークン数が 1M を超えるサブエージェントの種類、集中して発生しているキャッシュ切断。 - ページ最下部の `` ブロックに、特定の行に結び付いた提案を
<div class="callout">で 1~4 件記入します(例:「/weekly-statusは総数の 8.1% を消費して 7 件のサブエージェントを起動しました。並列エージェントを減らすよう範囲を絞ってください」)。 - 既存のセクション構成は変更しないでください。
-
保存したファイルのパスをユーザーに伝えます。 開いたり、レンダリングしたりしないでください。
注記
- インタラクティブ機能(並べ替え、展開/折りたたみ、ブロック文字のバー)はテンプレートが担います。作業内容はデータと所見であり、マークアップではありません。
- コメントは簡潔かつ具体的にし、JSON にある実際のプロジェクト名、数値、タイムスタンプを参照してください。
top_promptsにはすでにサブエージェントのトークン数が含まれており、task-notification による継続分は元のプロンプトに集約されています。- JSON が 2MB を超える場合は、埋め込み前に
top_promptsを 100 件、cache_breaksを 100 件に絞ります(すでに上限が設定されているはずです)。
コメント
Markdown 対応