用途：research-codebase 用于对现有代码库进行客观调研与记录，由一组研究问题驱动，产出可在全新上下文中直接使用的研究文档。它只接收研究问题，不接收工单或任务描述，以避免实现偏见影响发现。
触发方式：/research-codebase [questions-file-or-inline-questions]，例如 /research-codebase 2026-04-14-SP-42-research-questions.md。输入可以是文件路径（通常来自 /generate-questions 的输出）或用户内联提供的问题；若未提供问题则向用户索取。若用户试图提供工单或任务描述，应先引导其使用 /generate-questions。
主要流程：先完整读取问题文件及其中引用的文件；再将问题拆解为并行的纵向研究任务，倾向端到端追踪流程而非罗列横向层次，并派生 Explorer（定位组件）、Tracer（从入口追踪到数据存储）、Pattern（查找代码库中处理类似关注点的既有模式）等子代理；每个子代理提示只包含其专属问题，要求“记录存在的内容，不发表意见、建议或改进”，并给出 file:line 引用与实际代码片段；等待全部子代理完成后综合结果，写入工作目录，文件名为 YYYY-MM-DD-TOPIC-research.md。
输出文档结构：包含已调查问题、摘要（3-5 条要点）、详细发现（含 file:line 引用）、发现的模式（含真实代码片段与使用方）、数据流（端到端追踪）、未决问题（仅凭代码无法确定的事项）。
规则与限制：只记录现状而非应然，不写实现意见，出现“should”“could be improved”“consider”等表述应删除；模式必须附真实代码片段与 file:line，不得虚构示例；输出须自包含，可在无先前对话的新上下文中使用；纵向优先于横向；总指令数保持在 40 条以内。资料未提供收费、价格、平台支持范围等信息。