Навыки Code Review

Навыки Code Review — это переиспользуемые инструкции, которые описывают правила проверки pull request в вашей организации. С их помощью можно проверять совместимость API, безопасность миграций, соблюдение соглашений фреймворка или особо важные участки кода.

Навыки принадлежат организации и настраиваются в панели Review Skills на странице репозиториев Code Review. Для создания, изменения, импорта, включения и удаления навыков требуется право управления настройками Code Review.

Создание навыка

У каждого навыка есть:

• Имя — уникальное имя в пределах организации.
• Описание — краткое назначение правила. Оно хранится отдельно для будущих режимов выбора, но текущий алгоритм не ранжирует навыки по описанию.
• Тело Markdown — инструкции для ревью.
• Шаблоны путей — необязательные регистрозависимые glob-шаблоны, например src/api/** или **/*.sql. Без шаблонов навык подходит для любого ревью. При наличии шаблонов должен совпасть хотя бы один измененный путь.
• Приоритет — число, определяющее порядок подходящих навыков. Чем больше число, тем раньше рассматривается навык; при одинаковом приоритете используется сортировка по имени.

В панели Review Skills выберите Add skill, заполните поля и сохраните навык. Навык, созданный через форму, включен по умолчанию. Переключатель позволяет временно отключить его без удаления.

Импорт и экспорт SKILL.md

Skitflow поддерживает импорт и экспорт формата agent-skills SKILL.md. Файл содержит YAML frontmatter и тело Markdown:

---
name: safe-database-migrations
description: Check database migrations for safe rollout and rollback behavior.
pathGlobs:
  - "**/migrations/**"
  - "**/*.sql"
---

Require backward-compatible schema changes. Flag destructive operations that do
not include an explicit rollout and rollback plan.

Во frontmatter разрешены только name, description и необязательный pathGlobs. Поля name и description обязательны. Приоритет является метаданными библиотеки: после импорта задайте его в форме Skitflow, а не в файле.

Для импорта вставьте полный файл в поле Import SKILL.md и нажмите Import disabled skill. Импортированные навыки всегда создаются выключенными. Проверьте содержимое и фильтры путей, при необходимости задайте приоритет и явно включите навык. Кнопка Export скачивает существующий навык как SKILL.md.

Skitflow также умеет массово импортировать навыки прямо из подключенного репозитория: он сканирует каталог skills/ репозитория и ищет по одному файлу SKILL.md в каждой подпапке (например, skills/safe-database-migrations/SKILL.md), создавая выключенный навык для каждого корректного файла и пропуская некорректные. Массовый импорт требует прав владельца или администратора организации — это более строгое требование, чем право управления настройками, которого достаточно для остальных действий с навыками на этой странице.

Включение и бюджет

В Code Review доступны две наследуемые настройки:

• Review skills (skillsEnabled) включает загрузку подходящих навыков. По умолчанию параметр выключен.
• Maximum skill tokens (maxSkillsTokens) ограничивает весь сформированный блок навыков, включая защитный текст и служебные обрамления. Значение по умолчанию — 4 000 токенов, допустимый диапазон — 0–16 000.

Поля наследуются независимо друг от друга. Незаданное значение — в интерфейсе это Inherit from broader scope — берется с более широкого уровня; изменение одного поля не создает переопределение второго. Бюджет токенов можно задавать только на уровне организации или репозитория. Переопределение репозитория можно очистить, чтобы снова наследовать настройку организации.

Как выбираются навыки

Для каждого ревью Skitflow:

1. Рассматривает только включенные навыки, у которых хотя бы один шаблон совпал с измененным путем, либо навыки без шаблонов.
2. Сортирует их по убыванию приоритета, затем по имени от A до Z.
3. Добавляет навыки целиком, пока сформированный блок помещается в эффективный бюджет токенов.

Если навык не помещается, он пропускается целиком — правила никогда не обрезаются. После пропуска выбор продолжается, поэтому более короткий следующий навык еще может попасть в бюджет. В трассировке политики Code Review указано, какие навыки были переданы модели.

Если включенные навыки не удается загрузить, ревью завершается видимой повторяемой ошибкой контекста, а не продолжается незаметно без правил организации.

Модель доверия и безопасность

Навыки считаются доверенной политикой организации. Их содержимое помещается в доверенный системный prompt ревью, а не в данные pull request или контекст репозитория. Создавать и одобрять навыки должны только администраторы организации или участники с правом управления настройками Code Review.

Навыки содержат только рекомендации для ревью. Они не могут запрашивать инструменты, файлы, переменные окружения, сетевой доступ или побочные действия и не могут изменить контракт структурированного результата. Skitflow хранит навыки в базе данных; репозитории и pull request не могут перенаправить загрузку навыков на файловые или внешние пути.

Импортированный текст может происходить из репозитория или другого недоверенного источника, поэтому он остается неактивным, пока уполномоченный пользователь не проверит и не включит его.