mcpField
P
para-memory-files

para-memory-files

github.com/paperclipaiエージェントワークフロー108.3k1.8k 回インストール今日更新
リポジトリ

para-memory-files について

Agent向けのファイルベースの永続メモリスキルです。PARAでエンティティ、日次メモ、ユーザーの傾向を整理し、qmdでメモリや計画を検索します。

主な機能

  1. 01PARA形式のエンティティ知識グラフ
  2. 02日々の出来事の記録
  3. 03ユーザーの傾向と学びの記録
  4. 04qmdによる意味・キーワード検索
  5. 05事実の更新とアーカイブ規則

活用シーン

  1. 01セッションをまたいだ事実の保存
  2. 02過去の出来事に関する記録の検索
  3. 03プロジェクトと責任事項の整理
  4. 04検索可能なプロジェクト計画の管理

インストール

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

$npx skills add https://github.com/paperclipai/paperclip --skill para-memory-files

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

同梱ファイルreferences/schemas.md

詳細

PARA メモリファイル

Tiago Forte の PARA メソッドで整理された、ファイルベースの永続メモリです。ナレッジグラフ、日次メモ、暗黙知の 3 層で構成されます。すべてのパスは $AGENT_HOME を基準とします。

3 つのメモリ層

層 1：ナレッジグラフ（$AGENT_HOME/life/ -- PARA）

エンティティベースの保存領域です。各エンティティには、次の 2 階層のフォルダーを割り当てます。

  1. summary.md -- まず読み込む、簡潔なコンテキストです。
  2. items.yaml -- 必要に応じて読み込む、個別の事実です。
$AGENT_HOME/life/
  projects/          # Active work with clear goals/deadlines
    <name>/
      summary.md
      items.yaml
  areas/             # Ongoing responsibilities, no end date
    people/<name>/
    companies/<name>/
  resources/         # Reference material, topics of interest
    <topic>/
  archives/          # Inactive items from the other three
  index.md

PARA のルール：

  • Projects -- 目標や期限のある進行中の作業です。完了したらアーカイブに移動します。
  • Areas -- 継続中の事柄（人、会社、責任など）です。終了日はありません。
  • Resources -- 参考資料や関心のあるトピックです。
  • Archives -- どのカテゴリーからも、活動していない項目を保存します。

事実のルール：

  • 長期的に有用な事実は、すぐに items.yaml に保存します。
  • 週次で、アクティブな事実から summary.md を書き直します。
  • 事実は削除しないでください。代わりに置き換えとして扱います（status: superseded を設定し、superseded_by を追加します）。
  • エンティティが非アクティブになったら、そのフォルダーを $AGENT_HOME/life/archives/ に移動します。

エンティティを作成するタイミング：

  • 3 回以上言及された場合、または
  • ユーザーと直接的な関係がある場合（家族、同僚、パートナー、クライアント）、または
  • ユーザーの生活において重要なプロジェクトや会社である場合。
  • それ以外の場合は、日次メモに記録します。

個別の事実に使う YAML スキーマとメモリの減衰ルールについては、references/schemas.md を参照してください。

層 2：日次メモ（$AGENT_HOME/memory/YYYY-MM-DD.md）

イベントの生の時系列記録、つまり「いつ」の層です。

  • 会話中に継続して書き込みます。
  • ハートビート中に、長期的に有用な事実を層 1 に抽出します。
層 3：暗黙知（$AGENT_HOME/MEMORY.md）

ユーザーの行動の仕方、つまりパターン、好み、学んだ教訓です。

  • 世界に関する事実ではなく、ユーザーに関する事実を記録します。
  • 新しい行動パターンを学んだら、更新します。

書き留めてください -- 頭の中だけに残さない

メモリはセッションを再起動すると保持されません。ファイルは保持されます。

  • 何かを覚えておきたい場合 → ファイルに書き込みます。
  • 「これを覚えておいて」→ $AGENT_HOME/memory/YYYY-MM-DD.md または該当するエンティティファイルを更新します。
  • 教訓を学んだ場合 → AGENTS.md、TOOLS.md、または該当するスキルファイルを更新します。
  • 間違いをした場合 → 将来の自分が繰り返さないように記録します。
  • ディスク上のテキストファイルは、一時的なコンテキストに保持するより常に優れています。

メモリの検索 -- qmd を使用する

ファイルを grep する代わりに、qmd を使用します。

qmd query "what happened at Christmas"   # Semantic search with reranking
qmd search "specific phrase"              # BM25 keyword search
qmd vsearch "conceptual question"         # Pure vector similarity

個人用フォルダーをインデックス化します：qmd index $AGENT_HOME

ベクトル検索、BM25、再ランキングを組み合わせることで、表現が異なっていても情報を見つけられます。

計画

計画は、個人用メモリの外にあるプロジェクトルートの plans/ に、タイムスタンプ付きファイルとして保存します（他のエージェントからもアクセスできるようにするためです）。qmd を使って計画を検索します。計画は古くなります。新しい計画がある場合は、古いバージョンと取り違えないでください。古くなっていることに気付いたら、そのファイルを更新し、何に置き換えられたかを supersededBy に記録します。

コメント

Markdown 対応