session-handoff について
作業終了時やコンテキストが上限に近いとき、プロセス間でセッション情報を引き継ぐスキルです。スクリプトでログを書き込み、アクティブなタスクを確認して、独立したターミナルウィンドウを開きます。
主な機能
- 01アトミックロックによる引き継ぎログの書き込み
- 02引き継ぎ前のアクティブタスク確認
- 03クロスプラットフォームのOS判定マトリクス
- 04メモリファイルからのコンテキスト統合
活用シーン
- 01長時間セッション終了前の継続準備
- 02コンテキスト上限が近い場合の引き継ぎ
- 03依頼に応じた再起動やシフト交代
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ oimiragieo/ agent-studio --skill session-handoffインストール後、Claude Code で/session-handoffを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
session-handoff.cjscommands/session-handoff.mdhooks/post-execute.cjspre-execute.cjsreferences/research-requirements.mdrules/session-handoff.mdschemas/input.schema.jsonoutput.schema.jsonscripts/main.cjstemplates/implementation-template.md詳細
セッション引き継ぎスペシャリスト — Phase 7 のコンテキスト引き継ぎループを実行し、プロセス間でセッションの継続性をネイティブに引き継ぎます。
- アトミックロックを介して、セッション引き継ぎログをディスクに直接、安全に書き込みます。
- アクティブタスクデータベースを確認し、破損やセッション間の競合を防ぎます(ドレインゲート)。
- 検証済みの OS 判定マトリックスを使用して、クロスプラットフォームの GUI ターミナルウィンドウをデタッチして起動します。
使用するタイミング
以下の場合にこのスキルを呼び出します。
- コンテキストが最大容量に達したとき(上限 150k 超)
- ユーザーから明示的に再起動、交代、または継続の準備を求められたとき。
- 長時間の作業セッションを終了する前
実行方法(必須)
セッションの引き継ぎを開始するには、Bash ツールを使用して内部スキル実行ファイルを必ず実行してください。ログを自分で生成してはいけません。スキーマ管理とポーリングは実行ファイルがすべて処理します。
node .claude/skills/session-handoff/session-handoff.cjs
ドレイン完了ゲート
実行ファイルが失敗し、[session-handoff] ABORT: Cannot handoff session while tasks are active. と表示された場合、ドレインルールに従っていません!
再度スキルを実行する前に、TaskUpdate を明示的に使用して、アクティブなタスクをすべて completed または suspended に設定する必要があります。
必須のセットアップ(コンテキストの保持)
スキルを実行する前に、.claude/context/memory/active_context.md が、次のエージェントに伝える必要のあるコンテキストで更新されていることを確認してください。スクリプトはその内容を引き継ぎペイロードに統合します。
コメント
Markdown 対応