# profile-resolver

profile-resolver — субагент Claude Code, который читает дифф и рабочее дерево, определяет активные профили проекта и чек-листы для загрузки. Включается отдельно от проверки диффа для определения профилей и чек-листов.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 155 у репозитория
- Автор: serpro69
- Лицензия: Elastic-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/serpro69/claude-toolbox/tree/HEAD/klaude-plugin/agents/profile-resolver.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/profile-resolver

## Что делает

На вход агенту дают три вещи: текст диффа, корень рабочего дерева и абсолютный путь к установленному плагину. Дальше он открывает общую процедуру определения профилей, для каждого известного профиля читает `DETECTION.md` и применяет правило из трёх шагов: сигналы в пути, в имени файла, в содержимом. Инструменты только на чтение — `Read`, `Grep`, `Glob`.

На выходе — таблица, где для каждого файла диффа стоит профиль и конкретный сигнал `triggered_by`, плюс два списка: чек-листы, которые грузятся, и те, что нет, с причиной по условию Load-if. Файл без совпадений всё равно попадает в таблицу со значением `none`.

Корень плагина передают заголовком `## Plugin Root`, потому что шелла у агента нет и `${TOOLBOX_PLUGIN_ROOT}` он раскрыть не может. Заголовка нет — агент останавливается с ошибкой, а не угадывает путь. Сам код он не ревьюит и замечаний не пишет: это работа `kk:code-reviewer`. Сейчас чек-листы собираются только для фазы `/kk:review-code`.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add serpro69/claude-toolbox
```
В чате агента (не в терминале):
```text
/plugin install kk@claude-toolbox
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/profile-resolver.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/profile-resolver.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/profile-resolver.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/serpro69/claude-toolbox/tree/HEAD/klaude-plugin/agents/profile-resolver.md

## Когда брать
- отвязать определение профилей от самого код-ревью
- увидеть, по какому сигналу профиль сработал для конкретного файла
- получить список чек-листов, которые не загрузились, с причиной
- прогнать детекцию отдельно, чтобы оценить её качество
- не тащить файлы процедуры в контекст основной сессии

## Примеры запросов агенту
- Определи активные профили для этого диффа и покажи, какие чек-листы загрузились, а какие нет.
- Прогони `profile-resolver` на проиндексированном диффе: только детекция профилей, без замечаний по коду.
- Собери отчёт детекции для `Chart.yaml` и `values.yaml`, корень рабочего дерева передам следом.

## Похожие
- [qodo-review-resolver](https://affpapa.org/nevibecode/skills/qodo-review-resolver.md) — скилл · 103 установки
- [pr-comment-resolver](https://affpapa.org/nevibecode/agents/pr-comment-resolver.md) — субагент · ★ 1216 у репозитория
- [caveman-review](https://affpapa.org/nevibecode/skills/caveman-review.md) — скилл · 437600 установок
- [understand-diff](https://affpapa.org/nevibecode/skills/understand-diff.md) — скилл · 4200 установок
- [hunk-review](https://affpapa.org/nevibecode/skills/hunk-review.md) — скилл · 2700 установок
- [difit-review](https://affpapa.org/nevibecode/skills/difit-review.md) — скилл · 2000 установок

Из того же набора: [serpro69/claude-toolbox](https://affpapa.org/nevibecode/by/serpro69/claude-toolbox.md) — 30 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
