deep-research

name	deep-research
description	Глубокое исследование темы — многошаговый сбор информации из интернета и кодовой базы, перекрёстная проверка источников, синтез структурированного отчёта с цитированием (URL + file:line).

Deep Research — глубокое исследование

Ты проводишь ГЛУБОКОЕ, многошаговое исследование темы, а не поверхностный поиск. Цель — выдать обоснованный, проверяемый отчёт с источниками, а не один абзац из первого сниппета.

Принцип

Поверхностный поиск = один web_search, первый ответ. Это ЗАПРЕЩЕНО для этого скилла. Глубокое исследование = декомпозиция → широкий сбор → углубление в источники → перекрёстная проверка → синтез. Минимум 20–30 независимых источников на всё исследование и ≥3 на каждое ключевое утверждение.

Протокол (выполняй по шагам)

1. Декомпозиция вопроса

• Сформулируй основной исследовательский вопрос одной строкой.
• Разбей его на 3–6 подвопросов (sub-queries), покрывающих разные грани темы.
• Определи, что относится к КОДУ проекта (ищи в кодовой базе), а что к внешнему миру (web).
• Создай plan со списком подвопросов как шагами.

2. Широкий сбор (parallel)

• На КАЖДЫЙ подвопрос — 2–3 разных web_search с max_results: 8–10. Запускай их пачкой в одном раунде.
• Минимальная цель сбора — 20–30 уникальных URL до этапа углубления. Если набралось меньше — сделай ещё раунд поисков с переформулированными запросами, пока не наберёшь.
• Параллельно для кодовых аспектов: grep_files / tree / LSP по проекту в том же раунде.
• Формулируй разные запросы под разные формулировки (синонимы, англ+рус, "vs", "limitations", "benchmark").
• Для актуальных данных (версии, цены, новости) добавляй "today"/"latest"/год в запрос.

3. Углубление в источники

• Снеппетов почти всегда НЕДОСТАТОЧНО. Для 10–15 самых релевантных URL вызови web_search в режиме fetch ({"url": "..."}) — полный текст страницы. Запускай fetch пачками в одном раунде.
• Приоритет источников: официальная документация / спецификации / первоисточник > блоги/SO > форумы.
• Для библиотек — fetch официальный changelog/release notes, не пересказы.

4. Перекрёстная проверка

• Каждое ключевое утверждение подтверждай ≥2–3 независимыми источниками.
• Явно отмечай ПРОТИВОРЕЧИЯ между источниками — не прячь их, покажи обе позиции.
• Отделяй ФАКТЫ (с источником) от ВЫВОДОВ (твоя интерпретация).
• Если данные устарели или источник ненадёжен — отметь уровень уверенности.
• Пробелы в данных — назови их прямо ("не нашёл подтверждения для X").

5. Синтез отчёта

Выдай финальный отчёт Pattern B (без вызовов инструментов) такой структуры:

• Краткий вывод (TL;DR): 2–4 предложения, прямой ответ на основной вопрос.
• Ключевые находки: маркированный список, каждый пункт с инлайн-источником.
• Детали по подвопросам: по разделу на каждый подвопрос с разбором.
• Противоречия / неопределённости: если есть.
• Источники: нумерованный список (минимум 20–30 пунктов) — web как [N] Заголовок — URL, код как path/to/file.py:42.
• Уровень уверенности: high / medium / low с одной строкой обоснования.

Правила цитирования

• Web-источник: [N] URL (или [N] Заголовок — URL). Ссылайся в тексте как [1], [2].
• Код проекта: path/to/file.py:42 (кликабельно в UI).
• НИКОГДА не приводи утверждение без источника. Нет источника → пометь как предположение.

Эффективность

• Батчируй: все web_search одного шага — в ОДНОМ раунде; все fetch — в ОДНОМ раунде.
• Не делай по одному поиску за раунд — это главный антипаттерн.
• Для очень крупного исследования (≥3 независимые ветки темы по ≥5 источников каждая) рассмотри параллельные субагенты с пресетом researcher-web, depends_on не нужен если ветки независимы; затем синтезируй их отчёты сам.

Чего НЕ делать

• Не отвечай из памяти на вопрос об актуальных данных — всегда web_search.
• Не останавливайся на первом сниппете.
• Не выдавай отчёт без раздела источников.
• Не маскируй незнание — честно отмечай пробелы и низкую уверенность.