meridian-doc-consultant

Meridian ドキュメントコンサルタント

このスキルでは、ユーザーの質問にトークン効率よく回答するため、公式 Meridian ドキュメントから適切なページを見つけて参照する方法をエージェントに案内します。

ドキュメントは https://developers.google.com/meridian/ で公開されています。Meridian MMM（/meridian/docs/...）と Meridian GeoX の地理実験（/meridian/geox/...）の両方を扱っています。Meridian の GitHub リポジトリにも google-meridian Python パッケージにも含まれていないため、ディスク上でドキュメントファイルを探さないでください。

基本的なワークフロー

ユーザーから Meridian に関する概念や手順について質問された場合は、次の手順に従ってください。

1. トピックを特定する

• ユーザーの質問を分析し、中心となるトピック（例：「ノット」「事前分布」「データ形式」）を特定します。

2. 候補ページを特定する（RAG 形式の検索）

• ドキュメントマップを参照し、その概要を使って、ユーザーの質問に関連する可能性のあるページを複数まとめて（例：3～5 ページ）特定します。
• 用語を直接検索する：ユーザーが特定の技術用語（例：eta_m、xi_c、knots）について質問している場合は、その用語をドキュメントマップで検索し、手順 3 で取得した候補ページの本文でも検索します。ドキュメントマップにトピックを扱うページが記載されていても、必ず検索してください。マップに該当する用語がない場合は、developers.google.com/meridian に限定したウェブ検索で候補ページを探してもかまいません。
• 概念の組み合わせ：質問に複数の概念（例：「事前分布」＋「データ不足」）が含まれる場合は、それらの概念を併せて扱うページを探します。
• 重要：適切なページを見つけるために、ページを 1 つずつ取得しないでください。無関係なページを取得すると、トークンと時間を浪費します。候補ページの特定には、マップの概要を活用してください。

3. 候補ページを取得して読む

• 候補リストから、有望なページを**上位 N 件（例：3 件）**選んで読みます。
• 各ページの URL の末尾に .md.txt を追加して、Markdown 版を取得します。たとえば、ページ https://developers.google.com/meridian/docs/pre-modeling/amount-data-needed は、プレーンな Markdown として https://developers.google.com/meridian/docs/pre-modeling/amount-data-needed.md.txt から取得できます。URL 取得ツールを使うか、シェルしか使えない場合は curl -sL <url>.md.txt を使用します。通常の HTML ページはサイトのレイアウトが大部分を占めるため、.md.txt 版を優先してください。
• ページが長い場合は、全文を読むのではなく、取得したテキストを特定のキーワードで検索して、関連するセクションを見つけます。
• 検索語を広げる：特定のキーワード（例：「最大チャネル数」）で見つからない場合は、関連するより広い概念（例：「チャネル」）を検索して、該当するセクションを見つけます。
• 推奨事項を検索する：推奨事項を探す場合は、トピックのキーワードと組み合わせて、「recommend」「best practice」「should」などのキーワードを検索します。
• 上限に関する曖昧な一致への対応：ユーザーが「最大値」を尋ねていて、ドキュメントに「X 未満」と記載されている場合は、その値を提示します。
• コードよりドキュメントを優先する：概念に関する質問では、ソースコードよりドキュメントページを優先します。
• ウェブにアクセスできない場合：ページを取得できない場合は、このスキルには developers.google.com/meridian へのアクセスが必要であることをユーザーに伝え、参照用にドキュメントマップに記載されたページの URL を提示します。ドキュメントに記載されたガイダンスとして、確認できていない詳細を提示しないでください。

4. 統合して回答する

• 複数ドキュメントの統合：回答の根拠は、単一のページである必要はありません。複数の候補ページに補完的な情報がある場合は、それらを統合して回答してください。
• 根拠に基づく回答の制約：取得して読んだページに記載されていない具体的な数値や推奨事項を、一般知識や検索結果のスニペットに基づいて回答しないでください。
• 出典の引用：最終回答では、参照したすべてのドキュメントのページ URL 全体（例：https://developers.google.com/meridian/docs/pre-modeling/amount-data-needed）を必ず引用してください。実際に取得して読んだページのみを引用してください。docs/...md のようなローカルファイルパスは、Meridian のユーザーには存在しないため、引用しないでください。それぞれの条件への回答に根拠を提供したページを、必ず引用してください。