用途:帮助 AI 助手在不扫描整个仓库的前提下,快速了解一个研究项目。它读取由 research-context-compressor 生成的 .research/ 清单文件,产出一份对话内的项目导览备忘,属于 research-hub 技能包,可与 Zotero、Obsidian、NotebookLM 工作流并用但不依赖它们。
主要能力:只读、快速;按顺序读取 .research/project_manifest.yml(必需)、experiment_matrix.yml、data_dictionary.yml、decisions.md(最近5条)、open_questions.md(全部)、run_log.md(最近3条)。输出结构固定:项目名、研究问题、阶段与更新时间、数据集、按状态分组的实验、入口点、近期决策、待解问题、证据产物、建议下一步。
触发场景:例如“先了解这个研究项目再帮我”“总结该仓库的研究问题、数据、实验与产出”“为论文/项目建立上下文地图”“帮我熟悉这个代码库”“这个仓库是讲什么的”。不适用于:详细代码审查、生成新清单(需先用 research-context-compressor)、文献综述(用 literature-triage-matrix)。
使用方式:在项目根目录存在 .research/ 时直接调用。若不存在,应询问用户:先创建清单(加载 research-context-compressor,约30秒,写3个小 YAML 文件),或退化为直接扫描仓库(更慢、更耗 token);不得自动退化。用户选择扫描时,读 README.md、docs/ 与顶层入口生成备忘,并说明该导览来自一次性扫描,建议后续运行 research-context-compressor。
限制:不读源代码、数据文件或 PDF,除非清单指向具体路径且用户问题确需;若在 .research/ 外读取超过5个文件应停止并提示清单不完整;不总结稿件、不比较论文、不提代码改动建议;不得编造缺失字段,若研究问题为空应提示补充到 .research/project_manifest.yml。长度约200-400 token,不要填充。