mcpField
R
recap

recap

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

recap について

recap は、指定期間のプロジェクトセッションを返されたメモリーデータからまとめるエージェントスキルです。日付ごとに分類し、セッションの詳細、確認済みの要点、合計を示します。

主な機能

  1. 01指定期間の解析
  2. 02プロジェクトとエージェントによる絞り込み
  3. 03日付ごとのセッション分類
  4. 04確認済み要点と合計の表示

活用シーン

  1. 01プロジェクトの直近1週間を振り返る
  2. 02指定期間のセッションを確認
  3. 03セッションの要点と件数を要約

インストール

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

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

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

同梱ファイルEXAMPLES.mdTROUBLESHOOTING.md

詳細

ユーザーは要約を求めています。対象期間の引数:$ARGUMENTS

クイックスタート

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

その後、該当する各セッションについて、memory_recall { "query": "<top concepts>", "project": "<current-project-id>", "limit": 3 } を実行します。 エージェントが指定された場合は、両方の呼び出しに同じ agentId を渡します。

出力例:

2026-06-07
  7f3a9c2 · "Auth refresh rework" · 14 obs · completed
    - [8] Rotate refresh tokens on every use
3 sessions across 2 days, 41 observations.

理由

ツールが返したセッションと観察事項だけを要約します。対象期間に何もない場合も、それ自体が正しい回答であり、活動を創作するよう促すものではありません。

ワークフロー

  1. $ARGUMENTS を解析します:today = 現在のローカル日付、this week = 過去 7 日間、last <n> または数字のみ = 直近 N 件、空欄 = last 10。
  2. 既知の場合は正確に記録されたプロジェクト識別子と、指定された agentId を使って memory_sessions を呼び出します。対象期間がカバーされるか、ページがなくなるまで、同じフィルターで nextCursor をたどります。プロジェクト識別子が不明な場合は、期間や件数で絞り込む前に、全ページを対象としてディレクトリ境界に基づき正規化した cwd を照合します。startedAt の降順に並べ替えます。
  3. 該当するセッションをローカルの暦日(YYYY-MM-DD)ごとにグループ化します。
  4. セッションごとに、ID(先頭 8 文字)、タイトルまたは最初のプロンプト、観察事項の件数、ステータスを一覧表示します。memory_recall からハイライトを取得し、プロジェクトとエージェントのスコープを維持したうえで、結果がそれぞれのセッションに属することを確認してから含めます。
  5. 最後に「N セッション、M 日間、K 件の観察事項。」と記載します。

アンチパターン

誤り:対象期間が空なので、会話の記憶から「認証作業がはかどった一週間」と要約する。

正しい例:「このプロジェクトでは、過去 7 日間にセッションはありません。」

チェックリスト

  • 引数から対象期間を正しく解析した。
  • セッションを現在のプロジェクトの cwd で絞り込んだ。
  • ハイライトは言い換えではなく、memory_recall から取得した。
  • 合計行は、実際に表示した件数を反映している。

関連項目

  • handoff、session-history、recall:同じセッションデータを異なる観点から扱います。

トラブルシューティング

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

コメント