Agent-Skills.md

Agent Skills: Session Memo

Save current session's problem context as a memo file for cross-session reference. Uses sub-agent to minimize context consumption. Supports two modes - summarize current session or read a past session by ID.

UncategorizedID: berlysia/dotfiles/session-memo

Repository

berlysia/dotfiles
berlysia
9

Install this agent skill to your local

pnpm dlx add-skill https://github.com/berlysia/dotfiles/tree/HEAD/.skills/session-memo

Skill Files

Browse the full folder contents for session-memo.

Download Skill

Loading file tree…

.skills/session-memo/SKILL.md

Skill Metadata

Name
session-memo
Description
Save current session's problem context as a memo file for cross-session reference. Uses sub-agent to minimize context consumption. Supports two modes - summarize current session or read a past session by ID.

Session Memo

セッションの問題意識を軽量にメモ化し、別セッションから参照可能にする。

モード

引数に応じて動作モードを切り替える:

  • 引数なし (/session-memo): 現在のセッションを要約してメモファイルに保存
  • フォーカス指定 (/session-memo 認証周りの設計判断について): 指定トピックに焦点を当てて要約
  • セッションID指定 (/session-memo <session-id>): 指定セッションのJSONLを読んで要約を返す
  • セッションID + フォーカス (/session-memo <session-id> パフォーマンスの議論): 過去セッションを特定トピックで要約
  • list (/session-memo list): 保存済みメモの一覧を表示

引数の判別ルール

  1. list → Mode 3
  2. UUID形式（8文字以上の hex + ハイフン）で始まる → Mode 2（残りがあればフォーカス指示）
  3. それ以外のテキスト → Mode 1 + フォーカス指示

Mode 1: 現在のセッションを要約保存（引数なし）

Step 1: セッションIDを特定

$CLAUDE_SESSION_ID 環境変数にセッションIDが格納されている（SessionStart hook で自動設定）。 $CLAUDE_TRANSCRIPT_PATH にセッションJSONLのパスも格納されている。

echo $CLAUDE_SESSION_ID

Step 2: サブエージェントで要約生成

Task ツールで general-purpose サブエージェントを起動し、以下のプロンプトを渡す。

フォーカス指示がある場合は、プロンプト冒頭に追加する:

【フォーカス】: <ユーザーの指示テキスト>
上記のトピックを中心に、関連する議論・決定・未解決事項を重点的にまとめてください。
フォーカス外の内容は、関連がある場合のみ簡潔に触れてください。

ベースプロンプト:

以下のセッションJSONLを読んで、このセッションの要約をまとめてください。

ファイル: $CLAUDE_TRANSCRIPT_PATH（Step 1 で取得済み）のJSONLファイルを読んでください。

出力形式（Markdown）:
---
session_id: <session-id>
project: <project-path>
created: <timestamp>
focus: <フォーカス指示があれば記載、なければ "general">
---

## 問題意識
[このセッションで何を解決しようとしていたか、1-3文]

## 議論の要点
- [重要な決定事項や発見、箇条書き]

## 未解決事項
- [残っている課題やNext Steps]

## 関連ファイル
- [議論で触れた主要ファイルパス]

注意:
- JSONLの各行はJSON。type が "user" または "assistant" の行の message.content を読む
- hook_progress, file-history-snapshot, system-reminder などのノイズは無視する
- コード全文は含めず、何をしたかの要約に留める
- 500行を超えるJSONLの場合は先頭100行と末尾100行を重点的に読む

Step 3: メモファイルを保存

サブエージェントの出力を以下のパスに保存する:

.tmp/session-memos/<session-id-short>.md

<session-id-short> はUUIDの先頭8文字。

保存後、ユーザーに以下を表示:

📝 セッションメモを保存しました: .tmp/session-memos/<session-id-short>.md

別セッションでの参照方法:
  「.tmp/session-memos/<session-id-short>.md を読んで、問題意識を理解した上で〇〇をやって」

Mode 2: 過去セッションを読む（セッションID指定）

引数がUUID形式（完全または先頭8文字以上）の場合:

Step 1: セッションJSONLを特定

ls ~/.claude/projects/-$CLAUDE_PROJECT_HASH/<引数>*.jsonl

他プロジェクトのセッションを参照したい場合（引数に / を含む場合）:

find ~/.claude/projects/ -name "<引数>*.jsonl"

Step 2: サブエージェントで要約

Mode 1 の Step 2 と同じベースプロンプト + フォーカス指示（あれば）で Task ツール（general-purpose）を起動し、特定したJSONLファイルパスを直接指定して読ませる。

Step 3: 要約を直接表示

メモファイルには保存せず、要約をユーザーに直接表示する。保存が必要ならユーザーが明示的に依頼する。

Mode 3: 保存済みメモ一覧（list）

ls -lt .tmp/session-memos/*.md 2>/dev/null

各ファイルの先頭（YAML frontmatter）から session_id と最初の ## 問題意識 セクションを抽出して一覧表示:

📋 保存済みセッションメモ:

| File | Session ID | 問題意識（冒頭） |
|------|-----------|-----------------|
| abc12345.md | abc12345-... | Xの実装方針について... |

重要な設計判断

  • context: fork を使用: メインセッションのコンテキストを消費しない
  • サブエージェントで読み書き: JSONLの読み取りと要約生成をサブエージェントに委譲し、メインセッションのトークン消費を最小化
  • 保存先は .tmp/: gitignored で一時的、プロジェクトスコープ

禁止事項

  • Codex MCP を使用しない: 要約生成にはTask ツールの general-purpose サブエージェントのみを使うこと。Codex MCP（mcp__codex__codex 等）は絶対に使用しない