mcpField
R
remembering-conversations

remembering-conversations

github.com/obraエージェントワークフロー4939.2k 回インストール7 週間前に更新
リポジトリ

remembering-conversations について

Claude Code、Codex、opencode向けの会話履歴検索ワークフローです。過去の情報に頼る前に履歴を検索し、関連する記録を読んで要点をまとめるよう促します。

主な機能

  1. 01話題別の過去会話検索
  2. 02関連記録の読解と要約
  3. 03元の会話への参照提示
  4. 04決定、解決策、注意点の確認

活用シーン

  1. 01以前に話し合った設計上の決定を探す
  2. 02過去のデバッグ手法を再利用
  3. 03プロジェクトの背景や既定の手順を確認

MCP 対応

検索サブエージェントが使えない場合、episodic-memory MCP ツールで過去の会話を検索・閲覧します。取得する文脈を絞る手順も示します。

インストール

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

$npx skills add https://github.com/obra/episodic-memory --skill remembering-conversations

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

同梱ファイルMCP-TOOLS.md

詳細

会話を記憶する

基本原則： ゼロから作り直す前に検索しましょう。検索にコストはかかりませんが、作り直したり、同じ間違いを繰り返したりすると、すべてを失います。

必須：過去の記憶を検索する

過去の検索に関する依頼では、必ず過去の記憶を検索してください。

「[トピック]について過去の会話を検索しています」と伝えます。

Claude Code

subagent_type: "search-conversations" を指定して Task ツールを使用します。

Task tool:
  description: "Search past conversations for [topic]"
  prompt: "Search for [specific query or topic]. Focus on [what you're looking for - e.g., decisions, patterns, gotchas, code examples]."
  subagent_type: "search-conversations"
Codex

search-conversations エージェントが利用可能な場合は、同じプロンプトを使って実行します。利用できない場合は、MCP ツールを直接使用します。

  1. episodic-memory の search ツールで検索します
  2. 上位 2～5 件の結果を episodic-memory の read ツールで読み取ります
  3. 調査結果を回答にまとめます
  4. ユーザーが元の会話を確認できるよう、出典への参照を含めます

検索ワークフローでは、次の処理を行います。

  1. search ツールで検索します
  2. 上位 2～5 件の結果を read ツールで読み取ります
  3. 調査結果をまとめます（200～1000 語）
  4. 実行可能な知見と出典を返します

生の会話を読み込む場合と比べて、コンテキストを 50～100 倍節約できます。

opencode

ローカルの検索エージェントが利用可能な場合を除き、MCP ツールを直接使用します。

  1. episodic-memory の search ツールで検索します
  2. 上位 2～5 件の結果を episodic-memory の read ツールで読み取ります
  3. 調査結果を回答にまとめます
  4. ユーザーが元の会話を確認できるよう、出典への参照を含めます

使用する場面

ユーザーから明示的に依頼されていなくても、以前に得た情報が現在のタスクに役立つ可能性がある場合は、いつでも使用してください。

過去の経験が役立つ可能性がある場合：

  • 以前の作業で決めたこと、その理由、パターン、解決策、落とし穴、プロジェクトの背景を思い出す必要がある場合
  • 以前に解決、デバッグ、レビュー、リリース、計画したことがある作業と似ている場合
  • 以前に注意点や確立された手順がある可能性のあるワークフローやプロセスを繰り返す必要がある場合

行き詰まった場合：

  • 問題を調査しても解決策が見つからない場合
  • 現在のコードに明らかな解決策がない複雑な問題に直面している場合
  • 不慣れなワークフローやプロセスに従う必要がある場合

過去のやり取りを示す表現がある場合：

  • ユーザーが「前回」「以前」「話し合った」「実装した」と言う
  • ユーザーが「なぜ～したのか」「理由は何だったか」と尋ねる
  • ユーザーが「覚えているか」「何が分かっているか」と尋ねる

不確かなまま回答する前に：

  • 過去の会話で得た可能性のある情報について、記憶を頼りに推測したり「分かりません」と答えたりする前に、現在の会話ですでに答えが得られている場合を除き、記憶を検索してください

最初に検索しない場合：

  • 現在のコードベースの構造を調べる場合（まず Grep/Read を使って調査します）
  • 現在の会話にある情報を調べる場合
  • 依頼の内容を理解する前

MCP ツールへの直接アクセス

検索エージェントが利用できない場合、または現在のハーネスがエージェントの実行に対応していない場合は、次のツールを直接使用してください。

  • mcp__plugin_episodic-memory_episodic-memory__search
  • mcp__plugin_episodic-memory_episodic-memory__read

MCP ツールを直接使用する場合は、まず検索し、関連性の高い上位 2～5 件の会話または行範囲だけを読み取って、コンテキストを小さく保ってください。

高度な使用方法については、完全な API リファレンスが必要に応じて MCP-TOOLS.md にあります。

コメント

Markdown 対応