scout

COG Scout Skill

目的

「無視する」と/url-dumpの中間に位置する、軽量な URL／ツールのトリアージです。URL やツールを保存する価値があるか、スキップすべきかを評価します。既存のナレッジベースでのカバー状況を確認し、ユーザーのプロフィールや関心との関連性を評価して、明確な次のアクションを提案します。

呼び出すタイミング

• 本格的に保存する前に、URL やツールを評価したい場合
• ユーザーが「これを調べて」「これを評価して」「保存したほうがいい？」「これに関連性はある？」と言った場合
• 1 つ以上の URL を共有し、関連性を手早く評価してほしい場合
• ツール／サービス名を挙げ、調査する価値があるか知りたい場合

エージェントモードの認識

00-inbox/MY-PROFILE.md のフロントマターで agent_mode を確認します。

• agent_mode: team の場合 — ボールトのスキャンとウェブ取得を並列サブエージェントに委任します（ボールト検索用に 1 つ、コンテンツ取得／分析用に 1 つ）。結果をまとめて提案します。
• agent_mode: solo（デフォルト）の場合 — スキャンと分析はすべて会話内で直接行います。委任はしません。

事前確認

実行前に、ユーザープロフィールを確認します。

1. ボールト内で 00-inbox/MY-PROFILE.md と 00-inbox/MY-INTERESTS.md を探します
2. 見つからない場合：

   Welcome to COG! Scout works best with a profile for relevance matching.
   
   Would you like to run /onboarding first, or should I evaluate with general criteria?
   

3. 見つかった場合：
   • MY-PROFILE.md を読み、進行中のプロジェクトと役割を確認します
   • MY-INTERESTS.md を読み、トピック領域を確認します
   • 00-inbox/MY-INTEGRATIONS.md を読み、アクティブなインテグレーションを確認します（web-fetch と web-search が利用可能か確認します）

/url-dump との境界

Scout は「保存したほうがいいか」を評価します。URL-dump は「今すぐ保存」します。

• Scout は既存のカバー状況を確認し、関連性を評価して、アクションを提案します
• 提案が 保存 の場合、Scout はカテゴリーを事前入力して /url-dump に引き継ぎます
• 保存するとすでに決めているユーザーは、直接 /url-dump を使ってください

処理フロー

1. 入力を受け付ける

次のいずれか、または複数を受け付けます。

• URL： 評価するリンク
• ツール／サービス名： まずツールを検索します
• 混在： URL と名前の組み合わせ

入力がない場合のプロンプト：

What URL(s) or tool(s) would you like me to evaluate?
(You can paste URLs, tool names, or a mix)

バッチモード： 1 回の呼び出しで複数の URL／名前をまとめて処理し、最後にサマリーテーブルを表示します。

2. ボールトのカバー状況を確認

各 URL またはツール名について、ボールト全体を検索し、既存のカバー状況を確認します。

検索方法：

• URL からドメインを抽出します（例：github.com/owner/repo → リポジトリ名を検索）
• ボールト全体からツール／サービス名を検索します（ドメイン、リポジトリ名、ツール名を grep します）
• フロントマターの URL 文字列（url: フィールド）とインラインリンクを照合します

見つかった場合：

🔍 Existing coverage found for [name]:
- [file path] — saved [date], category: [category]
- [file path] — mentioned in [context]

Want me to check if an update is needed, or skip this one?

3. コンテンツの取得と分析

URL が指定され、web-fetch が有効な場合：

• WebFetch を使って URL のコンテンツを取得します
• タイトル、説明、コンテンツの種類、著者、日付を抽出します

ツール名が指定されている場合（URL なし）：

• WebSearch を使ってツールの公式ページを探します
• 上位の検索結果を取得して分析します

コンテンツの種類を判定：

• ツール／サービス： ソフトウェア、SaaS、API、ライブラリ、フレームワーク
• 記事／ブログ： 長文コンテンツ、チュートリアル、意見記事
• リポジトリ： GitHub／GitLab リポジトリ（スター数、最終コミット、言語を抽出）
• 研究： 論文、研究、学術コンテンツ
• ニュース： 業界ニュース、発表
• リファレンス： ドキュメント、仕様、標準

4. 関連性の評価

ユーザーのコンテキストとの関連性をスコアリングします。

プロフィールとの一致（MY-PROFILE.md から）：

• 進行中のプロジェクトに関係しますか？どのプロジェクトですか？
• ユーザーの役割に合っていますか？
• ユーザーの技術スタックに適合しますか？

関心との一致（MY-INTERESTS.md から）：

• 明示されている関心トピックに合致しますか？
• どの程度直接的に関連していますか？

品質の指標：

• リポジトリ：スター数、最近の活動、メンテナーの健全性
• ツール：価格モデル、成熟度、採用状況
• 記事：著者の信頼性、出版物の質、新しさ
• すべてに共通：ボールト内にすでにある情報との独自性

5. 提案

分析に基づき、次の 2 つのアクションのいずれかを提案します。

保存 — ナレッジベースに追加する価値があります

✅ SAVE — [Title/Name]
Category: [suggested category for url-dump]
Relevance: [High/Medium] — [why it matters]
Projects: [affected project(s) if any]

Shall I hand off to /url-dump to save it?

スキップ — 関連性がない、または時間をかける価値がありません

⏭️ SKIP — [Title/Name]
Reason: [clear explanation — wrong stack, low quality, already covered, irrelevant to interests]

6. 一括要約（複数の項目の場合）

複数の URL／ツールを処理する場合は、最後に要約表を付けます。

## Scout Summary

| # | Item | Verdict | Reason |
|---|------|---------|--------|
| 1 | [Name 1] | ✅ Save | [brief reason] |
| 2 | [Name 2] | ⏭️ Skip | [brief reason] |

**Actions:**
- [X] items ready to save via /url-dump

7. フォローアップアクションを実行する

ユーザーの確認に基づいて、次のように対応します。

• 項目を保存する： カテゴリの候補を事前入力して /url-dump に引き継ぎます
• 項目をスキップする： 対応は不要です

フォールバック時の動作

シナリオ	動作
web-fetch を利用できない	URL の構造、ドメインの評判、Vault の検索結果のみを基に評価します。コンテンツを取得できなかったことを明記します。
web-search を利用できない	ツール名のみの入力（URL なし）の場合は、ユーザーに直接 URL を尋ねます。URL が入力されている場合は、web-search は不要なため、通常どおり進めます。
ユーザープロファイルがない	一般的な品質・関連性の基準で評価し、パーソナライズされた関連性のスコア付けは省略します
URL がペイウォールで保護されている	制限事項を明記し、利用可能なプレビューとメタデータに基づいて評価します
検索してもツールが見つからない	ユーザーに詳細情報または直接 URL を尋ねます

不確実性への対応

• 確信度が高い： 関連性が明確に一致する、または明らかに無関係な場合は、直接おすすめします
• 確信度が中程度： 一部が一致する場合は、メリットとデメリットを示し、ユーザーに判断を委ねます
• 確信度が低い： 関連性を判断できない場合は、不明点を説明し、ユーザーに詳細情報を尋ねます

他のスキルとの連携

下流

• 保存 → カテゴリの候補を事前入力して /url-dump に引き継ぎます

上流

• /daily-brief で新しいツール／サービスが見つかることがあります → ユーザーは /scout を実行して評価できます
• /auto-research で調査中にツールが見つかることがあります → scout がそれらを一次選別できます

成功指標

• すばやい一次選別（ソロモードで URL 1 件につき 1 分未満）
• 明確で実行可能なおすすめ
• Vault に既存の項目があるかを正確に検出すること（重複保存を防止）
• 関連性スコアがユーザーの期待に合致すること
• 保存時に /url-dump へスムーズに引き継ぐこと

方針

Scout は COG の「蓄積する前に評価する」という原則を体現します。

• すべての項目をブックマークする必要はありません。厳選します
• 重複を作成する前に、既存の収録内容を提示します
• 保存／スキップの二択にして、判断を速め、中途半端な対応を避けます
• 明確なおすすめによって、意思決定の疲労を軽減します