deep-research

hyperresearch による詳細な調査

このスキルはブートストラップです。調査パイプライン自体は、エントリースキルと 16 個のステップ手順、および複数のサブエージェントで構成されており、 hyperresearch Python パッケージがそれらをプロジェクトに生成してインストールします。このファイルにパイプラインは含まれていません。ここから調査を実行しないでください。また、自分の知識で調査の質問に答えないでください。成果物はパイプラインです。

1. CLI を確認する

次を実行します。

hyperresearch --version

コマンドが見つからない場合は、そこで中止し、次のようにユーザーに伝えます。

hyperresearch はインストールされていません。pip install hyperresearch （Python 3.11 から 3.14）でインストールしてから、もう一度依頼してください。

ユーザーから指示があった場合に限り、自分で pip install hyperresearch を実行してもかまいません。

2. 分岐を選ぶ

自分がどのエージェントなのかを把握しています。分岐を 1 つだけ選び、指示に従ってください。

• Claude Code（Skill と Task ツールを使用できる場合）：セクション 3A。
• OpenAI Codex（apply_patch でファイルを編集し、カスタムエージェントを起動し、スキルを $name で呼び出す場合）：セクション 3B。

本当に判断できない場合は、作業ディレクトリを確認してください。.codex/ または .agents/ ディレクトリがあり、.claude/ がなければ Codex です。その逆なら Claude Code です。それでも判断できない場合は、どちらを使用しているかユーザーに尋ねてください。

3A. Claude Code

作業ディレクトリに .claude/skills/hyperresearch/SKILL.md がない場合は、次を実行します。

hyperresearch install . --json

これにより、ボルト（.hyperresearch/、research/）を作成し、CLAUDE.md に短いブロックを追加して、エントリースキル、16 個のステップスキル、サブエージェント、および .claude/ 配下の PreToolUse フックをインストールします。再実行しても安全です。最新の状態にあるファイルには変更を加えません。インストールした内容を 1 行でユーザーに伝えてください。

次に、インストール済みのルーターをユーザーの調査依頼と完全に同じ文面で呼び出します。

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

以降は hyperresearch スキルに従います。検索内容、ティアの選択、およびすべてのステップは、このスキルが管理します。

hyperresearch スキルがまだ利用できない場合（Claude Code は新しいサブエージェントをセッション開始時に読み込み、一部のバージョンではスキルも同様に読み込むため）、セットアップが完了したことをユーザーに伝え、このディレクトリで 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/ に、カスタムエージェントを .codex/agents/ に、Stop フックを .codex/hooks.json にインストールします。再実行しても安全です。インストールした内容を 1 行でユーザーに伝えてください。

インストール（または後の 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 と異なる点が 2 つあります。エントリースキルにはどちらも記載されています。ブラウザーを使う経路はなく、取得に失敗した項目はキューに残り、最後にユーザーに一覧表示されます。また、プロジェクトのフックを Codex が信頼すると、実行中のパイプラインがある間は Stop フックによってセッションの終了が阻止されます。