claude-historian について
Claude Historianは、Claudeエージェントが過去の会話履歴を検索するためのスキルです。調査や作業の再開前に、エラー、ファイル、計画、セッション、ツールなどを対象に検索し、特定のセッションも確認できます。
主な機能
- 01話題や範囲を指定して会話を検索
- 02過去のエラー修正を検索
- 03ファイルやプロジェクトの履歴を確認
- 04計画、セッション、ツールのワークフローを検索
- 05特定セッションの詳細を確認
活用シーン
- 01Web検索の前に既存の解決策を確認
- 02繰り返し発生するエラーの修正方法を検索
- 03プロジェクトでの過去の判断を振り返る
- 04ファイルに関連する変更履歴を探す
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ vvkmnn/ claude-historian-mcp --skill claude-historianインストール後、Claude Code で/claude-historianを入力して読み込まれたか確認します。
詳細
Claude Historian
新たに始める前に、会話履歴を検索しましょう。すでに答えが見つかっているかもしれません。
使用するタイミング
WebSearch の前 → search(query: "...", scope: "similar") または search(query: "...", scope: "conversations") を使用します。過去の解決策は Web 検索結果より役立ちます。
エラーで行き詰まったとき → search(query: "<error message>", scope: "errors") を使用します。コード付きの過去の修正方法が見つかります。
使い慣れたプロジェクトに取り組むとき → 最近の作業は search(scope: "sessions") で検索します。過去の決定事項は search(query: "...", scope: "plans") で検索します。
使い慣れたファイルに取り組むとき → search(scope: "files", filepath: "src/index.ts") を使用します。過去の変更をコンテキストとともに確認できます。
クイックリファレンス
| 状況 | ツール呼び出し |
|---|---|
| 原因が明らかでないエラー | search(query: "<error>", scope: "errors") |
| 「以前にこれをやったことがあるか?」 | search(query: "...", scope: "similar") |
| 使い慣れたファイルに取り組む | search(scope: "files", filepath: "...") |
| 過去の設計上の判断理由が必要 | search(query: "...", scope: "plans") |
| 前回のセッションで何をしたか確認する | search(scope: "sessions") |
| 成功したツールのワークフロー | search(scope: "tools") |
| 一般的な検索 | search(query: "...", scope: "conversations") |
| セッションを詳しく調べる | inspect(session_id: "...") |
| ルール、スキル、CLAUDE.md | search(query: "...", scope: "config") |
| タスク管理の履歴 | search(query: "...", scope: "tasks") |
| セッションをまたいだメモリー | search(query: "...", scope: "memories") |
主なパラメーター
scope:検索対象を指定します —conversations、errors、files、plans、config、tasks、similar、sessions、tools、memories、またはall(デフォルト)limit:結果の件数(デフォルトは 10)project:プロジェクト名の部分文字列で絞り込みます(conversations、sessions で使用可能)timeframe:today、yesterday、week、month
よくある間違い
| 間違い | 修正方法 |
|---|---|
| いきなり WebSearch を使う | まず Historian を確認します — 過去の解決策のほうが関連性が高いです |
| あいまいなクエリ | エラーメッセージ、ファイルパス、ツール名など、具体的な用語を使います |
エラー検索に scope: "all" を使う | scope: "errors" を使います — 修正方法の抽出に特化しています |
| キーワードを大量に並べた長いクエリ | 一般的な用語を 10 個以上並べず、具体的な用語を 3~5 個に絞ります |
コメント
Markdown 対応