| name | handoff |
| description | このセッションの作業を引き継ぐ時に使う。状況を判定して2モードに分岐する — compact(同一セッションを /compact で圧縮して続ける) / new-session(セッションが壊れた・新しいセッションで続ける)。どちらも引き継ぎ内容を tmp ファイル(構造化 md)に書き出し、それを読んで再開させる短い起動文を出す。「コンパクト前準備」「コンパクトしたい」「圧縮して続けたい」「/compact の前に」「セッションが壊れた」「次のセッションに引き継ぐ」「クラッシュした」「session handoff」「新しいセッションで続けたい」などで発火。writing-plans → executing-plans 移行直前や worktree 切替直後の /compact 前にも使う。 |
Handoff
Overview
このセッションの作業を引き継ぐための skill。引き継ぎ内容を tmp ファイル(構造化 md)に書き出し、それを正(source of truth)とする。出力する起動文は「そのファイルを読んで再開手順に従って続けて」の短い1行で、長い引き継ぎ本文を再開先の context に貼り込まない。
状況に応じて2モードに分岐する:
| モード | いつ | 出力する起動文 |
|---|
| compact | セッションは生きていて /compact で圧縮して同一セッションを続けたい | /compact 用 focus 文 + 圧縮後に貼る1行(ファイルを読んで再開) |
| new-session | セッションが壊れた／怪しい、または新しいセッションで続けたい(今のを捨てる) | 新セッションで貼る1行(ファイルを読んで再開) |
/compact 自体は CLI スラッシュコマンドのためモデルからは実行できない。ユーザー操作が必須。
モード判定(skill 冒頭で必ず行う)
起動時にまずモードを判定する。
| signal | → モード |
|---|
| 「compact」「圧縮して続けたい」「/compact の前に」「コンパクト前準備」「context 逼迫だが続けたい」、writing-plans → executing-plans 移行直前、worktree 切替直後の /compact | compact |
| 「セッションが壊れた」「クラッシュ」「次のセッションに引き継ぐ」「新しいセッションで」「session handoff」「壊れたので引き継ぎ」 | new-session |
| どちらとも取れる(signal が弱い／拮抗) | 1問だけ AskUserQuestion で確認 |
- 判定が明白なら「○○モードと判断しました」と1行宣言して即実行。質問しない。
- 曖昧な時のみ AskUserQuestion で compact / new-session を1問確認 → 実行。
共通フロー(基本ノンストップ)
引数がなければ聞き返さない。 会話履歴から自動抽出して即書き出す。
1. 引数(あれば次の作業予定の自然文) + 会話履歴から引き継ぎ内容を自動抽出
↓
2. scratchpad ディレクトリ直下に構造化 md を書く(絶対パス・命綱)
↓
3. モード別の起動文を出力(コードフェンスでコピペ可能に)
↓
4. 「補足あれば言って(無ければそのまま進めてOK)」の1行を添えて完了。応答は待たない
- 引数: あれば「次にやること」として後述
## 再開手順 の先頭に反映する。無ければ会話履歴から推測する。
- 書き出しを最優先: Step 2 が命綱。起動文を出す前にセッションが死んでもファイルは残る。new-session モードでは特に、Read/Grep を増やさず手元の会話 context だけで一気に書き切る。
- 聞き返さない: 引数が無くても自動抽出で完成させる。補足確認は Step 4 の1行を添えるだけで、ユーザーの応答は待たない(補足が来たらファイルに追記し直す)。
Step 1: 引き継ぎ内容を抽出
抽出する(該当するものは漏らさない):
- 作業カテゴリ(機能開発／バグ修正／レビュー対応／調査 など)
- worktree path / branch
- 編集中ファイルの絶対パス
- 直前の検証・テスト・ビルド・lint の結果
- 完了タスク／未着手タスク
- 確定済みの判断・accept 済み Ops Risks
- 採用しない案(却下した代替案)
- 適用中の skill 名
- (引数があれば)次にやる作業
抽出しない:
- 既存コードを読めば再構築できる事実(API シグネチャ・既存実装の詳細)
- 議論の経緯(再開後に必要なのは結論のみ)
- ファイルの中身そのもの(パスがあれば再開先が再 Read できる)
Step 2: tmp ファイルに構造化 md を書く
環境で案内されている scratchpad ディレクトリ直下に書く(パスはハードコードしない。セッションごとに異なる)。ファイル名は固定 handoff-session.md。既に存在する場合は handoff-session-2.md のように連番を付ける(時刻ベースの命名はしない)。
セクション構成(固定順):
# Handoff: <作業のひと言>
## 作業概要
<何の作業中か。1-3行>
## 状態
- worktree / branch: <絶対パス・ブランチ名>
- 編集中ファイル: <絶対パス列挙>
- 直前の検証結果: <テスト/ビルド/lint の結果。無ければ「未実行」>
## 残タスク
- [ ] <未着手・進行中のタスク>
## 確定済み判断 / 採用しない案
- <accept 済み Ops Risks・確定した設計判断・却下した代替案>
## 再開手順
1. <最初にやる具体アクション>
2. <起動すべき skill。例: /bugfix を起動して継続>
---
（このファイルは tmp。永続化したいなら docs/ 等へ移すこと）
## 再開手順 が構造化の肝。 再開するエージェントは context ゼロから始まる。①最初にやる具体アクション ②起動すべき skill を番号付きで明示すること。これで Read 直後に手が動く。引数で次の作業予定が渡されていれば、その内容をここの先頭に落とす。
パスはすべて絶対パスで書く(再開先は別プロセス・CWD が違う場合がある)。
Step 3: モード別の起動文を出力
ユーザーがコピペできるようコードフェンスで囲む。
compact モード
2 ブロックを出す。
## 1. /compact 用 focus
```
以下を必ず要約に保持してください:
- 引き継ぎファイル: <handoff md の絶対パス>
- <他に要約後も即参照したい最小の path / 確定判断があれば>
他は適宜要約してよい。
```
実行: `/compact` 実行後、focus 入力欄に上記を貼る
---
## 2. /compact 後に貼るプロンプト
```
<handoff md の絶対パス> を読んで、再開手順に従って続けてください。
```
実行: /compact 完了後、本セッションで上記をそのまま送信
- focus には引き継ぎファイルの絶対パスを必ず含める(要約後にこのパスを見失うと再開できない)。
- focus は「保持すべき最小の固有情報」だけを箇条書きにする。引き継ぎ本文は md 側にあるので、focus に本文を再記述しない。
new-session モード
1 ブロックを出す。
## 新セッションで貼るプロンプト
```
<handoff md の絶対パス> を読んで、再開手順に従って続けてください。
```
実行: 新しいセッションを起動し、最初のターンで上記をそのまま送信
両モードとも起動文は短い1行を基本とし、長い引き継ぎ本文を再開先の context に再注入しない(ファイルが正)。
Step 4: 完了
最後に1行だけ添える:
引き継ぎを <絶対パス> に書きました。補足があれば言ってください(無ければそのまま進めて OK です)。
ユーザーの応答は待たない。補足が来たらファイルに追記する。
superpowers ワークフロー特例(compact モード)
writing-plans 完了直後の compact では、conventions §6.2.1 に従い handoff md と focus に以下を必ず含める:
- spec ファイルパス(
docs/superpowers/specs/xxx.md)
- plan ファイルパス(
docs/superpowers/plans/xxx-plan.md)
- worktree path(現 CWD)
- 残タスク状態(完了 / 未着手)
- accept 済み Ops Risks の状態
handoff md の ## 再開手順 には /superpowers:executing-plans <plan-path> の起動指示を含める。Pre-flight Ops alignment は plan を都度 Read して再 alignment する不変条件があるため(conventions §6.4)、md 内では「accept 済み」と書くだけで十分(plan が source of truth)。
Common Mistakes
- モード判定を飛ばす → 冒頭で必ず判定する。明白なら宣言して即実行、曖昧時のみ1問。
- 引数なしで聞き返す → 基本は聞き返さない。会話履歴から自動抽出して書き切る。
- 「現状の要約」をファイルに延々と書く → ファイルに残すのは保持すべき固有情報(path / 状態 / 確定判断 / 再開手順)。議論の経緯や既存コードの説明は書かない。
- 起動文に引き継ぎ本文を埋める → 本文は md にある。起動文は「ファイルを読んで再開手順に従って」の1行。再開先の context を食わない。
## 再開手順 を曖昧にする → 最初のアクションと起動 skill を番号付きで具体的に。ここが弱いと再開先が迷う。- path を相対で書く → 再開先は別プロセス・CWD が違うことがある。すべて絶対パス。
- モデルが /compact を実行しようとする → CLI スラッシュコマンドのためモデルからは実行不可。ユーザー操作必須。
- compact の focus に引き継ぎファイルパスを入れ忘れる → 要約後にパスを見失い再開不能になる。focus に必ず含める。
- tmp 揮発を過信する →
/tmp はマシン再起動で消える。プロセスが死んだ程度なら残るが、長期保存したいなら md 末尾の注記どおり docs/ 等へ移すよう案内する。
Skip 条件
以下は skill を起動せず直接案内してよい:
- ユーザーが「次の作業は無し、ただ圧縮だけ」と明示(compact だけ案内)
- /clear したい(handoff ではなく完全クリア)
- 5 ターン以内に完結する短い作業の続きで、引き継ぎコストが効果を上回る
