围绕一个具体问题查阅官方文档、源码或规范，并将带来源的结论写成 Markdown。
安装与准备
在项目目录的终端执行以下命令，安装后在 Claude Code 中输入下方提示。这里选择项目内的可编辑文件安装。
npx skills@latest add mattpocock/skills --skill research --agent claude-code
使用 Codex 时，把安装命令最后的 claude-code 换成 codex，对话里把 /research 换成 $research。如果使用完整的 Claude Code 插件，则选择 /mattpocock-skills:research，不要再重复安装文件版本。
需要可用的网页或源码读取能力，以及支持子任务的 Agent 环境。先确定要做的决定、技术版本和资料保存目录，问题越具体，笔记越容易直接用于开发。
第一次使用
把下面的场景和路径替换成你的项目情况，在 Agent 对话里输入：
/research
我们要为离线笔记应用选择浏览器存储方式。请比较 IndexedDB 与 OPFS 的事务、文件访问和浏览器支持，只读一手资料。结论保存到 docs/research/offline-storage.md。
怎样推进任务
把主题变成待回答的问题
“研究浏览器存储”范围过大。先给出数据形态、离线要求和目标浏览器，例如笔记文本加附件、允许多标签页编辑、需要导出备份。让研究回答这些约束如何影响选择。
让结论跟着一手资料走
Agent 会把阅读工作交给子任务，并追到拥有该事实的资料，例如 API 规范或产品文档。对于兼容性、配额和实验性特性，要求区分已说明的行为与尚待验证的假设；不要把搜索摘要直接写成最终结论。
把笔记接入下一步工作
阅读报告时先看每个问题是否得到回答，再点开影响选择的关键来源。把待验证项转成一个小实验，例如在目标浏览器中保存和读取附件；研究得到的推荐不等于已经替项目运行了实验。
完成后检查什么
文件应包含研究问题、结论、支持链接和未决事项，并写在指定目录。下一位开发者应该能用它理解选择依据，而不必重读整段聊天。
常见问题
报告太泛？ 增加实际约束，并明确需要排除的方案。
能自动追踪以后更新吗？ 这个 Skill 执行一次研究；定期更新需要另外设置流程。
没有子任务能力怎么办？ 可以要求当前 Agent 按相同资料标准完成，但并行阅读取决于宿主能力。
把研究结果变成下一步决定
让研究围绕一个有约束的问题，而不只是收集资料。离线笔记的例子里，应该明确目标浏览器、多标签页写入、附件大小和备份方式；报告按这些条件比较方案，并区分官方已说明的行为与必须在目标环境试验的部分。每条影响选择的结论都应带到原始文档、规范或源码的链接，最后指出建议、未决项和一个可验证的小实验。
这项 Skill 会把查阅工作交给后台任务。启动后确认只出现一项对应的研究任务；若同名任务又派生一项，应停掉重复的，避免两份结论互相覆盖。完成时索要 Markdown 文件的绝对路径并打开检查：如果只有口头总结、没有文件，或随机点开的两条关键结论只通向二手文章，就还不能把它交给开发。短期会变动的兼容性和价格信息，应记录核对日期，不要被当成永久规则。
把研究任务限定到一个产物
开始前先决定要交付什么。只想知道某个 API 参数是否支持时，直接查官方文档并回答就够了；需要比较多份资料、把取舍和出处留给下个会话时，才明确要求 research 生成可复查的笔记。社区有人发现，像“确认某参数”的普通查询也可能触发较重的背景研究流程。你可以在提示里写清研究问题、必须看的来源、产物路径以及什么发现会改变决策，防止一份长报告回答了错误的问题。