SuperAPI AI 工具集

deep-research

写作与研究

查看项目

更新于 10-26 16:16

技能介绍

用途:作为 hyperresearch 深度研究流水线的引导入口,面向 Claude Code 和 OpenAI Codex 用户。用户提出深度研究、研究报告、文献综述等需求时,由该技能完成环境检查、流水线安装与路由调用。

主要能力:

  • 检查 hyperresearch 命令行工具是否可用(hyperresearch --version)。
  • 识别当前代理环境(Claude Code 或 OpenAI Codex),并走对应安装分支。
  • 安装研究流水线:入口技能、16 个步骤技能/流程、子代理及钩子。
  • 调用已安装的路由器,将用户研究请求原样传入,由流水线负责查询、层级选择及后续各步骤。

使用方式:

  1. 运行 hyperresearch --version;若未找到,告知用户需通过 pip install hyperresearch(Python 3.11 至 3.14)安装,用户同意后才可代其安装。
  2. Claude Code 分支:若工作目录缺少 .claude/skills/hyperresearch/SKILL.md,运行 hyperresearch install . --json,安装后可重复执行且对已是最新的文件无操作;然后以用户请求原文调用 Skill(skill: "hyperresearch", args: "...")。若技能尚未加载,提示用户重启 Claude Code 并运行 /hyperresearch <请求>。
  3. OpenAI Codex 分支:若缺少 .agents/skills/hyperresearch/SKILL.md,运行 hyperresearch install . --target codex --json;随后直接完整阅读 .agents/skills/hyperresearch/SKILL.md,并按其中步骤指引(流程文件位于 .hyperresearch/codex/steps/)执行。若 $hyperresearch 已在技能列表中,直接调用并传入请求。
  4. 安装或后续抓取因权限/网络失败时,说明会话处于只读或离线沙箱,需以可写工作区并开启网络访问重启 Codex,例如 codex --sandbox workspace-write -c sandbox_workspace_write.network_access=true。

适用场景:需要结构化深度研究、生成研究报告或文献综述的任务,且运行环境为 Claude Code 或 OpenAI Codex。

限制:该文件不含研究流水线,不能在此直接运行研究,也不应凭自身知识回答问题。Claude Code 新加载的技能/子代理可能需重启会话才可用。Codex 无浏览器通道,被阻止的抓取会排队并在结束时列出;在 Codex 信任项目钩子后,Stop 钩子会阻止运行未完成时结束会话。