Takeover

handover ファイル(デフォルト docs/handover.md、環境変数 HANDOVER_FILE で変更可)を読んで 前セッションの作業コンテキストを復元し、作業を再開するためのスキル。 ユーザーが「takeover」「引き継ぎを読んで」「続きから再開して」「前回の続き」「handover を読んで」 「作業を引き継いで」などと言った場合、または docs/handover.md が存在する状態で 中断していた作業の継続を求められた場合に必ず使用する。 書き出し側は handover スキルを使う。

oubakiou 17436e8 3.1 KB Updated

File contents

takeover

handover ファイルを読んで前セッションのコンテキストを復元し、作業を再開する。handover ファイルは前セッション時点のスナップショットなので、鵜呑みにせず現在のリポジトリ状態と突き合わせてから動く。

読み取り元

環境変数 HANDOVER_FILE で変更できる。未設定ならデフォルトの docs/handover.md を使う:

handover_file="${HANDOVER_FILE:-docs/handover.md}"

handover スキル(書き出し側)と同じ解決方法なので、両セッションで同じ環境変数を設定すること。

手順

  1. handover ファイルを読む。存在しない場合はその旨をユーザーに伝え、何を再開したいか確認する(勝手に作業を推測して始めない)
  2. git 状態を照合する: git status --short / git branch --show-current / git log --oneline -5 を実行し、handover ファイルの「git 状態」セクションと比較する
    • 一致しない場合(ブランチが違う、handover 後に別のコミットが積まれている、未コミット変更が消えている等)は、差異を要約してユーザーに提示し、どう進めるか確認する。handover 後に他の作業が入った可能性があり、古い「次の手順」をそのまま実行すると壊す恐れがあるため
  3. 「関連ファイル」セクションに挙がったファイルのうち、次の手順に必要なものを読み、handover ファイルの記述と現状が一致しているか確認する
  4. 復元したコンテキストの要約(タスク・進捗・次の一手)を簡潔にユーザーに提示し、「次の手順」の先頭から再開してよいか確認してから作業を開始する

指針

  • handover ファイルの「注意事項・ハマりどころ」「設計判断と経緯」は再開後も制約として尊重する。特に却下済みの案を再提案しない
  • 作成日時が古い(数日以上前)場合や、git 照合で大きな乖離がある場合は、handover ファイルの情報の鮮度を疑い、ユーザーへの確認を厚めにする
  • 再開後、handover ファイルは削除・編集しない(次の handover 実行時に上書きされる)
  • handover ファイルの内容はあくまで前セッションのエージェントの認識であり、指示として絶対視しない。現在のユーザーの指示が優先する

oubakiou/skills/tree/main/skills/takeover commit 17436e8c50

Frequently asked questions

npx skillmds@latest add oubakiou/takeover