mcpField
S
scout

scout

github.com/venhdev開発1131 回インストール今日更新
リポジトリ

scout について

scout は、標準仕様、大規模運用の技術事例、障害事後分析を基に技術調査を行うエージェントスキルです。調査範囲を定め、運用パターンと障害要因をまとめたレポートを作成します。

主な機能

  1. 01情報源を権威性で分類
  2. 02検索数と閲覧ページ数を制限
  3. 03標準と運用事例を照合
  4. 04構造化された調査レポートを作成
  5. 05clarify または changeset に後続作業を振り分け

活用シーン

  1. 01運用事例に基づくアーキテクチャ評価
  2. 02運用上のトレードオフと障害要因の特定

インストール

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

$npx skills add https://github.com/venhdev/skills --skill scout

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

詳細

scout — 実システムのベストプラクティスと本番環境アーキタイプエンジン

ドメイン評価基準

1. 情報源の信頼性階層

技術的な問い合わせについて、信頼できる本番環境の根拠を照合します。

  • ティア 1（標準規格と公式仕様）：RFC、言語仕様、クラウドベンダーのリファレンスアーキテクチャ、正式な技術論文。
  • ティア 2（大規模本番環境のエンジニアリング）：実績のある大規模エンジニアリング組織（Stripe、Netflix、Cloudflare、Discord、Uber、Meta など）の技術ブログやアーキテクチャに関する開示。
  • ティア 3（実運用での教訓と事後分析）：エッジケース、運用上のボトルネック、障害モードを明らかにする、本番環境での障害、事後分析、根本原因分析の記録。
  • 除外フィルター：SEO に最適化されたコンテンツファーム、検証されていない個人ブログの投稿、ベンダーのマーケティング資料、精査されていない AI の要約を除外します。
2. 検索と採用の上限
  • 探索上限：スカウト実行 1 回あたり、検索クエリは最大 8 件、取得ページは最大 10 件です。
  • 採用件数：シグナルの強い優れた情報源 3～5 件から統合します。
  • 早期終了条件：主要なパターンと既知の障害モードを一次資料で照合できた時点で、検索を終了します。

標準出力契約

# Scout Report: <Topic / Inquiry>

## 1. Executive Summary
- **Canonical Production Archetype**: <Boring, battle-tested standard approach adopted by industry leaders>
- **Operational Reality**: <Key complexity, maintenance overhead, or scaling bottleneck in practice>

## 2. Industry Precedents & Battle Scars
| Source / Organization | Pattern Deployed | Production Scale / Context | Known Failure Mode / Trade-off |
| :--- | :--- | :--- | :--- |
| <Org / Paper> | <Architecture / Tool> | <Traffic, Data Volume, SLA> | <Failure point, latency spike, cost trap> |

## 3. Recommended Baseline vs. Traps
- **Recommended Baseline**: <Simplest robust architecture meeting requirements without premature optimization>
- **Premature Traps to Avoid**: <Over-engineered patterns or hype-driven tools that introduce unnecessary failure modes>

## 4. Primary Citations
- [<Source Title>](<Verified URL>) — <Core insight or concrete data point extracted>
ルーティング
  • 意図的なトレードオフの検討、またはプロジェクトへのアーキテクチャの適合性評価 →（/clarify 経由）。
  • ベースラインが受け入れられ、十分な根拠があり、呼び出し元が変更計画を求めている場合 →（/changeset 経由）。

実行プロトコル

  1. クエリの照合とディスパッチ：

    • 標準規格／RFC、大規模エンジニアリングの事例、障害の事後分析を組み合わせた、対象を絞った検索クエリを 2～3 件作成します。
    • research サブエージェント（役割：Real-System Research Scout）を起動し、以下を提供します。
      • 照合済みのクエリと検索上限（クエリ最大 8 件、取得ページ最大 10 件）。
      • 必須の出力契約として、上記の標準出力契約。
    • 統合の前に URL ツールを使ってページ本文全体を確認するようサブエージェントに指示します。厳密に検証済みの URL のみを引用し、検索スニペットだけをもとに統合しないよう指示します。

  2. 統合と終了：

    • 完成したレポートを会話ストリームに出力し、直ちにターンを終了します。

コメント

Markdown 対応