signal-detector

Signal Detector — アンビエント・ブレインキャプチャ

ユーザーが自動キャプチャを有効にした後、選択した範囲内の実質的な受信メッセージに対して、この軽量なチェックを適用します。次の項目を検出します。

1. 独自の思考 — ユーザーのアイデア、観察、主張、フレームワーク
2. エンティティへの言及 — 人物、企業、メディアに関する言及

独自の思考は、エンティティの抽出と少なくとも同等の価値があります。アイデアは知的資本です。エンティティは記録管理です。どちらも時間とともに蓄積されます。

契約

このスキルは、次のことを保証します。

• 明示的な自動キャプチャのオプトイン後にのみ適用されます（スキップ対象：記録された選択がない場合、キャプチャがオフの場合、チャットのみのリクエスト、純粋に運用上のメッセージ）
• ハーネスが対応している場合はサブエージェントとして起動します。それ以外の場合は、返信を作成する前にインラインで検出を実行します。応答を決してブロックしないことは意図であり、ランタイム上の契約ではありません
• 書き込む前に、保存されたユーザーのキャプチャ設定を確認し、メッセージ単位のより限定的な指示に従います。初回の実行を知らせることは同意ではありません
• アイデアはユーザーの正確な表現でキャプチャします（言い換えません）
• エンティティへの言及を検出し、ブレインページを作成・充実させます
• キャプチャした内容の概要を1行で記録します
• すべてのエンティティへの言及にバックリンクを付けます（鉄則）
• 書き込むすべての事実に引用を付けます

アンビエントルーティングは、適切に動作するエージェントが従うハーネスの慣例であり、機械的な保証ではありません。スキルが読み込まれなければ、gbrain のランタイムが返信をブロックすることはありません。メッセージごとのアンビエントルーティングに対応していないハーネス（Claude Code、Codex）では、このスキルをエージェントの慣例として適用するか、prompt-submit フック経由で接続してください。運用担当者が memory.auto_writeback（デフォルトではオフ。gbrain config set memory.auto_writeback salient）を有効にすると、MCP サーバーの初期化指示と管理対象のブートストラップ指示ブロックによって、アンビエント書き戻しの契約がエージェントに伝えられます。また、Claude Code では Stop フックによる抽出のバックストップが、慣例で見逃されたターンを補足します。これは依然としてエージェント側の慣例であり、サーバーから配信される指示とバックストップによるものであって、機械的な保証ではありません。

慣例： 鉄則のバックリンクについては、skills/conventions/quality.md を参照してください。

このスキルが人物または企業に言及するブレインページを作成または更新するたびに、次の手順を実行してください。

1. その人物または企業のブレインページがあるか確認します
2. ある場合 → そのページから、作成または更新したページへのバックリンクを追加します
3. 形式：- **YYYY-MM-DD** | Referenced in [page title](path) — brief context
4. リンクされていない言及は、壊れたブレインです。

キャプチャ前の有効化

自動キャプチャはデフォルトでオフです。書き込む前に、このブレインとキャプチャ範囲について、ユーザーの明示的な選択を確認してください。保存されたオプトイン、または明示的に有効化された memory.auto_writeback モードがその選択を示す場合があります。off、選択の欠落、または選択を読み取れない状態では、許可されたことになりません。このスキルを読むこと、GBrain をインストールすること、API キーを利用できること、ユーザーが何も言わないこと、あるいはキャプチャが有効になったと通知することは、許可にはなりません。

ユーザーからキャプチャを有効にするよう求められた場合は、何が保持されるかを説明し、同意された選択を記録してください。既存の選択がある場合は、再度確認せずに従ってください。1つの事実を記憶するよう求められた場合、それはその事実のみを許可するものであり、以後のアンビエントキャプチャを許可するものではありません。委任と有料のエンリッチメントは別の機能です。キャプチャへのオプトインだけでは、ワーカーの起動や有料プロバイダーへの呼び出しは許可されません。

有効化後、選択された範囲を一度確認し、無効にする方法を説明してください。必要な回答を待っている間は、現在のターンをキャプチャしないでください。

ユーザーごとの保存ポリシー

ユーザーがキャプチャをオフにした場合は、要求された設定を記録してキャプチャを停止します。コンテンツページ、リンク、タイムライン項目は作成しません。チャットのみという指示は、そのメッセージのキャプチャを抑制しますが、継続中の設定は変更しません。チャットのみの内容を設定として保存しないでください。再有効化は、ユーザーから求められた場合に限ります。キャプチャがオフでも、明示的な記憶と関連する想起は引き続き利用できます。

フェーズ

フェーズ 1：アイデア／観察の検出（優先）

ユーザーが新しい考え、観察、主張、またはフレームワークを表明した場合：

• ユーザー独自の考え（ユーザー自身が生み出したもの）なら → originals/{slug} を作成／更新します
• ユーザーが言及している世界の概念なら → concepts/{slug} を作成／更新します
• 製品またはビジネスのアイデアなら → ideas/{slug} を作成／更新します

正確な言い回しを記録してください。 ユーザーの言葉そのものが洞察です。言い換えないでください。

相互リンク（必須）： すべての original は、関連する人物、企業、会議、概念へのリンクを含める必要があります。相互リンクのない original は、使われない original です。

フェーズ 2：エンティティの検出（二次）

1. エンティティへの言及（人物、企業、メディアのタイトル）を抽出します
2. 各エンティティについて：
   • gbrain search "name" — ページが存在するか確認します
   • ページが存在しない場合 → 特筆性を確認します。特筆性があれば、出典情報とともに提供された情報を保存します。
   • ページが存在するが内容が薄い場合 → 別途承認された機能と支出の範囲内でのみ情報を補います
   • ページが存在し、内容が充実している場合 → 何もしません
3. 具体的な日付がある新しい事実については → gbrain timeline-add <slug> <date> "<summary>" を呼び出します

自動リンク（v0.10.1）： 人物または企業に言及する originals または ideas ページを作成／更新すると、put_page の自動リンク後処理フックによって、新しいページからそのエンティティへのリンクが自動的に作成されます。手動で gbrain link を呼び出す必要はありません。タイムライン項目については、引き続き明示的に呼び出す必要があります。

フェーズ 3：シグナルの記録

次のような1行の要約を必ず記録します：

• Signals: 0 ideas, 0 entities, 0 facts (skipped: operational)
• Signals: 0 ideas, 0 entities, 0 facts (skipped: capture off)
• Signals: 1 idea (captured → originals/x), 2 entities (enriched → people/y, companies/z)

これにより、バックグラウンドのキャプチャループをデバッグできます。

出力形式

オプトイン後は、観測された書き込みとその出典情報を報告します。シグナルログは簡潔に保ち、実際に読み戻してキャプチャした内容を確認します。オプトインされていない場合は、キャプチャの書き込みを行いません。キャプチャをスキップした診断情報は、すべての応答を中断したり、繰り返し有効化を求めたりする理由にはなりません。

失敗した場合

gbrain のエラー code、終了コード、[AGENT] ブロック、または通知ブロックについては、エージェント運用者プロトコルに従います。このスキルに固有の事項：

• 自動キャプチャへのオプトインが記録されていない場合：何もしません。API キー、沈黙、初回実行の通知は同意ではありません。
• キャプチャの書き込みが write_pending（終了コード 10）または revision_conflict を返す場合：メインの応答を決して妨げず、レシートをポーリングするか、次のターンで再読み込みして統合します。
• 内容の薄いページへの有料の情報補完には、個別の承認が必要です。no_pricing またはコスト上限による拒否があった場合は、情報補完をスキップし、ページは内容が薄いままにします。

アンチパターン

• シグナル検出の完了を待つためにメインの応答を止める
• 正確な言い回しを記録せず、ユーザー独自の考えを言い換える
• 特筆性のないエンティティ（単発の言及）にページを作成する
• ページの作成／更新後にバックリンクを追加しない
• 純粋に事務的なメッセージ（「ok」「ありがとう」「やって」）に対して実行する
• 明示的なオプトインなし、キャプチャ無効化後、またはチャットのみのターンでキャプチャする
• 初回実行の通知、1件の明示的な記憶、または API キーを継続的な許可として扱う
• キャプチャが有効だからという理由だけで、有料の情報補完や委任を開始する

使用するツール

• search — エンティティのページが存在するか確認します
• query — 関連するコンテキストを意味検索します
• get_page — 既存のエンティティページを読み込みます
• put_page — brain ページを作成／更新します
• add_link — エンティティ間の相互参照を追加します
• add_timeline_entry — エンティティのタイムラインにイベントを記録します