agent-memory-systems について
複数のテナントやユーザーを扱うエージェントのメモリ設計とトラブル調査に使うスキルです。本人確認、検索範囲の制限、元記録の保持、拡張前の分離テストを重視します。
主な機能
- 01意味・エピソード・手続き記録の分類
- 02本人確認に基づく名前空間と保持期間の設計
- 03証拠・バージョン・競合ルールの設定
- 04分離・検索・書き込み失敗のテスト
- 05保留質問による検索評価
活用シーン
- 01複数テナント向けエージェントのメモリ設計
- 02古い記録や競合する検索結果の調査
- 03元データを保ったストレージ移行の計画
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ sickn33/ agentic-awesome-skills --skill agent-memory-systemsインストール後、Claude Code で/agent-memory-systemsを入力して読み込まれたか確認します。
同梱ファイルreferences/detailed-guide.md
詳細
エージェントメモリーシステム
事実や好みには意味記録、出来事にはエピソード記録、再利用可能な手法には手続き記録を選択します。検索品質と保存量は分けて考え、永続的なアクセスは検証済みの ID に紐付けます。
手順
- 実際のタスク、認証済みのテナント/ユーザー、コンテンツを保持する権限、保持期間の制限、既存のストア/モデルのバージョンを確認します。
- ガイドのテナントスコープの契約と、関連するストレージ/チャンク化のセクションを読みます。インストール済み SDK がサポートするアダプターを選択します。ガイドに記載された過去の構成例は、デプロイ可能なインテグレーションではありません。
- レコード ID、根拠となるソース、タイムスタンプ、名前空間、検索上限、競合/バージョン管理ポリシーを指定します。元データを保持し、削除せずに統合を提案します。
- 分離されたフィクスチャを使用して、別 ID によるアクセスの拒否、古い/競合するレコード、検索上限、書き込み失敗をテストします。保存量を増やす前に、保留した質問を使って検索をベンチマークします。
- アーキテクチャと、根拠に基づいた変更計画を提示し、未解決のアダプターとホスト先のコスト/データ保存先を列挙します。実際に許可されている永続化またはプロバイダー操作のみを実行します。
詳細ガイド
このスキルを実行する前に、詳細ガイドを読んでください。完全な手順と参考資料が記載されています。安全要件、前提条件、検証要件は必須として扱ってください。対象を絞った作業では関連するセクションを読み、最初から最後まで作業する場合はガイドをすべて読んでください。
使用する場面
- 異なるテナントまたはユーザーに対応するエージェント向けに、メモリーの名前空間と保持期間を設計する場合。
- 古い、競合する、またはアクセス権のない会話レコードが検索される問題を診断する場合。
- ソースレコードを保持して分離を検証しながら、埋め込み/ストアの移行を計画する場合。
例
依頼:「サポートエージェントがセッション間で好みを忘れてしまいます。履歴を共有しないように、2 つの顧客テナント向けのメモリーを設計してください。」
**出力:**テナントスコープの契約とバックグラウンド抽出のセクションを読み込みます。検証済みのテナント/ユーザーごとに意味名前空間を設け、ソース ID と改訂を含むレコード、および上限付きの検索を提案します。所有者が解決するまで、競合する好みは保持します。テナント B がテナント A のレコードを検索または統合できないことを確認するテストも含めます。書き込みを行う前に、既存の永続化アダプターと、同意/保持期間の根拠を特定します。
制限事項
- タスクが上記の範囲に明確に該当する場合にのみ、このスキルを使用してください。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認を求めてください。
コメント
Markdown 対応