create-research 是一个“研究代码库”技能，仅在用户显式点名调用时使用。
用途：围绕用户提出的研究问题，对现有代码库做全面调研并综合各子代理的发现。核心约束是：只记录和解释代码库当前的样子，不主动提出改进或变更建议、不做根因分析、不提议未来增强、不评判实现或指出问题、不建议重构优化或架构调整，除非用户明确要求。
主要能力：先检查任务产物目录中的 research-questions.md 文档（用 ls -La，该目录可能是符号链接）。找到一个就以其中内容作为研究问题；找到多个则先询问用户选择；无法从系统提示确定目录时，提示用户直接提供研究问题。收到问题后，先完整读取用户直接提及的文件（不使用 limit/offset），再拆解为可组合的研究方向并制定计划。
研究方式：派生多个并行的 Task 子代理，只用专门的代码库研究代理——codebase-locator 定位文件与组件位置、codebase-analyzer 理解具体代码如何工作、codebase-pattern-finder 查找既有模式；如适用可用 web-search-researcher 做外部资料与依赖库研究；若存在 humanlayer 库研究工具则用于依赖库问题。建议合并相关问题，控制在 2-6 个范围明确的子代理。等待全部完成后汇总，以实时代码库发现为准，连接跨组件发现，标注具体文件路径与行号。
产出：生成 .humanlayer/tasks/TASKNAME/NN-research-DESCRIPTION.md 文档，NN 为补零的时序序号，DESCRIPTION 为 2-4 个词的 kebab-case 短名；文档按“讲代码库的故事”风格撰写，标题表达要点而非主题，配合表格、Mermaid 图、调用树、文件树、签名与伪代码，并附尽量完整的代码引用清单与测试模式说明。写入后如有开放问题可再做最多一轮针对性研究并就地更新文档。写入产物会自动提供云永久链接，可加入最终输出；同步仓库中可按 gh repo view --json owner,name 生成 GitHub 永久链接。最终按指定模板回复，并在模板相应位置说明开放问题数量。
限制：不得读取 ticket.md/task.md 等不匹配 research-questions 模式的产物文件，除非用户明确要求；不得使用通用、Explore 或 Plan 等其他代理类型；代理名称因运行时不同而异，需使用可用代理列表中的确切名称。资料暂未提供技能具体安装命令、价格或平台限制等信息。