meridian-doc-consultant

Meridian 文档顾问

此技能指导 Agent 如何查找并查阅正确的 Meridian 官方文档页面，以高效利用 token 回答用户的问题。

文档发布于 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，以查找候选页面。
• 概念交集：如果查询涉及多个概念（例如“先验”+“数据不足”），请查找同时讨论这些概念的页面。
• 关键要求：不要逐个获取页面来寻找合适的页面，因为获取无关页面会浪费 token 和时间。请根据索引中的摘要确定候选页面。

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 获取工具，或者如果只能使用 shell，则运行 curl -sL <url>.md.txt。常规 HTML 页面大多是网站布局，因此优先使用 .md.txt 版本。
• 对于较长的页面，请搜索获取的文本，定位相关章节，而不要通读全文。
• 扩大搜索词范围：如果搜索特定关键词失败（例如“最大渠道数”），请尝试搜索更广泛的相关概念（例如“渠道”），以找到相关章节。
• 搜索建议内容：查找建议时，请搜索“建议”“最佳实践”或“应该”等关键词，并结合主题关键词。
• 处理模糊的限值匹配：如果用户询问“最大值”，而文档说“低于 X”，请提供该数值。
• 优先查阅文档而非代码：回答概念性问题时，优先参考文档页面，而非源代码文件。
• 无法访问网络：如果无法获取页面，请告知用户此技能需要访问 developers.google.com/meridian，提供文档索引中的页面 URL 供其阅读，并且不要将未经核实的细节说成文档中的指导。

4. 综合并作答

• 多文档综合：答案不必依赖单个 页面。如果多个候选页面提供了互补信息，可以综合这些页面来作答。
• 依据约束：如果已获取并阅读的页面中没有具体数字或 建议，请勿依据常识或搜索结果摘要作答。
• 引用来源：在最终回复中，你必须引用 所有已查阅文档的完整页面 URL（例如， https://developers.google.com/meridian/docs/pre-modeling/amount-data-needed）。 只能引用你实际获取并阅读过的页面。不要引用 docs/...md 等本地文件路径； Meridian 用户无法访问这些路径。请确保引用的页面确实提供了针对相应条件的答案。