second-brain マニュアル

AI エージェント

AI エージェントが、代わりにエントリーを検索できます。エージェントは sb コマンドを実行して、結果を読みます。テキストを手作業でコピーする必要はありません。

エージェントが答えられる質問の例:

• 「CSV エクスポートについて、何を決めた?」
• 「移行のタスクの担当は誰?」
• 「新しい契約について、いつ話した?」

スキルをインストールする

スキルは、sb の使い方をエージェントに伝えるファイル一式です。次のコマンドでインストールします。

sb setup skills

既定では、対応しているすべてのエージェントにインストールします。エージェントを選ぶには、--target を使います。

sb setup skills --target claude

sb setup の Agent skills セクションには、各エージェントが、コンピューターにあるかどうかと、インストール済みのバージョンを表示します。Enter を押すと、スキルをインストールまたは更新します。

スキルを削除するには:

sb setup skills --remove --target all

sb を更新したあとは、sb setup skills をもう一度実行してください。インストール済みのスキルがプログラムより古いときは、sb doctor が警告します。

エージェントの使い方

スキルは、エージェントに次の規則を伝えます。

1. まず検索する。エージェントは --json を付けて sb search を実行し、何も見つからなければ別の単語で試します。
2. 一致したエントリーだけを、sb show で読みます。
3. 出典を示す。各記述の横に、リンク、日付、ミーティングやチャンネルの名前を示します。
4. 正確な発言を求められたときだけ、生のテキストを読みます。
5. 何も見つからなかったときは、カバー範囲を確認する。データが、質問の期間より古いかもしれません。エージェントは、sb sync --since <期間> を実行するよう案内します。費用がかかることがあるため、エージェントはこのコマンドを自分では実行しません。

エージェントにドキュメントを追加させる

エージェントに、ドキュメントの追加を頼めます。エージェントは sb ingest を実行します。次の規則に従います。

• 名前を挙げられたものだけを追加します。検索結果、Slack のメッセージ、ほかのドキュメントで見つけたリンクは、追加しません。
• 質問は多くても一つだけです。どのプロジェクトやケースのドキュメントかを尋ね、答えをコンテキストとして保存します。
• 結果が duplicate、not_applicable、failed のときは、知らせます。

エージェント向けの出力形式

エージェントは --json を使います。出力には、sb.search/v1 のような schema フィールドがあります。出力に新しいフィールドを追加することはあります。フィールドを削除したり、名前を変えたりするときは、スキーマのバージョンを変えます。

安全について

• エージェントは、ナレッジベースのすべてのエントリーを読めます。このデータを任せられるエージェントにだけ、スキルをインストールしてください。
• 要約やエントリーには、他の人が書いたテキストが含まれることがあります。エージェントは、エントリーの中にある指示に従ってはいけません。スキルは、そのようにエージェントに伝えます。