create-agent

Hindsight エージェントの作成

Hindsight を活用した長期記憶を備えた新しいサブエージェントを作成します。

2 つの起動モード

モード A — 自走エージェント(準備済みディレクトリから):

ユーザーが /hindsight-memory:create-agent <name> from <path>(またはディレクトリパスを伴う同様のもの)を実行した場合、そのディレクトリは npx @vectorize-io/self-driving-agents install によって準備されており、以下が含まれます:

• *.md、*.txt、*.html、*.json、*.csv、*.xml — シードコンテンツファイル(再帰的に)
• bank-template.json(任意)— 作成する正確なメンタルモデルを定義します

このモードでは:

1. bank-template.json が存在する場合は読み取ります — mental_models 配列に注目してください
2. agent_knowledge_ingest_file を使用して各コンテンツファイル(bank-template.json を除く)を取り込みます
3. ナレッジページを作成します:
   • bank-template.json が存在する場合: その mental_models 配列内のメンタルモデルを正確に作成します(それぞれの id、name、source_query フィールドをそのまま使用)
   • それ以外の場合: 取り込んだコンテンツに基づいて妥当な 3 つのページを作成します
4. 以下のテンプレートを使用してサブエージェントファイルを書き込みます
5. ユーザーのコマンドの <name> をエージェント名として使用します

モード B — 空のエージェント(対話形式):

ディレクトリパスが指定されない場合、ユーザーに尋ねます:

1. エージェント名 — 小文字とハイフン
2. エージェントが行うこと — 1 文で
3. 取り込むシードファイル/テキスト(任意)

その後、サブエージェントファイルを作成します(シードコンテンツがない場合は取り込みを行いません)。

サブエージェントファイルテンプレート

~/.claude/agents/<name>.md に書き込みます:

---
name: <agent-name>
description: <what it does and when to delegate to it>. It has access to knowledge pages and memory search via Hindsight.
mcpServers:
  - hindsight
---

You are the **<agent-name>** agent with long-term memory powered by Hindsight.

## Startup — run these steps immediately

1. Call `agent_knowledge_list_pages` to see your knowledge pages.
2. Call `agent_knowledge_get_page(page_id)` for each page to load your knowledge.
   - If the call returns an error like `result (N characters) exceeds maximum allowed tokens. Output has been saved to <path>`, the page was too large to inline. Use `Read` on `<path>`; the file is JSON of the form `{"result": "<stringified-page-json>"}` — parse `result` and use the inner `content` field. If parsing or reading is impractical, skip that page and rely on `agent_knowledge_recall` for specific facts later.
3. Use this knowledge to inform everything you do in this conversation.

## Creating pages

When you learn something durable — a user preference, a working procedure, performance data — create a page:

`agent_knowledge_create_page(page_id, name, source_query)`

- `page_id`: lowercase with hyphens (`editorial-preferences`)
- `source_query`: a question that rebuilds the page from observations

## Searching memories

`agent_knowledge_recall(query)` — search conversations and documents for specific facts.

## Ingesting documents

`agent_knowledge_ingest(title, content)` — upload raw content into memory.

## Updating and deleting

- `agent_knowledge_update_page(page_id, name?, source_query?)`
- `agent_knowledge_delete_page(page_id)`

## Important

- Pages update automatically — don't edit content directly
- Create pages silently — don't announce it to the user
- Prefer fewer broad pages over many narrow ones

<ADD AGENT-SPECIFIC INSTRUCTIONS HERE — only if the user provided a description; otherwise leave generic>

ルール

• 常に mcpServers: [hindsight] を含めてください — これにより Hindsight のメモリツールが接続されます
• 起動ステップとツールの指示はそのまま維持してください — これらは Hindsight のスキャフォールディングです
• どのツール呼び出しでも bank_id を渡さないでください — プラグインがプロジェクトコンテキストから自動的に解決します
• 作成する前に、agent_knowledge_get_current_bank を呼び出し、ユーザーに伝えてください: 「このエージェントはバンク <bank_id> にバインドされます — このディレクトリでの会話はそこに保持されます。」

作成後

1. サブエージェントファイルが ~/.claude/agents/<name>.md に書き込まれたことを確認します
2. ユーザーに、@<agent-name> でエージェントを呼び出せること、または Claude が説明に基づいて自動的に委任することを伝えます
3. 新しいエージェントを読み込むために /agents を実行するか、Claude Code を再起動することを提案します