Research 是一个面向单一问题的研究技能，核心目标是从第一手来源获得答案，并留下可追溯的引用文档。
用途 技能处理的问题来自参数 $ARGUMENTS。若参数为空，则采用对话中陈述的问题；若两者都没有，则停止并报告需要把问题作为参数传入（在 Claude Code 中该技能运行于独立子代理，无法看到对话内容）。
运行环境 在安装了插件的 Claude Code 中，正文在 researcher 子代理中运行，完成后把答案返回调用方。在其他 harness 中，若存在子代理则派发给子代理（Codex 使用 spawn_agent，随后用 wait_agent 等待答案；只读的源码扫描用只读代理，需要抓取或写入时用通用代理），否则内联运行并说明。无论哪种方式，工作都必须在当前会话内完成：子代理的任务句柄会在 /clear、会话结束或压缩时失效，因此不要留下运行中的子代理；在工单、解决评论、交接文本等持久内容中，一律用文件路径而非任务 ID 引用发现。
研究简报 调查开始前先创建发现文件：一个 Markdown 文件，包含问题和空的发现列表。保存到仓库已有的此类笔记位置，遵循现有惯例；若没有，默认路径为 .scratch/research/<slug>.md（这是一个收件箱，之后由 scratch-cleanup 归档到 docs/）。这样即使运行中途被切断，发现也会保留。
调查方式 针对第一手来源调查：官方文档、包源码（Composer 的 vendor/，npm 的 node_modules/）、规范、第一方 API，而不是它们的二手转述。每个论断都要回溯到拥有它的来源。在带 Boost 的 Laravel 项目中，框架和包问题优先使用 search-docs MCP 工具而非网页搜索，它返回锁定版本的生态文档。
写入节奏 调查过程中随时追加：每个来源确认一个论断后，就带着引用（URL、文件路径或 package@version）写入文件。不要把发现留到最后一次性写入。
轮次预算 本次运行有硬性轮次上限，达到上限会被终止且没有最终消息。大约 100 轮时停止调查剩余内容：把未完成部分作为未解答记录在文件中，然后完成第 5 和第 6 步。
文件结尾 文件以简短的 What this unblocks 部分结束：用一两行给出答案（或说明哪些仍未解答及原因），以及它使什么变得可决策，不写流水线横幅或技能路由。
回报 用几行给出答案、文件路径和一个 Next 块（见下）。最终消息是给调用方的数据，由调用方把答案和路径转达给用户，而不是重新粘贴文档。
Wayfinder 集成 处理 wayfinder 研究工单时，遵循所配置跟踪器的 Wayfinding 操作。先通过 Claim 操作认领，避免并发会话中途抢占。写入发现文件（不建分支：参见跟踪器的并行工作规则），通过 Assets 操作关联，再用 Resolve 操作记录答案和文件指针并关闭工单。研究工单是 charting 会话可以并行运行多个的唯一类型，全部在会话结束前收集完毕。
Next 块 报告结尾列出适用的条件，最可能的在前（不写流水线横幅：research 是支撑性工作）。调用方据此路由：
- 已解答且某个决策在等它 → 对该决策执行 /grill-me，并指明该决策
- 解答了 wayfinder 工单 → 执行 /wayfinder <map> 获取下一个前沿工单
- 已解答且改变了已发布的规范 → 执行 /to-spec 修订，并指明哪一节现在有误
- 无法从第一手来源解答 → 明确说明；若有人掌握答案则 /to-questionnaire
- 已解答但浮现新未知 → 对新问题执行 /research，以问题形式陈述