用途：当问题跨越多个文件或组件、需要追踪代码理解“X 如何工作”、查找代码库中的模式或示例、理解架构决策或数据流时使用。不适用于简单的“X 在哪里”（应直接用 code-locator）、单文件问题（直接读文件）或仅需外部网络研究（应直接用 web-searcher）。
工作流：0. 可选地先检查过往研究，运行 list-research.py 查看近期研究文档，运行 search-research.py 配合关键词，若存在相关研究则运行 read-research.py 加载，基于已有发现继续。1. 先完整阅读用户提到的文件，为拆解问题提供上下文。2. 将问题拆解为可并行的研究任务，考虑相关代码区域以及需要位置、分析还是示例，参见 agent-selection.md。3. 用 task 工具配合合适的 subagent_type 并发启动多个代理处理独立任务，必须等待全部代理完成后再综合。4. 综合发现并回答：直接答案、关键 file:line 引用、组件间连接、待解问题。5. 可选地询问是否保存为研究文档（项目 .research/ 或全局 ~/.research/），保存时运行 gather-metadata.py 获取日期、仓库、分支、提交、cwd，添加查询与标签，按 output-format.md 写 YAML frontmatter，必要时创建目录，文件名用 {filename_date}_topic-slug.md。
常见错误：未读上下文就启动代理；未等待全部代理完成；对简单答案过度记录；本可并行却串行执行。