mcpField
H
handoff

handoff

github.com/rohitg00エージェントワークフロー30.0k13.6k 回インストール1 日前に更新
リポジトリ

handoff について

プロジェクトに一致する最新のセッションと記録から作業を再開するスキルです。未解決の質問や決定、次の手順を把握し、別プロジェクトの履歴を誤って使わないようにします。

主な機能

  1. 01プロジェクトのディレクトリでセッションを照合
  2. 02必要に応じてエージェントで絞り込み
  3. 03未回答の質問を優先して提示
  4. 04ファイル、決定事項、エラーを要約

活用シーン

  1. 01現在のプロジェクトで作業を再開
  2. 02以前のセッションから次の手順を確認

MCP 対応

ワークフローでは `memory_sessions` でプロジェクトのセッションを探し、`memory_recall` で観察内容を取得します。

インストール

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

$npx skills add https://github.com/rohitg00/agentmemory --skill handoff

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

同梱ファイルEXAMPLES.mdTROUBLESHOOTING.md

詳細

ユーザーは作業の再開を希望しています。任意の cwd 上書き:$ARGUMENTS

クイックスタート

memory_sessions { "project": "<current-project-id>", "limit": 20 }

cwd がこのプロジェクトと一致する最新のセッションを選び、次を実行します: memory_recall { "query": "<session top concepts>", "project": "<current-project-id>", "limit": 10 }。 エージェントが指定されている場合は、両方の呼び出しに同じ agentId を渡します。

期待される出力:

Resuming 7f3a9c2 "Auth refresh rework".
Open question: should logout revoke all device tokens or just the current one?
Next step: decide revoke scope, then update auth/logout.ts.

理由

生のプレフィックスではなくディレクトリ境界でセッションを照合し、隣接するリポジトリをこのプロジェクトと誤認しないようにします。空のセッションについて、観察内容を決して捏造しないでください。

ワークフロー

  1. プロジェクトのパスを解決します:$ARGUMENTS が指定されている場合は絶対パスに正規化します(path.resolve(process.cwd(), $ARGUMENTS))。それ以外の場合は cwd を使用します。
  2. 既知の場合は正確なプロジェクト識別子を指定して memory_sessions を呼び出し、エージェントが指定されている場合は agentId も指定します。それ以外の場合は、一致するディレクトリが見つかるかページネーションが終了するまで nextCursor に従います。ページ間でフィルターを保持します。正規化された cwd がディレクトリ境界に基づいて一致する、最新のセッションを選びます:cwd の一致、または cwd.startsWith(projectPath + sep)、または projectPath.startsWith(cwd + sep)。abandoned より completed を優先します。 一致するものがない場合:このプロジェクトに一致するセッションがないことを報告して終了します。別のプロジェクトのセッションで代用しないでください。
  3. セッションが未回答のユーザー向け質問で終了している場合は、最初にその質問を提示します。summary、または narrative が ? で終わる最近の conversation の観察内容を確認します。
  4. タイトル/概要、主要なファイル、重要な決定事項またはエラーを要約します。主要な概念について memory_recall を limit 10 で使用し、選択したプロジェクトとエージェントのスコープを維持します。結果に含まれる各項目のセッションまたはプロジェクトの出所を確認してから記載してください。クエリだけではスコープは適用されません。
  5. 具体的な「次のステップ」を1つ示して締めくくります。

アンチパターン

誤り:session.cwd.startsWith(projectPath) は、プロジェクトが /repo-a のときに /repo-a-staging にも一致し、誤ったリポジトリのセッションを再開してしまいます。

正しい方法:session.cwd === projectPath || session.cwd.startsWith(projectPath + sep)。隣接するリポジトリをまたがないディレクトリ境界チェックです。

チェックリスト

  • cwd の上書き値が絶対パスに正規化されている。
  • 生のプレフィックスではなく、ディレクトリ境界チェックで照合している。
  • 未回答の質問がある場合は、それを先に提示している。
  • 空のセッションについて明確に報告し、最初から始めることを提案している。

関連項目

  • recap、session-history、recall:同じセッションデータを、より広い視点から確認できます。

トラブルシューティング

memory_sessions または memory_recall が利用できない場合は、TROUBLESHOOTING.md を参照してください。

コメント