mcpField
S
session-report

session-report

github.com/clineエージェントワークフロー391.5k 回インストール15 週間前に更新
リポジトリ

session-report について

Claude Codeの利用状況をまとめた、単体で閲覧できるHTMLレポートを生成するスキルです。セッション分析データを付属テンプレートに取り込み、所見や提案を加えて作業ディレクトリに保存します。

主な機能

  1. 01期間を指定したセッション分析
  2. 02プロジェクトやスキル別の利用集計
  3. 03分析データのHTMLテンプレートへの埋め込み
  4. 04所見と提案の追加

活用シーン

  1. 011週間のClaude Code利用状況を振り返る
  2. 02トークン消費の多いプロジェクトやプロンプトを特定
  3. 03キャッシュやサブエージェントの利用を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cline/skills --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 件に絞ります(すでに上限が設定されているはずです)。

コメント