handoff
検証済みv1.0.0セッションの作業内容を引き継ぎファイルに保存し、次セッションの /resume で復元可能にする。
- トリガー: 「引き継ぎ作って」「ハンドオフ保存して」「セッション終了処理して」「handoff」。
- 対象: 現在のプロジェクトのセッション作業内容(引数で補足メモ追加可)。
セッションの作業内容を構造化して引き継ぎファイルに保存し、次のセッションで /resume から復元できるようにします。
前提条件
Claude Code のみ。プロジェクトが git リポジトリであれば変更差分・コミット履歴も引き継ぎ内容に含める(git がなくても動作する)。
入力
$ARGUMENTS
引数で補足メモを追加可能(例: "API の認証部分が未完了")。指定がなければ自動分析のみ。
手順
以下を すべて並列で実行 し、結果をハンドオフファイルに書き出す。 ユーザーへの途中確認は不要。すべて自律的に実行すること。
1. プロジェクト情報の取得(並列実行)
# プロジェクトのルートディレクトリを特定
git rev-parse --show-toplevel 2>/dev/null || pwd
# 現在のブランチ
git branch --show-current
# 未コミットの変更
git status --short
# 差分の統計
git diff --stat
git diff --cached --stat
2. セッション中の作業内容の特定(並列実行)
# 直近のコミット(本セッション中のもの=直近数時間)
git log --oneline --since="8 hours ago"
# 直近で変更されたファイル
git log --since="8 hours ago" --name-only --pretty=format:"" | sort -u | head -30
# 未コミットで変更中のファイル
git diff --name-only
git diff --cached --name-only
3. コンテキストの収集
以下のファイルが存在すれば読み込む(Read ツール使用):
CLAUDE.md(プロジェクト固有の指示)TODO.md/TASKS.md(存在すれば)
コード内の残タスクも抽出:
grep -rn "TODO\|FIXME\|HACK\|XXX" --include="*.ts" --include="*.tsx" --include="*.js" --include="*.jsx" --include="*.py" --include="*.html" --include="*.css" --include="*.vue" --include="*.svelte" . 2>/dev/null | grep -v node_modules | grep -v .git | head -20
4. メモリの確認
~/.claude/projects/ 配下の、現在のプロジェクトに対応するメモリディレクトリの MEMORY.md を確認。
5. ハンドオフファイルの生成
収集した情報をもとに、以下のパスにファイルを書き出す:
パス: ~/.claude/handoff/{project-name}/{YYYY-MM-DD-HHmm}.md
{project-name}はプロジェクトのディレクトリ名(例:my-app)- 日時はファイル生成時のタイムスタンプ
ディレクトリが存在しなければ作成する。
ハンドオフファイルのフォーマット
---
project: {プロジェクト名}
path: {プロジェクトの絶対パス}
branch: {ブランチ名}
created: {YYYY-MM-DD HH:mm}
---
# Handoff: {プロジェクト名}
## 今回やったこと
(セッション中のコミット・変更内容を箇条書きで簡潔に)
## 未完了・途中の作業
(未コミットの変更、作業中だったファイル、中断した理由があれば)
## 重要な判断・発見
(実装中に行った設計判断、発見したバグ、注意点など)
## 残タスク
(TODO コメント、未実装の機能、次にやるべきこと)
## 次のセッションへの申し送り
(次回最初にやるべきこと、注意すべきポイント)
## 補足メモ
(ユーザーが引数で指定した補足があればここに記載)
6. 完了報告
ファイルパスを表示し、次のセッションでの復元方法を案内する:
📋 ハンドオフファイルを保存しました: ~/.claude/handoff/{project-name}/{timestamp}.md
次のセッションで復元するには:
/resume(同じプロジェクトディレクトリで実行すれば自動的にハンドオフを読み込みます)
注意事項
- 各セクションは 3〜5 行程度で簡潔に。冗長にならないようにする。
- コードの断片は含めない。「何をしたか」「何が残っているか」に集中する。
- 機密情報(API キー、パスワード等)は絶対に含めない。
- 同じプロジェクトの古いハンドオフファイルは削除しない(履歴として残す)。