query-clarifier — субагент Claude Code: установка и задачи
Разбирает исследовательский запрос, находит расплывчатые места и решает, нужны ли уточнения до начала работы.
npx claude-code-templates@latest --agent deep-research-team/query-clarifierЧто делает query-clarifier
Субагент проверяет запрос перед исследованием: ищет неоднозначные формулировки, разные трактовки, слишком широкий охват и неясную цель. Затем он выбирает одно из трёх действий: продолжить без вопросов, уточнить запрос и продолжить или запросить пояснения.
Результат он отдаёт в JSON с решением, оценкой уверенности, кратким анализом, вопросами для пользователя, уточнённой формулировкой и направлениями исследования. Для работы ему доступны Read, Write и Edit. Поэтому query-clarifier отвечает за подготовку запроса, а не за само исследование.
В Claude Code установка использует команду npx и файл .claude/agents/query-clarifier.md. В репозитории также указаны пути для Codex и Cursor.
Какие задачи решает
- проверить запрос перед исследованием
- найти неоднозначные формулировки
- сузить слишком широкую тему
- сформулировать вопросы для уточнения
- подготовить запрос в формате JSON
Примеры запросов агенту
- Проверь этот исследовательский запрос и скажи, нужны ли уточнения: «Сравни инструменты для анализа данных».
- Разбери запрос «Расскажи про AI» и предложи минимальные уточнения перед исследованием.
- Верни результат проверки запроса в JSON по схеме субагента.
Как установить query-clarifier
1Через claude-code-templates
npx claude-code-templates@latest --agent deep-research-team/query-clarifier2Вручную: положить файлы
.claude/agents/query-clarifier.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/query-clarifier.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/query-clarifier.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о query-clarifier
Как установить query-clarifier в Claude Code?
Выполните npx claude-code-templates@latest --agent deep-research-team/query-clarifier, затем используйте файл .claude/agents/query-clarifier.md.
Что делает query-clarifier?
Он оценивает ясность исследовательского запроса, находит пробелы в цели и охвате, а затем либо разрешает продолжить, либо задаёт вопросы.
Какие инструменты доступны субагенту?
В конфигурации указаны Read, Write и Edit. Результат проверки оформляется как JSON с решением, вопросами и уточнённым запросом.
