resume-handoff

引き継ぎドキュメントから作業を再開する

対話形式で引き継ぎドキュメントから作業を再開します。引き継ぎドキュメントには、以前の作業セッションから引き継ぐ必要がある重要なコンテキスト、知見、次のステップが含まれています。

最初の応答

このコマンドが呼び出されたとき：

1. 引き継ぎドキュメントのパスが指定されている場合：

   • パラメーターとして引き継ぎドキュメントのパスが指定されている場合は、既定のメッセージを省略します
   • 引き継ぎドキュメントを直ちに最後まで読みます
   • thoughts/shared/plans または thoughts/shared/research にある、リンク先の調査ドキュメントや計画ドキュメントも直ちに読みます。これらの重要なファイルを読むためにサブエージェントを使用しないでください。
   • 引き継ぎドキュメントから関連するコンテキストを取り込み、そこに記載されている追加ファイルを読んで、分析を開始します
   • その後、ユーザーに対応方針を提案して確認を求めるか、方針について質問します。

2. チケット番号（ENG-XXXX など）が指定されている場合：

   • チケットの最新の引き継ぎドキュメントを探します。チケットは thoughts/shared/handoffs/ENG-XXXX にあります。ここで ENG-XXXX はチケット番号です。例：ENG-2124 の引き継ぎドキュメントは thoughts/shared/handoffs/ENG-2124/ にあります。このディレクトリの内容を一覧表示してください。
   • ディレクトリ内のファイルは、0 個、1 個、または複数個の場合があります。
   • ディレクトリ内にファイルがない場合、またはディレクトリが存在しない場合：ユーザーに「申し訳ありません。引き継ぎドキュメントが見つからないようです。パスを指定していただけますか？」と伝えます。
   • ディレクトリ内にファイルが 1 個だけある場合：その引き継ぎドキュメントで作業を進めます
   • ディレクトリ内にファイルが複数ある場合：ファイル名に記載された日時（24 時間形式の YYYY-MM-DD_HH-MM-SS）を基準に、最も新しい引き継ぎドキュメントで作業を進めます。
   • 引き継ぎドキュメントを直ちに最後まで読みます
   • thoughts/shared/plans または thoughts/shared/research にある、リンク先の調査ドキュメントや計画ドキュメントも直ちに読みます。これらの重要なファイルを読むためにサブエージェントを使用しないでください。
   • 引き継ぎドキュメントから関連するコンテキストを取り込み、そこに記載されている追加ファイルを読んで、分析を開始します
   • その後、ユーザーに対応方針を提案して確認を求めるか、方針について質問します。

3. パラメーターが指定されていない場合は、次のように応答します。

I'll help you resume work from a handoff document. Let me find the available handoffs.

Which handoff would you like to resume from?

Tip: You can invoke this command directly with a handoff path: `/resume_handoff `thoughts/shared/handoffs/ENG-XXXX/YYYY-MM-DD_HH-MM-SS_ENG-XXXX_description.md`

or using a ticket number to resume from the most recent handoff for that ticket: `/resume_handoff ENG-XXXX`

その後、ユーザーの入力を待ちます。

作業手順

ステップ 1：引き継ぎドキュメントを読み、分析する

1. 引き継ぎドキュメントを最後まで読む：

   • 上限やオフセットのパラメーターを指定せずに Read ツールを使用します
   • 次のすべてのセクションを確認します。
     • タスクとそのステータス
     • 最近の変更
     • 学んだこと
     • 成果物
     • アクションアイテムと次のステップ
     • その他のメモ

2. 焦点を絞った調査タスクを開始する： 引き継ぎドキュメントの内容に基づいて、現状を確認するための調査タスクを並行して開始します。

   Task 1 - Gather artifact context:
   Read all artifacts mentioned in the handoff.
   1. Read feature documents listed in "Artifacts"
   2. Read implementation plans referenced
   3. Read any research documents mentioned
   4. Extract key requirements and decisions
   Use tools: Read
   Return: Summary of artifact contents and key decisions
   

3. すべてのサブタスクが完了するまで次に進みません

4. 重要なファイルを読む：

   • 「学んだこと」セクションに記載されているファイルを最後まで読みます
   • 「最近の変更」に記載されているファイルを読み、変更内容を把握します
   • 調査中に見つかった、関連する新しいファイルを読みます

ステップ 2：分析をまとめて提示する

1. 包括的な分析を提示する：

   I've analyzed the handoff from [date] by [researcher]. Here's the current situation:
   
   **Original Tasks:**
   - [Task 1]: [Status from handoff] → [Current verification]
   - [Task 2]: [Status from handoff] → [Current verification]
   
   **Key Learnings Validated:**
   - [Learning with file:line reference] - [Still valid/Changed]
   - [Pattern discovered] - [Still applicable/Modified]
   
   **Recent Changes Status:**
   - [Change 1] - [Verified present/Missing/Modified]
   - [Change 2] - [Verified present/Missing/Modified]
   
   **Artifacts Reviewed:**
   - [Document 1]: [Key takeaway]
   - [Document 2]: [Key takeaway]
   
   **Recommended Next Actions:**
   Based on the handoff's action items and current state:
   1. [Most logical next step based on handoff]
   2. [Second priority action]
   3. [Additional tasks discovered]
   
   **Potential Issues Identified:**
   - [Any conflicts or regressions found]
   - [Missing dependencies or broken code]
   
   Shall I proceed with [recommended action 1], or would you like to adjust the approach?
   

2. 先に進む前に確認を得ます

ステップ 3：アクションプランを作成する

1. TodoWrite を使用してタスクリストを作成する：

   • 引き継ぎドキュメントのアクションアイテムを Todo に変換します
   • 分析中に見つかった新しいタスクを追加します
   • 依存関係と引き継ぎ時の指針に基づいて優先順位を付けます

2. 計画を提示する：

   I've created a task list based on the handoff and current analysis:
   
   [Show todo list]
   
   Ready to begin with the first task: [task description]?
   

ステップ 4：専門エージェントに引き継ぐ

重要：直接実装してはいけません。必ず Task ツールを使ってエージェントを起動してください。

1. タスクの種類を分析し、専門エージェントを選択します：

   リード（ワーカーを起動できます）：

   エージェント	分野	用途
   kraken	実装	大規模な機能、新しいシステム、主要コンポーネント
   architect	計画	機能設計、システムアーキテクチャ、実装計画
   phoenix	計画	リファクタリング計画、移行、コードベースの再構成
   herald	デプロイ	リリース、デプロイ、公開
   maestro	オーケストレーション	複雑なマルチエージェントのワークフロー

   ワーカー（特定分野の専門家）：

   エージェント	分野	用途
   spark	実装	迅速な修正、パッチ、小規模な調整
   scribe	ドキュメント	ドキュメント、ガイド、解説
   sleuth	デバッグ	バグ調査、追跡、根本原因分析
   aegis	デバッグ	セキュリティ監査、脆弱性スキャン
   profiler	デバッグ	パフォーマンス最適化、ボトルネック分析
   arbiter	検証	ユニットテスト
   atlas	検証	E2E／統合テスト
   oracle	調査	外部ドキュメント、ベストプラクティス、手順
   scout	調査	コードベースの探索、既存コードの検索
   pathfinder	調査	リポジトリ構造の分析
   plan-reviewer	レビュー	機能計画のレビュー、設計の検証
   plan-reviewer	レビュー	移行のレビュー、リファクタリングの検証
   chronicler	セッション	セッション分析、履歴の要約

2. Task ツールで専門エージェントを起動します：

   Use Task tool with:
   - subagent_type: [selected agent from above]
   - prompt: [task description + relevant handoff context + learnings]
   

3. プロンプトに引き継ぎのコンテキストを含めます：

   • 引き継ぎから得られた主な知見
   • 行番号付きのファイル参照
   • 従うべきパターン
   • 避けるべき落とし穴

4. エージェントの完了を待ってから、次のタスクに進みます

ガイドライン

1. 徹底的に分析する：

   • 最初に引き継ぎドキュメント全体を読む
   • 言及されている変更がすべて残っていることを確認する
   • リグレッションや競合がないか確認する
   • 参照されている成果物をすべて読む

2. 対話的に進める：

   • 作業を始める前に調査結果を提示する
   • アプローチについて合意を得る
   • 方針を修正できるようにする
   • 現在の状態と引き継ぎ時の状態に応じて調整する

3. 引き継ぎで得た知見を活用する：

   • 「学んだこと」セクションに特に注意する
   • 記録されたパターンやアプローチを適用する
   • 言及されている失敗を繰り返さない
   • 発見された解決策を土台に進める

4. 継続性を維持する：

   • TodoWrite を使ってタスクの継続性を保つ
   • コミットで引き継ぎドキュメントを参照する
   • 元の計画から逸脱した点を記録する
   • 完了時に新しい引き継ぎを作成することを検討する

5. 実行前に検証する：

   • 引き継ぎ時の状態が現在も同じだと決めつけない
   • ファイル参照がすべて現存することを確認する
   • 引き継ぎ後に破壊的変更がないか確認する
   • パターンが現在も有効であることを確認する

よくあるシナリオ

シナリオ 1：問題なく継続できる

• 引き継ぎに記載された変更がすべて反映されている
• 競合やリグレッションがない
• アクションアイテムに次の手順が明確に記載されている
• 推奨されている作業を進める

シナリオ 2：コードベースに差異がある

• 一部の変更が欠落、または変更されている
• 引き継ぎ後に関連コードが追加されている
• 差異を調整する必要がある
• 現在の状態に合わせて計画を調整する

シナリオ 3：引き継いだ作業が未完了

• 引き継ぎでタスクが「進行中」とされている
• まず未完了の作業を終える必要がある
• 部分的な実装を改めて理解する必要がある場合がある
• 新しい作業に着手する前に完了を優先する

シナリオ 4：引き継ぎが古い

• かなりの時間が経過している
• 大規模なリファクタリングが行われている
• 元のアプローチが適用できない可能性がある
• 戦略を再評価する必要がある

対話フローの例

User: /resume_handoff specification/feature/handoffs/handoff-0.md
Assistant: Let me read and analyze that handoff document...

[Reads handoff completely]
[Spawns research tasks]
[Waits for completion]
[Reads identified files]

I've analyzed the handoff from [date]. Here's the current situation...

[Presents analysis]

Shall I proceed with implementing the webhook validation fix, or would you like to adjust the approach?

User: Yes, proceed with the webhook validation
Assistant: This is a bugfix task, so I'll route to the `spark` agent.

[Uses Task tool with subagent_type="spark" and prompt containing:
 - The webhook validation fix task
 - Key learnings from handoff
 - Relevant file:line references
 - Patterns to follow]

[Waits for spark agent to complete]

The spark agent has completed the webhook validation fix. Moving to the next task...