coaching-session-summarizer

コーチングセッションの要約

概要

コーチング／セラピーのセッションの文字起こしを分析し、構造化された要約 （主な洞察、決定事項、アクションアイテム、詳細な分析、関連するトレイル）を ノートに追記します。

エージェント（Claude Code）が分析を直接行います — このセッションで文字起こしを 読み、要約を書き込みます。Anthropic API の呼び出しや課金はありません。 すべて現在のサブスクリプション上で実行されます。レガシーの API ベースの スクリプトは、ヘッドレス環境でのフォールバックとしてのみ残されています（下記参照）。

このスキルを使うタイミング

• 新しい Fathom／Granola の文字起こしが Vault に同期されたとき（コーチングまたはセラピー）
• ユーザーがセッションの要約／分析を依頼したとき（/summarize-session [file] など）
• calendar-sync の実行後、または Granola のエクスポート後に、新しい *-coaching.md、 *-therapy.md、または *-session.md ファイルが作成されたとき — 要約するか確認します

ワークフロー（エージェント主導 — デフォルト）

ネイティブツールを使って、このセッション内で実行します。API キーは不要です。

ステップ 1 — コンテキストを収集する

決定論的なヘルパーを実行し、文字起こしのテキスト、過去のセッション、 トレイルの一覧をまとめて取得します。

python3 ~/.claude/skills/coaching-session-summarizer/scripts/gather_context.py \
  <transcript-file> --vault ~/Brains/brain

次の内容が出力されます。

• 同じ参加者の過去のセッション（パス）— セッション間のパターンを検出するため、詳細モードの場合のみ Read で読み取ります
• 利用可能なトレイル — 関連性の高いものを 2～4 件選んでリンクします
• セッションの内容 — 分析対象の要約と文字起こし（再実行時も内容が重複しないよう、既存の AI 生成要約は削除されます）

ファイル名に人物名が含まれていない場合（例：Granola のエクスポートでトピック名が付けられている場合）は、 --participant <name-slug> を渡します。例：--participant gleb-kalinin。

ステップ 2 — 分析する

セッションアナリストとしての分析的な視点で、セッションの内容を読み取り、次の項目を抽出します （客観的に分析し、重要な箇所では話者本人の自然な言葉遣いを用います）。

• 主な洞察 — 主な気づき／突破口／所見を 3～5 件
• 決定事項 — 具体的な選択や約束
• アクションアイテム — 具体的な次のステップ。時間的な制約があるものには [URGENT]、スケジュール調整に関するものには [SCHEDULING] を先頭に付けます
• セッションのテーマ — 繰り返し取り上げられるトピックやパターンを 2～3 件

詳細モード（デフォルトではセラピーと節目となるセッションに適用）— 過去のセッションも Read で読み取り、次の項目を追加します。

• パターンの検出 — 複数のセッションで繰り返されるテーマ
• 進捗の評価 — 以前の約束に対する進展
• 活力／意欲の指標 — 活力、抵抗感、感情の変化
• 潜在的な障害 — 進捗を妨げる可能性のある要因

ステップ 3 — Edit で追記する

Edit を使って文字起こしファイルの末尾に要約を追記します（既存の内容を 上書きしないでください）。次の構成と完全に一致させます。

## AI-Generated Summary

*Generated: YYYY-MM-DD*

### Key Insights
- ...

### Decisions Made
- ...

### Action Items
- [URGENT] ...
- ...

### Session Themes
- ...

## Deep Analysis

- **Pattern Detection**: ...
- **Progress Assessment**: ...
- **Energy/Motivation Markers**: ...
- **Potential Obstacles**: ...

## Connected Trails

- [[Trails/Trail - <Name>|<Name>]]
- [[Trails/Trail - <Name>|<Name>]]

Generated の行には現在の日付（date +%Y-%m-%d）を使用します。簡易モードでは Deep Analysis セクションを省略します。トレイルのリンク名は、出力されたトレイル一覧と 照合してください。Obsidian のリンクでは、大文字と小文字および正確な表記が重要です。

モード

• quick — 主な洞察、決定事項、アクションアイテム、テーマ。詳細な分析と過去のセッションの読み取りは省略します。
• deep（セラピー／節目となるセッションに推奨）— パターン検出のために過去のセッションを読むことも含め、すべて実行します。

同期との連携

calendar-sync の実行後、または Granola／Fathom のエクスポート後に、新しいセッションファイル （*-coaching.md、*-therapy.md、*-session.md）がないか確認します。ファイルが見つかった場合は、 「新しいセッションが見つかりました。今すぐ要約しますか？」と提案します。セラピーではデフォルトで詳細モードを使用します。

補足

• 元の文字起こしはそのまま保持し、要約は常に追記します。
• トレイルへのリンクには、Vault のルートに Trails/ ディレクトリが必要です。
• セッション間の比較には、一貫した命名規則が最適です。 YYYYMMDD-name-coaching.md ／ YYYYMMDD-name-therapy.md。
• 再実行しても問題ありません。gather_context.py は出力前に既存の AI 生成要約を削除するため、エージェントはセッションの生データのみを分析します。（要約を積み重ねずに置き換えたい場合は、再度追記する前にファイルから古い ## AI-Generated Summary ブロックを削除してください。）

リソース

scripts/

• gather_context.py — （デフォルトのパス）API を使用しない、決定論的なコンテキスト収集ツールです。トランスクリプトのテキスト、以前のセッション、トレイルの一覧を出力し、エージェントがセッション中に分析できるようにします。
• summarize_session.py — レガシー／ヘッドレス環境向けのフォールバックです。 Anthropic API を直接呼び出し（モデルは SUMMARIZER_MODEL で指定し、デフォルトは claude-sonnet-4-6）、クレジットのある ANTHROPIC_API_KEY を使用して課金します。インタラクティブなエージェントを利用できない場合（例：cron）のみ使用してください。キーにクレジットがない場合は、明確なメッセージを表示して終了します。