用途：该技能用于代码库研究规划阶段，帮助用户针对当前任务整理出一组研究问题（查询计划），交由另一个代理去调研代码库、相关依赖与库。仅在用户明确点名调用此技能时使用。
主要能力：
- 完整读取用户以 @ 提及的工单文件（如 .humanlayer/tasks/<task slug>/ticket.md 或 task.md）及明确提到的附属文件，不读取未被要求的其他产物。
- 记录工单或用户提供的具体上下文指针：链接（URL、文档、Linear/GitHub issue）、仓库、库、依赖、包、文件路径或目录，并原样保留。
- 进行轻量研究以理解任务背景，只使用指定的专用研究代理：codebase-locator（查找任务相关源文件、配置与测试）、codebase-analyzer（追踪数据流与关键函数，返回带 file:line 引用的说明）、codebase-pattern-finder（寻找可参照的相似实现与约定）、web-search-researcher（仅在需要外部 SDK 文档、库用法或最佳实践时使用）；不得使用通用、Explore 或 Plan 等其他代理。代理名称因运行时不同可能带命名空间前缀。
- 生成研究问题清单：只关注现状，即有什么、在哪里、当前实现细节、代码模式与约束、服务与模块的结构及交互、潜在复杂性与边界情况、整体架构与系统设计，以及库与依赖如何融入整体、需要了解的能力或行为。问题应具有指向性（例如指明在某个目录或文档中查找），并符合任务规模。
使用方式：由用户按名称调用后，技能按上述步骤阅读材料、调研并撰写问题。输出前读取研究问题模板与最终回答模板，按模板格式填写 Key Context Pointers 部分（如工单确实未提供则省略）。问题数量通常为 2 至 8 个，最大任务或用户要求可例外。问题必须为描述性、正面表述（“它如何运作”），不得泄露实现细节或任务性质，不得写成“我们该如何实现”。若涉及 UI 或前端改动（即使工单未明确提及），需包含设计系统、组件库、主色与排版、间距、边框、阴影、主题系统等通用问题。文档写入 .humanlayer/tasks/TASKNAME/NN-research-questions-DESCRIPTION.md：先检查任务目录是否存在（如 ls -La .humanlayer/tasks | grep -i "eng-XXXX"），不存在则创建 .humanlayer/tasks/ENG-XXXX-description/；NN 为零填充的时间顺序编号，按目录内已有最大编号递增；DESCRIPTION 为 2-4 个词的 kebab-case 短名。在 .humanlayer/tasks/ 下写入或编辑文档时，钩子响应会自动提供云 permalink，可在最终输出中使用。
适用场景：已有工单或任务说明、需要为后续代码调研代理准备聚焦于现状的问题清单的开发流程。
限制：仅限用户明确点名时使用；只读取被提及的文件；只使用指定研究代理；不生成构建建议、改进建议或关于代码库需要什么的问题；不得将任务性质或实现细节混入问题；模板与输出位置等细节以技能自带参考文件为准。