# Session Handoff

> 長いセッションを終える前や、コンテキストを整理して新セッションへ引き継ぐときに、現在のゴール・変更ファイル・設計判断・次の手順・検証コマンドを簡潔なMarkdownノートに書き出すスキル。「ハンドオフ」「引き継ぎメモ」「session handoff」「/clearする前に整理して」「セッションを引き継ぎたい」などと言われたとき、またはコンテキストが肥大化して新セッションでの再開を勧めるときに使用する。肥大化した会話を捨て、最小限の文脈で再開できるようにしてトークンを節約する。

- Skill: `ntaksh42/session-handoff` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ntaksh42/session-handoff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ntaksh42/session-handoff/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: ntaksh42 (https://skillmd.com/u/ntaksh42)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/ntaksh42/session-handoff

---


# session-handoff

長いセッションのコンテキストを、新しいセッションで最小トークンで再開できる「引き継ぎノート」に凝縮する。`/clear` や新セッション開始の直前に使うことを想定する。

## いつ使うか

- セッションが長くなり、コンテキストの大半が現在のタスクと無関係になったとき
- 作業を中断し、後で別セッションで再開するとき
- ユーザーが「引き継ぎ」「ハンドオフ」「/clear前に整理」などと言ったとき

## ワークフロー

### Step 1: 文脈の収集

会話と作業状態から以下を集める（推測で埋めない。読み取れない項目は「不明」と記す）。

- **ゴール**: いま達成しようとしていること（1〜3行）
- **変更ファイル**: `git status --short` と `git diff --stat` の結果（パスと変更概要）
- **設計判断**: これまでに決めたこと・採用/却下した方針とその理由
- **次の手順**: 残タスクのチェックリスト
- **検証コマンド**: テスト/ビルド/lint など「完了」を確認するコマンド
- **未解決・ブロッカー**: あれば

### Step 2: ノートの書き出し

保存先: `<プロジェクトルート>/.claude/handoff/<YYYYMMDD-HHmmss>-<短いslug>.md`
（`.claude/` は通常 gitignore 対象。未設定なら `.gitignore` への追加を促す）

テンプレート（外枠は説明用。実ファイルは中身のMarkdownのみ書く）:

````markdown
# ハンドオフ: <タイトル>
日時: <YYYY-MM-DD HH:mm> / ブランチ: <branch>

## ゴール
...

## 変更ファイル
- path/to/file — 変更概要

## 設計判断
- 決定: ... / 理由: ...

## 次の手順
- [ ] ...
- [ ] ...

## 検証コマンド
```
<テスト/ビルド/lint コマンド>
```

## 未解決・ブロッカー
- ...
````

### Step 3: 報告と次アクションの提案

- 保存先パスを報告する
- 「`/clear` で文脈をリセットし、新セッションでこのノートを `@<path>` で読み込めば最小トークンで再開できます」と案内する

## 重要な注意点

- **簡潔さ最優先**: ノート自体が肥大化すると本末転倒。要点のみを書き、全文ログは残さない
- **推測しない**: 会話から読み取れない項目は「不明」と記す（save-report と同方針）
- **検証コマンドは必須**: 新セッションで「完了」を判定できるようにするため、テスト/ビルドコマンドを必ず含める