Скил requesting-code-review — ревьюер без истории разговора
Скил requesting-code-review в Datarim создаёт изолированного агента-ревьюера, который видит только diff и требования — без хода мыслей автора. Именно в этой изоляции и смысл.
Агент, проверяющий собственную работу, несёт все допущения, которые повлияли на реализацию. Скил requesting-code-review решает это, создавая отдельного агента-ревьюера с точно ограниченным контекстом: diff, требования — и больше ничего из авторской сессии.
Основной принцип скила прямой: проверяй рано, проверяй часто. Ревьюер получает диапазон SHA (BASE_SHA до HEAD_SHA), краткое описание того, что было создано, и ссылку на план или требования. История разговора, тупиковые попытки и рассуждения, приведшие к принятым решениям, ревьюеру не передаются.
Когда запрашивать проверку
Три момента обязательны: после каждой задачи при разработке с субагентами, после завершения крупной функции и перед слиянием в основную ветку. Скил также перечисляет необязательные поводы — когда зашёл в тупик, перед рефакторингом как исходная проверка, после исправления сложной ошибки. Обязательный список существует из-за накопления: проблема, обнаруженная на задаче 2, стоит одного исправления; та же проблема, найденная на задаче 7, потребует рефакторинга всего, что было построено поверх неё.
Как создаётся ревьюер
Скил использует файл шаблона requesting-code-review/code-reviewer.md с четырьмя заполнителями: описание, ссылка на план или требования, базовый SHA и конечный SHA. Всё, что среда выполнения предоставляет для создания изолированного агента, получает этот шаблон как единственный входной контекст — без истории разговора.
Обратная связь возвращается в трёх категориях. Критические проблемы исправляются немедленно. Важные проблемы исправляются до перехода к следующей задаче. Незначительные откладываются. Скил явно указывает одно: если ревьюер ошибается — возражай с техническим обоснованием. Ревьюер, которому нельзя возразить, бесполезен.
Запасной вариант, когда изоляция невозможна
Не каждая среда выполнения может создать по-настоящему изолированного агента. Скил даёт два запасных варианта. Второй по качеству — новая сессия того же оператора только с шаблоном ревьюера и git diff, без предыдущего разговора. Третий — самопроверка по тому же чеклисту. На каждом шаге качество снижается, но структура всё равно находит значительную долю проблем.
Антипаттерн, который скил предотвращает
Пропустить проверку, потому что изменение кажется простым, — это конкретный сбой, который называет скил. Задача ревьюера — не сомневаться в очевидном, а ловить неочевидное. Именно в простых на вид изменениях оно и прячется.
Общую архитектуру агентов описывает пост что такое Datarim. О том, как находки при проверке превращаются в долгосрочные улучшения фреймворка, рассказывает статья о скиле reflecting.