mcpField
H
handoffs

handoffs

github.com/jellydnエージェントワークフロー12551 回インストール3 日前に更新
リポジトリ

handoffs について

handoffs は、別のエージェントが開発作業を続けられるよう、セッションの詳細な引き継ぎ計画を作るスキルです。意図、技術的背景、ファイル、現在の状態、阻害要因、次の作業を構造化して Markdown ファイルに記録します。

主な機能

  1. 01引き継ぎ目的の明示を要求
  2. 02決定事項と作業状況を要約
  3. 03関連ファイル、コード、阻害要因を記録
  4. 04直接関連する次の作業を特定
  5. 05日付付き引き継ぎファイルを作成して検証

活用シーン

  1. 01進行中の開発を別のエージェントに引き継ぐ
  2. 02セッション終了前に作業背景を保存
  3. 03阻害要因と依頼された次の作業を記録

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jellydn/my-ai-tools --skill handoffs

インストール後、Claude Code で/handoffsを入力して読み込まれたか確認します。

詳細

セッション引き継ぎ計画

新しいセッションで作業を続けられるよう、会話の詳細な引き継ぎ計画を作成します。

ユーザーが指定した目的：

$ARGUMENTS

別のエージェントが作業を引き継げるよう、会話の要約を作成します。この作業を行うには、目的が必須です。<purpose>...</purpose>タグ内に目的が指定されていない場合は、ただちに作業を中止し、ユーザーに目的を尋ねてください。

目的を尋ねる前に作業を続けてはいけません。指示を理解できず、目的を推測してしまうためです。

目標

これまでの会話を詳細に要約し、次のステップに関するユーザーの明示的な目的に特に注意を払います。 この引き継ぎ計画では、技術的な詳細、コードのパターン、アーキテクチャ上の決定事項を十分に記録し、開発作業の継続に必要なコンテキストが失われないようにします。

プロセス

最終的な引き継ぎを提示する前に、根拠に基づいた簡潔な要約をユーザーに提示します。非公開の思考過程や<analysis>タグは明かさないでください。時系列の記録やコード全文ではなく、決定事項、現在の状態、阻害要因、次に実行する具体的なアクションを含めてください。

  1. ユーザーが明示した目的と、現在の作業状況を特定します。
  2. 重要なパス、ブランチ／ステータス、直近のコマンド結果、未解決の阻害要因を確認します。
  3. 意思決定に関係するファイル名、シンボル、短いコード片、リンクだけを記録します。
  4. 不確かな情報や古くなっている可能性のある情報には、その旨を明記します。

計画には、次のセクションを含めてください。

  1. 主な依頼と意図：ユーザーの明示的な依頼と意図をすべて詳しく記録します
  2. 主要な技術概念：話題に上がった重要な技術概念、テクノロジー、フレームワークを列挙します
  3. ファイルとコード箇所：確認、変更、作成した具体的なファイルとコード箇所を列挙します。特に直近のメッセージに注意し、該当する場合はコード全文を含め、このファイルの読み取りや編集が重要な理由を要約します
  4. 問題解決：解決した問題と、現在進行中のトラブルシューティングを記録します
  5. 保留中のタスク：明示的に依頼された未完了のタスクをまとめます
  6. 現在の作業：引き継ぎ依頼の直前に取り組んでいた内容を正確に詳しく説明します。特に、ユーザーとアシスタントの直近のメッセージに注意します。該当する場合はファイル名とコード片を含めます
  7. 次のステップ：直近の作業に関連して、次に行うステップを記載します。重要：このステップは、ユーザーの明示的な依頼と引き継ぎ依頼の直前に取り組んでいたタスクに直接沿ったものにしてください。最後のタスクが完了している場合は、ユーザーの依頼に明示的に沿う次のステップのみを記載します。ユーザーに確認せず、無関係な依頼に取りかからないでください。実行可能な次のステップがある場合にのみ、このセクションを含めます。

さらに、この引き継ぎの「スラッグ」も作成してください。スラッグとは、後から参照するために使う名前です。例：

  • current-user-api-handler
  • implement-auth
  • fix-issue-42

スラッグとあわせて「読みやすい要約」も作成してください。例：

  • 現在のユーザー向けAPIハンドラーを実装する
  • 認証を実装する
  • Issue #42を修正する

出力形式

引き継ぎファイルには、以下の構成に従って要約を記載してください。非公開の思考過程や時系列の記録は含めないでください。

# Session Handoff Plan

## 1. Primary Request and Intent

[Detailed description of all user requests and intents]

## 2. Key Technical Concepts

- [Concept 1]
- [Concept 2]
- [...]

## 3. Files and Code Sections

### [File Name 1]

- **Why important**: [Summary of why this file is important]
- **Changes made**: [Summary of the changes made to this file, if any]
- **Code snippet**:

\`\`\`language
[Important Code Snippet]
\`\`\`

### [File Name 2]

- **Code snippet**:

\`\`\`language
[Important Code Snippet]
\`\`\`

[...]

## 4. Problem Solving

[Description of solved problems and ongoing troubleshooting]

## 5. Pending Tasks

- [Task 1 that you have been explicitly asked to work on]
- [Task 2 that you have been explicitly asked to work on]
- [...]

## 6. Current Work

[Detailed description of what was being worked on immediately before this handoff, including file names and code snippets]

## 7. Next Step

[Next step to take, directly aligned with user's explicit handoff purpose. Only include if there is an actionable next step.]

最終ステップ

分析と要約を提示した後、次の手順を実行します。

  1. .planning/handoffs/ ディレクトリが存在することを確認します（必要に応じて作成します）。
  2. 引き継ぎ要約を .planning/handoffs/[timestamp]-[slug].md という Markdown ファイルに書き込みます。[timestamp] は現在の日付（YYYY-MM-DD 形式）、[slug] は事前に定義したものです。
  3. 引き継ぎファイルを読み返し、目的、現在の状態、検証結果、ブロッカー、次のアクションが含まれていることを確認します。
  4. このファイルについてユーザーに伝え、ファイル名を指定して /pickup $1 を使えば、$1 の続きから再開できることを案内します。

コメント

Markdown 対応