mcpField
S
session-report

session-report

github.com/anthropicsエージェントワークフロー45.1k3.8k 回インストール1 日前に更新
リポジトリ

session-report について

Claude Code のセッション利用データを、単体で閲覧できる HTML レポートにまとめるスキルです。分析結果をもとに利用状況の内訳を示し、簡潔な所見と提案を加えます。

主な機能

  1. 01指定期間のセッション利用状況を分析
  2. 02HTML テンプレートで JSON 指標を表示
  3. 03データに基づく所見を記載
  4. 04レポートの数値に沿った提案を追加

活用シーン

  1. 01最近の Claude Code トークン利用量を確認
  2. 02プロジェクトやスキルごとの利用量を比較
  3. 03キャッシュ切れや大きすぎるプロンプトを発見
  4. 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 レポートを作成し、現在の作業ディレクトリに保存します。

手順

  1. データを取得します。 同梱のアナライザーを実行します(デフォルトの期間:過去 7 日間。ユーザーが 24h、30d、all など別の期間を指定した場合は、それに従います)。スクリプト analyze-sessions.mjs はこの SKILL.md と同じディレクトリにあります。絶対パスを使用してください。

    node <skill-dir>/analyze-sessions.mjs --json --since 7d > /tmp/session-report.json
    

    全期間を対象にする場合は、--since を省略します。

  2. 読み取ります。 /tmp/session-report.json の overall、by_project、by_subagent_type、by_skill、cache_breaks、top_prompts に目を通します。

  3. テンプレートをコピーします。(この SKILL.md と同じ場所に同梱されています)現在の作業ディレクトリにある出力先へコピーしてください。

    cp <skill-dir>/template.html ./session-report-$(date +%Y%m%d-%H%M).html
    
  4. 出力ファイルを編集します。(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 件のサブエージェントを起動しました。並列エージェントを減らすよう範囲を絞ってください」)。
    • 既存のセクション構成は変更しないでください。
  5. 保存したファイルのパスをユーザーに伝えます。 開いたり、レンダリングしたりしないでください。

注記

  • インタラクティブ機能(並べ替え、展開/折りたたみ、ブロック文字のバー)はテンプレートが担います。作業内容はデータと所見であり、マークアップではありません。
  • コメントは簡潔かつ具体的にし、JSON にある実際のプロジェクト名、数値、タイムスタンプを参照してください。
  • top_prompts にはすでにサブエージェントのトークン数が含まれており、task-notification による継続分は元のプロンプトに集約されています。
  • JSON が 2MB を超える場合は、埋め込み前に top_prompts を 100 件、cache_breaks を 100 件に絞ります(すでに上限が設定されているはずです)。

コメント