mcpField
H
hindsight-cloud

hindsight-cloud

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

hindsight-cloud について

hindsight-cloud は、チーム共有の永続メモリとして Hindsight Cloud を使うエージェントスキルです。Hindsight コマンドラインを通じたチーム知識の保存と、関連コンテキストの検索を案内します。

主な機能

  1. 01チーム共有メモリの保存
  2. 02タスク前のコンテキスト検索
  3. 03reflect による記憶の統合
  4. 04Cloud コマンドラインの設定案内
  5. 05個人の好みの帰属記録

活用シーン

  1. 01共有プロジェクト規約の保持
  2. 02チーム手順や解決策の記録
  3. 03チームメンバー向けのコードベース情報検索

インストール

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

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

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

詳細

Hindsight Memory Skill (Cloud)

Hindsight Cloud を通じて永続メモリを利用できます。このメモリバンクはチームと共有されているため、ここに保存されたナレッジはこのコードベースに取り組むすべての人に役立ちます。

チームのナレッジを積極的に保存し、コンテキストを想起することで、より良い支援を提供できます。

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

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

cat ~/.hindsight/config

ファイルが存在しない、または認証情報が欠けている場合は、ユーザーがセットアップできるよう支援してください：

  1. CLI をインストールする（hindsight コマンドが見つからない場合）：

    curl -fsSL https://hindsight.vectorize.io/get-cli | bash

  2. 設定ファイルを作成する - ユーザーに API Key を尋ねてください（https://ui.hindsight.vectorize.io から取得できます）：

    mkdir -p ~/.hindsight
cat > ~/.hindsight/config << 'EOF'
api_url = "https://api.hindsight.vectorize.io"
api_key = "<user's API key>"
EOF
chmod 600 ~/.hindsight/config

  3. バンク ID を取得する - ユーザーにチームのバンク ID（例：team-myproject）を尋ねてください

セットアップ後は、以下のすべてのコマンドでそのバンク ID を使用してください。

Hindsight の仕組み

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

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

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

コマンド

<bank-id> はユーザーの実際のバンク ID（例：team-frontend）に置き換えてください。

メモリを保存する

学習した内容を保存するには memory retain を使用します。完全なコンテキストを渡してください — 生の観察、セッションノート、または詳細な説明：

hindsight memory retain <bank-id> "The project uses ESLint configured with the Airbnb rule set and Prettier for formatting. Auto-fix on save is enabled in the editor config."
hindsight memory retain <bank-id> "Ran the test suite with NODE_ENV=test. Tests pass. Without NODE_ENV=test, the suite fails with a missing config error." --context procedures
hindsight memory retain <bank-id> "Build failed on Node 18 with error 'ERR_UNSUPPORTED_ESM_URL_SCHEME'. Switched to Node 20 and build succeeded." --context learnings
hindsight memory retain <bank-id> "Alice reviewed the PR and asked for verbose commit messages that explain the motivation, not just what changed." --context preferences

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

hindsight memory retain <bank-id> "[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 を使用して、関連するコンテキストを取得します：

hindsight memory recall <bank-id> "project conventions and coding standards"
hindsight memory recall <bank-id> "Alice preferences for this project"
hindsight memory recall <bank-id> "what issues have we encountered before"
hindsight memory recall <bank-id> "how does the auth module work"
メモリを振り返る

コンテキストを統合するには memory reflect を使用します：

hindsight memory reflect <bank-id> "How should I approach this task based on past experience?"

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

これは共有のチームバンクです。チームに役立つナレッジを保存してください。個人の設定については、その人の名前を含めてください。

プロジェクト／チームの規約（共有）
  • コーディング標準（「プロジェクトは 2 スペースインデントを使用」）
  • 必須のツールとバージョン（「プロジェクトには Node 20+、PostgreSQL 15+ が必要」）
  • リンティングとフォーマットのルール（「Airbnb 設定の ESLint」）
  • テストの規約（「統合テストには Docker の起動が必要」）
  • ブランチ命名と PR の規約
個人の設定（本人に紐づける）
  • 個人的なコーディングスタイル（「Alice は明示的な型注釈を好む」）
  • コミュニケーションの好み（「Bob は詳細な PR 説明を好む」）
  • ツールの好み（「Carol は vim キーバインドを使用」）
手順の結果
  • タスクを正常に完了した手順
  • 機能した（または失敗した）コマンドとその理由
  • 発見された回避策
  • 問題を解決した設定
タスクからの学び
  • 遭遇したバグとその解決策
  • 効果のあったパフォーマンス最適化
  • アーキテクチャの決定とその根拠
  • 依存関係やバージョンの要件
チームのナレッジ
  • 新しいチームメンバー向けのオンボーディング情報
  • よくある落とし穴とその回避方法
  • アーキテクチャの決定とその根拠
  • 外部システムとの統合ポイント
  • ドメイン知識とビジネスロジックの説明

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

必ず想起してください。次の場合の前に：

  • 自明でないタスクを開始するとき
  • 実装に関する決定を下すとき
  • ツール、ライブラリ、またはアプローチを提案するとき
  • プロジェクトの新しい領域でコードを書くとき
  • コードベースに関する質問に答えるとき
  • チームメンバーが何かの仕組みを尋ねたとき

ベストプラクティス

  1. すぐに保存する: 何かを発見したら、その場ですぐに保存します
  2. 豊富なコンテキストを渡す: 要約済みの文字列ではなく、完全な観察内容を含めます — サーバーが事実を自動的に抽出します
  3. 結果を含める: 何が起きたかだけでなく、なぜ起きたかも保存します。失敗や回避策も含めます
  4. まず思い出す: 作業を始める前に、必ず関連するコンテキストを確認します
  5. チーム優先で考える: 他のチームメンバーの役に立つ知識を保存します
  6. 個人の好みは帰属を明記する: 「ユーザーは X を好む」ではなく「Alice が PR をレビューし、X を求めた」と保存します
  7. プロジェクトと個人を区別する: プロジェクトの慣習は全員に適用され、個人の好みは人ごとに異なります
  8. メタデータには --context を使う: --context フラグはメモリの種類（例: procedures、learnings、preferences）にラベルを付けるものであり、完全な内容の代わりではありません

コメント

Markdown 対応