Communitygithub.com

VRIL-LABS/portable-agent-memory

🧠 高度にポータブルなエージェント用メモリシステム。あらゆるエージェントで利用可能で、コード品質を向上させます。補助的またはスタンドアロンのメモリシステムとして使用できます。

portable-agent-memory とは?

このスキルは、プロジェクトローカルな永続化レイヤーを提供するポータブルエージェントメモリシステムです。`<project_root>/memories/` ディレクトリにMarkdownファイルとしてメモリを保存し、`scripts/memory` コマンドで操作します。バージョン1.1.0以降では、SQLite + FTS5による全文検索インデックス `.memsys-db` も自動生成され、高速な検索が可能です。JSON形式の標準出力で状態を確認でき、`read` を再実行してディスク上の状態を確認することを推奨します。このシステムは、既存のメモリ機構と併用可能で、補助的なファイルベースレイヤーとして機能します。開発者は、提供される6つのリファレンスドキュメント(プロトコル、レイアウト、保存タイミング、憲法、DB契約、例)に従って、取り込み・検索・推論・反映・実行・パッケージ化のワークフローを構築できます。

対応✓Claude Code~Codex CLI✓Cursor✓Gemini CLI✓Windsurf
npx skills add VRIL-LABS/portable-agent-memory

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

メモリシステム

このスキルの永続化レイヤーは、プロジェクトローカルのメモリを <project_root>/memories/ に保存し、scripts/memory <cmd> 経由で操作します(references/memory_tool をバックエンドとして使用。これはこのレイヤーの決定論的な真実の源であり、その出力を変更したり再実装したりしないでください)。ホストに他のメモリ機構が存在しないことを前提とせず、もし存在する場合は、このシステムはそれに加えてファイルベースの追加レイヤーとして扱います。標準出力はJSON形式です。ディスク上の状態を確認するには read を再実行してください。

バージョン1.1.0以降では、init により隠しファイル <project_root>/.memsys-db(SQLite + FTS5、journal_mode=DELETE、単一ファイル、-wal/-shm なし)も作成されます。これは再生成可能なインデックス兼検索プレーンです。Markdownが真実の源であり続けます。

以下の順序で開始してください:

  1. references/protocol.md — 取り込み→検索→推論→反映→実行→パッケージ化の完全なワークフローと、コマンドおよびクイックスタートの起動方法。
  2. references/layout.md — ストアのレイアウトと、特定のクエリに対して何を読み込むべきか。
  3. references/when-to-save.md — 分類: スキル vs. インデックス vs. トピック vs. 拒否、およびスキルとメモリのルーティング。
  4. references/constitution.md — 厳格なルール(シークレットスキャンを決してスキップしない、200行を超えない、memories/ 以外に書き込まない、bashで列挙しない、台帳にWALを使用しない)。
  5. references/memsys-db.md — .memsys-db 台帳の契約: スキーマ、search/reindex/forget、およびDBがMarkdownより上位にならない理由。
  6. references/examples.md — 動作例: 正常パス、シークレット拒否、上書きからの復旧。

初回使用前に scripts/memory selftest でインストールを確認してください。

関連スキル