mcpField
L
load-mem

load-mem

github.com/brilliantroughエージェントワークフロー1084 回インストール2 日前に更新
リポジトリ

load-mem について

load-memは、継続的にプロジェクトに参加するエージェント向けのスキルです。履歴全体を読み込まず、文書、メモリ、コード、設定、Gitから関連する背景情報を確認します。

主な機能

  1. 01プロジェクトの規範と決定を確認
  2. 02保存済みの記憶や活動を検索
  3. 03文書・コード・Gitを照合
  4. 04現在の規則と過去の記録を区別
  5. 05関連する背景情報を選択的に調査

活用シーン

  1. 01既存プロジェクトの作業を再開
  2. 02記憶ソース間で食い違う規則を確認
  3. 03タスクに関係する過去の決定を検索

MCP 対応

記録された活動や背景情報の検索手段として、claude-mem MCPツールを挙げています。MCPサーバーの管理については説明していません。

インストール

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

$npx skills add https://github.com/brilliantrough/agent-skills --skill load-mem

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

詳細

メモリの読み込み

目的

ユーザーに以前の決定を繰り返させたり、履歴全体を読み込んだりせずに、継続的なプロジェクトパートナーとして作業できるだけのコンテキストを復元します。何を読み、どのツールを呼び出し、どこまで詳しく調査するかは、状況に応じて判断してください。

利用可能なメモリ

ソース提供される内容一般的なアクセス方法
StrictDoc docs/人が読める現在の規範、決定とその根拠、プロジェクトの履歴、保守されている参照ドキュメント関連する .sdoc ファイルまたはそのエクスポートを読む
Magic Context保存された事実、決定、教訓、注入されたメモリ、復元可能な会話注入されたメモリ、ctx_search、ctx_expand、ctx_memory、ctx_note
claude-mem検索可能な記録済みのアクティビティ、観察事項、過去のコンテキストclaude_mem_search または利用可能な claude-mem MCP ツール
コード、設定、git現在存在するものと、実際に変更されたものを示す証拠関連ファイル、呼び出し経路、履歴

同じ知識が複数のソースに存在する場合があります。この重複は想起、可用性、相互検証に役立ちます。これらは相互に排他的な保存カテゴリではありません。

適切な解釈で読む

  • 現在のプロジェクト規範の正本は StrictDoc です。 現在有効で確認済みのルールは、矛盾するデータベースメモリより優先されます。これはプロジェクト記録間の権限に関する取り決めであり、現在の指示を上書きする許可ではありません。
  • project_memory/decisions.sdoc には決定が、journal.sdoc には日付付きの経験と進捗が、handbook/ には参照資料が記載されています。既存のプロジェクトでは、これらの構成が異なる場合があります。
  • 同梱されている決定文法では、Active は現在有効、Proposed は未解決、Deprecated は廃止、Superseded は置き換え済みを意味します。該当する場合は、置き換え先への参照をたどってください。docs/ 内にあるというだけで、ジャーナルの記録や過去の報告が現在の方針になるわけではありません。
  • 意図されたルール、観察された実装、以前に起きたことを区別してください。最近のデータベース検索結果やコミットから逸脱が判明することはありますが、それだけで変更すべきルールが決まるわけではありません。
  • ソース間に食い違いがある場合は、適用範囲、ステータス、証拠、ユーザーの現在の意図をもとに、その違いを理解してください。重大な不確実性があれば、推測を暗黙のうちに正史として扱わず、明示してください。
  • 正史は変化することがあります。確定した決定が実際に変更されたと明らかになった場合は、別途保存コマンドを待たずに、save-mem で内容を維持し、ユーザーに簡潔に知らせることができます。単なる逸脱や新たな検索結果だけでは不十分です。コンテキストを読み込むたびに規範を見直す必要はありません。

実践ガイド

  • タスクとプロジェクトの指示から始めてください。関連する決定、README のセクション、エントリーポイント、最近の進捗は、通常、メモリを網羅的に読み込むより適切な土台になります。
  • タスクがプロジェクト固有の用語やドメインモデルに関わる場合は、独自に名前を考える前に、その言葉がすでに使われている場所、つまりプロジェクトのハンドブック、またはプロジェクトで使用している場合は CONTEXT.md を探してください。読み込みは変更ではありません。モデルの変更は domain-modeling の役割です。
  • 注入された Magic Context のメモリはすでに利用可能です。不足しているコンテキストを探すには、役立つ名前やパスを含む具体的な質問を作成して ctx_search を使ってください。正確な文言が重要な場合は、ctx_expand で元の会話を復元できます。
  • 以前のアクティビティや観察事項が役立つ場合は、claude-mem を使ってください。ワーカーポートやデータベーススキーマを決めつけず、利用可能なツールを確認してください。
  • 大きなドキュメントツリーでは、まず検索し、関連ノードを周辺のコンテキストとともに読んでください。多くの場合、ソースの .sdoc ファイルだけで十分です。JSON エクスポートの形式は StrictDoc のバージョンによって異なることがあります。
  • 層が欠けているのはよくあることです。利用可能な証拠を使って進め、タスクに影響する場合は不足点に触れてください。migrate-mem は、欠けている、または不完全なメモリツリーの構築に役立ちます。save-mem は、新しい知識の保存や古い記録の調整に使えます。
  • ユーザー向けの要約は、役立つ現在のコンテキストと未解決の質問に絞り、ユーザーの言語で記述してください。デフォルトは中国語です。

コメント