# Handover

> セッション終了時やコンパクト前に、セッションの要約をHANDOVER.mdに保存する。 決定事項、落とし穴、学んだ教訓、次のアクションを記録し、 次のセッションへのスムーズな引き継ぎを実現する。 また、セッションで得た知見からSKILLやCLAUDE.mdの改善も提案する。 以下の依頼時に使用: - 「handover」「引き継ぎ」「セッション終了」 - 「コンパクト前に保存」「文脈を残して」 - 「次のセッションに引き継ぎたい」

- Skill: `ebal5/handover` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ebal5/handover`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ebal5/handover/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: ebal5 (https://skillmd.com/u/ebal5)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/ebal5/handover

---


# Session Handover

セッションの作業内容を要約し、次のセッションのClaudeがスムーズに引き継げる
HANDOVER.mdを作成する。

## 手順

### Step 1: セッション内容の振り返り

会話全体を振り返り、以下の情報を整理する：

- 何を達成したか（完了したタスク）
- 何を決定したか（設計判断、技術選定など）
- どんな問題に遭遇したか（バグ、落とし穴、予想外の挙動）
- 何を学んだか（教訓、知見）
- 何が未完了か（残タスク、ブロッカー）

### Step 2: HANDOVER.md の作成

`HANDOVER.md` を保存するディレクトリを決定する：

- **引数でディレクトリが指定された場合** (例: `/path/to/dir` を含む引数):
  そのディレクトリ直下に `HANDOVER.md` を作成する。
  worktree 内での作業で親ワークツリー（メインクローン）に保存したい場合に
  使用する典型的なパターン
- **指定がない場合**: 現在のプロジェクトルート（`pwd`）に作成する

その他の共通ルール:

- 既存ファイルがある場合は内容を表示し、**上書き/追記/キャンセル**の選択を
  ユーザーに求める。ただし `HANDOVER.md` が `.gitignore` 済み
  （セッション単位の使い捨て前提）なら、既存内容の表示は残したうえで
  上書きを既定にして確認を簡略化してよい
- 日時は `date '+%Y-%m-%d %H:%M'` で取得する
- ブランチ名は `git -C <target-dir> branch --show-current` で取得する
  （引数指定時は対象ディレクトリのブランチを参照）
- コード状態は `git -C <target-dir> status` と `git -C <target-dir> diff --stat`
  で確認する
- 該当なしのセクションは省略してよい

```markdown
# Session Handover

**日時**: YYYY-MM-DD HH:MM
**ブランチ**: <現在のブランチ名>

## 完了したタスク

- タスク1の説明
- タスク2の説明

## 決定事項

- **決定内容**: 理由・背景
- **決定内容**: 理由・背景

## 遭遇した問題・落とし穴

- **問題**: 原因と対処法
- **問題**: 原因と対処法

## 学んだ教訓

- 教訓1
- 教訓2

## 未完了タスク・次のアクション

- [ ] タスク1の説明（優先度: 高/中/低）
- [ ] タスク2の説明（優先度: 高/中/低）

## 現在のコード状態

- コミット済み/未コミットの変更の概要
- テストの状態
- 既知の問題

## コンテキスト（次のセッションへの注意点）

- 作業中に気づいたが手を付けなかったこと
- 次のセッションで最初に確認すべきこと
```

### Step 3: SKILL / CLAUDE.md の改善提案

セッション中の作業から得た知見をもとに、以下の改善を提案する：

1. **CLAUDE.md の改善**:
   - 新たに判明したプロジェクト固有のルールやパターン
   - 追加すべき開発コマンドや注意事項
   - 既存の記述で修正が必要な箇所

2. **スキルの改善**:
   - 既存スキルで不足している機能や説明
   - 新しいスキルとして切り出すべきパターン

3. **ルールファイルの改善** (`.claude/rules/`):
   - 追加すべきルールやガイドライン

改善提案はユーザーに確認の上、承認されたもののみ反映する。

## 次のセッションでの使い方

次のセッション開始時に以下のようにClaudeに指示する：

```text
HANDOVER.md を読んで前回の作業を確認してください
```

引き継ぎ完了後、HANDOVER.mdは不要になるため削除してよい。

## 注意事項

- HANDOVER.mdは一時的な引き継ぎ文書であり、永続的なドキュメントではない
- プロジェクトの `.gitignore` にHANDOVER.mdを追加することを推奨
- 機密情報（パスワード、トークン等）は絶対に含めない