recall について
recallは、保存済みメモリや活動記録から過去のコンテキストを探すエージェントスキルです。ユーザーのクエリで検索し、選択した結果の詳細を展開できます。メモリツールが返した情報のみを報告します。
主な機能
- 01クエリでメモリを検索
- 02プロジェクトやエージェントで絞り込み
- 03選択した結果の詳細を展開
- 04メモリまたは観察記録を検索
- 05ツールが返した情報のみ報告
活用シーン
- 01以前保存した技術上の決定を検索
- 02特定プロジェクトのコンテキストを取得
- 03過去のセッションで記録された活動を確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ rohitg00/ agentmemory --skill recallインストール後、Claude Code で/recallを入力して読み込まれたか確認します。
同梱ファイルEXAMPLES.mdTROUBLESHOOTING.md
詳細
ユーザーは次の内容について、過去のコンテキストを思い出したいと考えています:$ARGUMENTS
クイックスタート
memory_smart_search { "query": "jwt refresh token rotation", "limit": 10 }
期待される出力:
2 results across 2 sessions.
[importance 8] decision · "Rotate refresh tokens on every use" (session 7f3a9c21)
[importance 5] code · "limit.ts counts per-IP" (session b21d004e)
理由
ツールが返した内容だけを提示してください。観察内容、セッション ID、重要度スコアを捏造してはいけません。何も返ってこなかった場合は、その旨を伝えてください。
ワークフロー
- ユーザーのテキストを
queryとして、limit: 10を指定し、memory_smart_searchを呼び出します。ユーザーが特定のリポジトリを指定した場合はprojectを、特定のエージェントの履歴を求めている場合はagentIdを渡します。 明示的に保存された知識を検索する場合はtargetLayer: "memory"を、記録されたアクティビティを検索する場合はtargetLayer: "observation"を使用します。両方を検索する場合は省略します。 - 検索結果は簡潔です。内容を引用したり、出所を説明したりする前に、選択した ID をカンマ区切りの
expandIds文字列として指定し、同じプロジェクト、エージェント、レイヤーのフィルターを使ってmemory_smart_searchを呼び出します。展開に失敗した場合、またはレコードが利用できなくなっている場合は、その制限を報告してください。タイトルだけでは、事実の全容は分かりません。 - 展開した観察内容をセッションごとにまとめ、返されたタイプ、タイトル、説明を示します。出所は、レスポンスに含まれている場合にのみ記載します。
- 重要度の高い観察内容(重要度 >= 7)から提示します。
memory_recallを使う場合、空または短縮されたレスポンスを知識が存在しないとみなす前に、matched_count、excluded_by_budget、content_truncatedを確認します。内容全体を取得するには、同じプロジェクト、エージェント、レイヤーのフィルターを使い、expandIdsを指定してmemory_smart_searchを呼び出します。minimum_budgetは、予算が少なすぎる場合に、最小限のプレビューに必要と推定される予算を示します。- 一致する結果がない場合は、代わりに試せる検索語を2~3個提案して終了します。推測してはいけません。
アンチパターン
誤り:結果が空なので、「先週、トークンの有効期限について話したはずです」と思い込みで書く。
正しい例:「このクエリに一致するメモリはありませんでした。refresh token、session expiry、auth rotation を試してください。」
チェックリスト
- 表示したすべての観察内容は、ツールのレスポンスに含まれていました。
- 結果はセッションごとにまとめ、重要度の高い順に並べています。
- 結果が空の場合は、内容を捏造せず、代わりの検索語を提案しています。
- セッション ID やスコアを言い換えたり、丸めたりしていません。
関連項目
remember:書き込み側の機能です。呼び出しでは、保存した内容を取得します。recap、handoff、session-history:同じデータをセッション単位で表示します。memory-discipline:促されていない場合に、この検索を実行するタイミングについて説明します。
トラブルシューティング
memory_smart_search を利用できない場合は、TROUBLESHOOTING.md を参照してください。
コメント
Markdown 対応