mcpField
S
session-history

session-history

github.com/rohitg00エージェントワークフロー30.0k14.0k 回インストール今日更新
リポジトリ

session-history について

session-history は、返されたメモリーデータを使ってプロジェクトの最近のセッションを提示するエージェントスキルです。プロジェクト範囲の厳密な指定、時系列順、履歴を捏造しないことを重視します。

主な機能

  1. 01プロジェクト別の最近のセッション一覧
  2. 02プロジェクトとエージェントによる絞り込み
  3. 03観察記録と要約の表示
  4. 04開始時刻順の並べ替え

活用シーン

  1. 01プロジェクトの最近の作業を確認
  2. 02セッションの観察記録を要約
  3. 03特定プロジェクトの履歴を確認

インストール

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

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

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

同梱ファイルEXAMPLES.mdTROUBLESHOOTING.md

詳細

ユーザーは、このプロジェクトの最近のセッションの概要を求めています。

クイックスタート

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

期待される出力:

7f3a9c2 · app · 2026-06-07 09:00 · completed · 14 obs
  - decision: Rotate refresh tokens on every use
b21d004 · app · 2026-06-05 14:00 · completed · 9 obs
  - code: limit.ts counts per-IP

理由

ツールが返したセッションと観察事項のみを表示します。履歴が空であることも正当な回答であり、過去の作業を作り出す理由にはなりません。

ワークフロー

  1. ホストに記録された正確なプロジェクト識別子を使用し、要求された場合はagentIdを付けてmemory_sessionsに渡します。不明な場合は、nextCursorを使ってセッションをページ単位で取得し、ディレクトリ境界を基準に正規化したcwdと照合してから、最新の20件を選びます。別のプロジェクトで代用してはいけません。
  2. すべてのページでスコープフィルターを維持し、要求された件数に達するか、nextCursorがnullになるまで続けます。表示している履歴が一部のページである場合は、その旨を明記します。新しい順に、セッションID(先頭8文字)、プロジェクト、開始時刻、ステータスを表示します。
  3. 観察事項があるセッションについては、主なハイライト(種類とタイトル)を表示します。
  4. セッションごとの観察事項の合計数を記載します。
  5. セッションの要約がある場合は、そのタイトルと主な決定事項を示します。

アンチパターン

誤り:ツールが2件のセッションを返したのに、「着実に進展した複数のセッション」と説明し、会話から覚えているセッションを追加する。

正しい例:返された2件のセッションだけを、それぞれ実際のID、ステータス、観察事項の件数とともに表示する。

チェックリスト

  • 表示したすべてのセッションがツールの応答に含まれている。
  • 表示する範囲を選ぶ前に、プロジェクト/ディレクトリのスコープを確認した。
  • 新しい順に並んでいる。
  • セッションごとの観察事項の件数が応答と一致している。
  • セッションやハイライトを作り出したり、統合したりしていない。

関連項目

  • recap:同じデータを日付ごとにまとめ、ハイライトを表示します。
  • handoff:直近のセッションに直接移動します。
  • recall:すべてのセッションをトピックで検索します。

トラブルシューティング

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

コメント