mcpField
D
deep-research

deep-research

github.com/jordan-gibbs生产力4.2k40 次安装今天更新
代码仓库

关于 deep-research

deep-research 是 hyperresearch 的引导技能，负责检查命令行工具并按 Claude Code 或 OpenAI Codex 分支安装研究流程。它将用户请求交给已安装的流程，而不在此技能中直接开展研究。

主要功能

  1. 01检查 hyperresearch 版本
  2. 02按环境安装研究流程
  3. 03支持 Claude Code 与 OpenAI Codex
  4. 04将请求交给研究入口技能

适用场景

  1. 01为项目配置 hyperresearch 研究流程
  2. 02在 Codex 中安装研究技能与步骤
  3. 03在 Claude Code 中设置研究子代理

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jordan-gibbs/hyperresearch --skill deep-research

安装后在 Claude Code 中输入/deep-research确认已加载。

附带文件agents/openai.yaml

详细介绍

使用 hyperresearch 开展深度研究

此技能是一个引导程序。研究流程本身由一个入口技能、16 个步骤流程和一组子 Agent 组成，hyperresearch Python 包会将它们渲染并安装到项目中。此文件不包含研究流程。请勿在此处尝试运行研究，也不要凭自己的知识回答研究问题：研究流程才是交付内容。

1. 检查 CLI

运行：

hyperresearch --version

如果找不到该命令，请停止并告知用户：

未安装 hyperresearch。请使用 pip install hyperresearch 安装（需要 Python 3.11 到 3.14），然后再次提问。

只有用户提出要求时，你才可以自行运行 pip install hyperresearch。

2. 选择分支

你知道自己是哪种 Agent。请严格遵循其中一个分支。

  • Claude Code（你拥有 Skill 和 Task 工具）：第 3A 节。
  • OpenAI Codex（你使用 apply_patch 编辑文件、生成自定义 Agent，并通过 $name 调用技能）：第 3B 节。

如果确实无法判断，请查看工作目录：如果有 .codex/ 或 .agents/ 目录且没有 .claude/，则为 Codex；反之则为 Claude Code。仍无法确定时，请询问用户使用的是哪一种。

3A. Claude Code

如果工作目录中不存在 .claude/skills/hyperresearch/SKILL.md，请运行：

hyperresearch install . --json

这会创建资料库（.hyperresearch/、research/），在 CLAUDE.md 中添加一段简短说明，并在 .claude/ 下安装入口技能、16 个步骤技能、子 Agent 和一个 PreToolUse hook。可以安全地重复运行；对于已是最新版本的文件，命令不会进行更改。请用一行告诉用户安装了哪些内容。

然后使用用户的研究请求原文调用已安装的路由器：

Skill(skill: "hyperresearch", args: "<the user's research request>")

从此之后，请遵循 hyperresearch 技能。它负责处理查询、选择层级和所有步骤。

如果 hyperresearch 技能尚不可用（Claude Code 会在会话启动时加载新的子 Agent，某些版本对技能也如此），请告知用户设置已完成，并让他们在此目录中重启 Claude Code，然后运行：

/hyperresearch <their research request>

3B. OpenAI Codex

如果工作目录中不存在 .agents/skills/hyperresearch/SKILL.md，请运行：

hyperresearch install . --target codex --json

这会创建资料库（.hyperresearch/、research/），在 AGENTS.md 中添加一段简短说明，并将入口技能安装到 .agents/skills/hyperresearch/，将步骤流程安装到 .hyperresearch/codex/steps/，将自定义 Agent 安装到 .codex/agents/，并在 .codex/hooks.json 中添加 Stop hook。可以安全地重复运行。请用一行告诉用户安装了哪些内容。

如果安装（或之后任何 hyperresearch fetch）因权限或网络错误而失败，则表示会话处于只读沙盒中或离线状态。请停止并告知用户，应在具有可写工作区和网络访问权限的环境中重启 Codex，例如：

codex --sandbox workspace-write -c sandbox_workspace_write.network_access=true

然后移交处理。Codex 会在会话启动时发现技能，因此刚刚安装的技能可能尚未列出。稳妥的做法是直接读取入口技能并遵循其中的说明：

  1. 完整读取 .agents/skills/hyperresearch/SKILL.md（例如 cat .agents/skills/hyperresearch/SKILL.md）。
  2. 将用户的研究请求原文作为查询，并遵循该技能。此流程与 $hyperresearch <request> 加载的流程相同。它负责处理查询、选择层级和所有步骤，并且每个步骤都会告诉你接下来要读取 .hyperresearch/codex/steps/ 下的哪个流程文件。

如果 $hyperresearch 已出现在技能列表中，使用请求调用它即可，效果相同。在后续会话中，用户可以直接使用 $hyperresearch <question> 开始一次运行。

与 Claude Code 相比，有两点不同，入口技能会涵盖这两点：没有浏览器流程（被阻止的 fetch 会保留在队列中，并在最后列给用户）；一旦 Codex 信任项目的 hooks，Stop hook 就不会允许会话在运行处于流程中途时结束。

评论

支持 Markdown