profile-resolver — субагент для Claude Code
profile-resolver — субагент Claude Code, который читает дифф и рабочее дерево, определяет активные профили проекта и чек-листы для загрузки. Включается отдельно от проверки диффа для определения профилей и чек-листов.
Elastic-2.0 ★ 155 обновлён 2026-10-29
/plugin marketplace add serpro69/claude-toolbox
/plugin install kk@claude-toolboxЧто делает profile-resolver
На вход агенту дают три вещи: текст диффа, корень рабочего дерева и абсолютный путь к установленному плагину. Дальше он открывает общую процедуру определения профилей, для каждого известного профиля читает DETECTION.md и применяет правило из трёх шагов: сигналы в пути, в имени файла, в содержимом. Инструменты только на чтение — Read, Grep, Glob.
На выходе — таблица, где для каждого файла диффа стоит профиль и конкретный сигнал triggered_by, плюс два списка: чек-листы, которые грузятся, и те, что нет, с причиной по условию Load-if. Файл без совпадений всё равно попадает в таблицу со значением none.
Корень плагина передают заголовком ## Plugin Root, потому что шелла у агента нет и ${TOOLBOX_PLUGIN_ROOT} он раскрыть не может. Заголовка нет — агент останавливается с ошибкой, а не угадывает путь. Сам код он не ревьюит и замечаний не пишет: это работа kk:code-reviewer. Сейчас чек-листы собираются только для фазы /kk:review-code.
Какие задачи решает
- отвязать определение профилей от самого код-ревью
- увидеть, по какому сигналу профиль сработал для конкретного файла
- получить список чек-листов, которые не загрузились, с причиной
- прогнать детекцию отдельно, чтобы оценить её качество
- не тащить файлы процедуры в контекст основной сессии
Примеры запросов агенту
- Определи активные профили для этого диффа и покажи, какие чек-листы загрузились, а какие нет.
- Прогони
profile-resolverна проиндексированном диффе: только детекция профилей, без замечаний по коду. - Собери отчёт детекции для
Chart.yamlиvalues.yaml, корень рабочего дерева передам следом.
Как установить profile-resolver
1Через маркетплейс плагинов
/plugin marketplace add serpro69/claude-toolbox/plugin install kk@claude-toolbox2Вручную: положить файлы
.claude/agents/profile-resolver.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/profile-resolver.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/profile-resolver.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о profile-resolver
Как установить profile-resolver в Claude Code?
Сначала /plugin marketplace add serpro69/claude-toolbox, потом /plugin install kk@claude-toolbox. Файл агента окажется по пути .claude/agents/profile-resolver.md.
Что делает profile-resolver?
Определяет активные профили для переданного диффа и решает, какие их чек-листы грузить. Возвращает структурированный отчёт: таблицу с сигналом по каждому файлу и два списка чек-листов с обоснованием.
Что нужно передать агенту для работы?
Дифф, корень рабочего дерева и абсолютный путь к плагину под заголовком ## Plugin Root. Без последнего агент останавливается с ошибкой: шелла у него нет, переменные окружения он не раскрывает.