用途：回答两个问题——当前来源中的推荐做法是什么，以及围绕它的坑点与陷阱有哪些。缺少坑点的操作指南只是半个答案。适用于选型、配置、优化工具/库/配置格式/API 模式/项目设置，或在提出自己的设计前。
主要能力与规则：采用两阶段规则。第一阶段为调研，派发 find-docs 和/或网络搜索查询（Claude Code 用 WebSearch，Codex 用 web_search）。第二阶段为综合与行动，只在第一阶段结果返回后开始。用户指令即使是祈使句（如“优化 X”“搭建 Y”）也决定第二阶段做什么，而不决定是否执行第一阶段——第一阶段始终运行。
使用方式：把主题拆成 2-4 个具体查询，至少一个查询专用于坑点（如“X 常见错误”“X 生产环境陷阱”），因为坑点存在于 issue、迁移指南和事后复盘中，而非入门文档。涉及设计先例时，查询现有开源项目的实现方式。单一库查询可直接调用 find-docs 或网络搜索，无需子代理。在单条消息中为每个查询派发一个子代理，每个 Agent 调用传 model: sonnet；要求子代理使用 find-docs 与网络搜索，并在 400 词内报告推荐做法、具体代码/配置示例，以及发现的每个坑点及其后果（含细微或不确定项），每条主张标注来源与发布日期。最后呈现推荐做法、关键模式与覆盖每条建议的坑点，每条主张保留来源引用。
限制：官方文本未提供，具体模型与搜索工具依赖运行环境。