mcpField
H
hindsight-local

hindsight-local

github.com/vectorize-ioエージェントワークフロー55.5k501 回インストール今日更新
リポジトリ

hindsight-local について

hindsight-local は、hindsight-embed コマンドラインを使って記憶を保持するエージェントスキルです。有用な情報の保存とタスク前の検索を促し、初回の設定確認も案内します。

主な機能

  1. 01詳細な記憶の保存
  2. 02タスク前のコンテキスト検索
  3. 03reflect による記憶の統合
  4. 04コンテキスト別の記憶ラベル付け

活用シーン

  1. 01プロジェクトの規約や好みの保持
  2. 02タスク結果や回避策の記録
  3. 03実装前の過去情報の確認

インストール

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

$npx skills add https://github.com/vectorize-io/hindsight --skill hindsight-local

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

詳細

Hindsight Memory Skill (ローカル)

hindsight-embed CLI を通じて永続メモリを利用できます。より良い支援を提供するために、学んだことを積極的に保存し、コンテキストを想起してください。

セットアップ確認（初回のみ）

メモリコマンドを使用する前に、Hindsight が設定されていることを確認してください：

uvx hindsight-embed daemon status

これが失敗するか「not configured」と表示される場合は、対話式セットアップを実行してください：

uvx hindsight-embed configure

これにより、LLM プロバイダーと API キーの入力が求められます。セットアップ後は、以下のコマンドが機能します。

Hindsight の仕組み

retain を呼び出すと、Hindsight は文字列をそのまま保存するのではありません。サーバーは内部パイプラインを実行し、次の処理を行います：

  1. LLM を使用してコンテンツから構造化された事実を抽出します
  2. エンティティ（人物、ツール、概念）を特定し、関連する事実をリンクします
  3. 事実間の時間的・因果的関係を構築します
  4. セマンティック検索用の埋め込みを生成します

つまり、豊かで完全なコンテキストを持つコンテンツを渡すべきです。事前に要約した文字列よりも、サーバーの方が重要な情報を抽出するのが得意です。あなたの役割は、何を抽出するかではなく、いつ保存するかを決めることです。

コマンド

メモリを保存する

memory retain を使用して、学んだことを保存します。完全なコンテキストを渡してください — 生の観察、セッションノート、会話の抜粋、または詳細な説明：

uvx hindsight-embed memory retain default "User is working on a TypeScript project. They enabled strict mode and prefer explicit type annotations over inference."
uvx hindsight-embed memory retain default "Ran the test suite with NODE_ENV=test. Tests pass. Without NODE_ENV=test, the suite fails with a missing config error." --context procedures
uvx hindsight-embed memory retain default "Build failed on Node 18 with error 'ERR_UNSUPPORTED_ESM_URL_SCHEME'. Switched to Node 20 and build succeeded." --context learnings

タイムスタンプ付きの生の会話トランスクリプトを渡すこともできます：

uvx hindsight-embed memory retain default "[2026-03-16T10:12:03] User: The auth tests keep failing on CI but pass locally. Any idea?
[2026-03-16T10:12:45] Assistant: Let me check the CI logs. Looks like the tests are running without the TEST_DATABASE_URL env var set — they fall back to the production DB URL and hit a connection timeout.
[2026-03-16T10:13:20] User: Ah right, I never added that to the CI secrets. Adding it now.
[2026-03-16T10:15:02] User: That fixed it. All green now." --context learnings
メモリを想起する

タスクを開始する前に memory recall を使用して、関連するコンテキストを取得します：

uvx hindsight-embed memory recall default "user preferences for this project"
uvx hindsight-embed memory recall default "what issues have we encountered before"
メモリを熟考する

memory reflect を使用して、コンテキストを統合します：

uvx hindsight-embed memory reflect default "How should I approach this task based on past experience?"

重要: メモリを保存すべきタイミング

価値のあることを学んだ後は必ず保存してください：

ユーザーの好み
  • コーディングスタイル（インデント、命名規則、言語の好み）
  • ツールの好み（エディター、リンター、フォーマッター）
  • コミュニケーションの好み
  • プロジェクトの規約
手順の結果
  • タスクを正常に完了した手順
  • 機能した（または失敗した）コマンドとその理由
  • 発見された回避策
  • 問題を解決した設定
タスクからの学び
  • 遭遇したバグとその解決策
  • 機能したパフォーマンス最適化
  • アーキテクチャの決定とその根拠
  • 依存関係やバージョンの要件

重要: メモリを想起すべきタイミング

以下を行う前に必ず想起してください：

  • 重要度の高いタスクを開始するとき
  • 実装に関する決定を下すとき
  • ツール、ライブラリ、またはアプローチを提案するとき
  • プロジェクトの新しい領域でコードを書くとき

ベストプラクティス

  1. すぐに保存する: 何かを発見したら、すぐに保存してください
  2. 豊富なコンテキストを渡す: 事前に要約した文字列ではなく、完全な観察を含めてください — サーバーが事実を自動的に抽出します
  3. 結果を含める: 何が起こったか AND その理由を保存してください。失敗や回避策も含めてください
  4. まず想起する: 作業を開始する前に関連するコンテキストを常に確認してください
  5. メタデータには --context を使用する: --context フラグはメモリの種類（例：procedures、learnings、preferences）にラベルを付けるものであり、完全なコンテンツの代わりではありません

コメント

Markdown 対応