difit

О навыке «difit»

Скилл «difit» запрашивает у пользователя рецензию кода с помощью difit — локального инструмента для просмотра различий — после внесения изменений в код. Это решает проблему включения отзывов о рецензии в рабочий процесс агента: агент запускает difit для выбранного объекта сравнения, пользователь оставляет комментарии к рецензии в пользовательском интерфейсе difit, и эти комментарии выводятся в stdout при завершении работы difit, чтобы агент мог продолжить работу и учесть их. Если сервер завершается без комментариев, агент рассматривает это как отсутствие комментариев к рецензии.

Скилл определяет небольшой набор команд. Он выбирает бинарный файл difit, если тот доступен; в противном случае используется резервный вариант npx difit. Если использование npx в качестве резервного варианта требует доступа к сети в изолированной среде, сначала запрашиваются расширенные права и одобрение пользователя, а не выполняется действие в фоновом режиме. Объектами рецензирования могут быть нефиксированные изменения, коммит HEAD, подготовленные к фиксации изменения, не подготовленные к фиксации изменения, отдельный коммит или сравнение двух коммитов или веток. Дополнительные комментарии при запуске можно прикрепить с помощью опции `--comment` в виде объектов JSON-потока, привязанных к путям файлов и диапазонам строк; это удобно для отображения результатов проверки непосредственно в дифф-файле, а неотслеживаемые файлы можно включить с помощью опции `--include-untracked`. Утилита может использоваться только внутри каталога, управляемого Git.

Целевая аудитория — разработчики, которым нужен этап проверки с участием человека после того, как агент отредактирует код. Этот сكيل ориентирован на безопасность: он содержит явное указание никогда не копировать секретные данные, токены, пароли, ключи API, закрытые ключи или другие материалы, похожие на учетные данные, из диффа в тела комментариев или аргументы командной строки. Его действия ограничиваются запуском локального инструмента рецензирования над диффами Git, что делает его безопасным.

Часто задаваемые вопросы

Как отзыв о проверке доходит до агента?

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

Что произойдет, если difit не установлен?

Скилл использует difit, если команда `command -v difit` завершается успешно; в противном случае используется резервный вариант npx difit. Если этому резервному варианту npx потребуется доступ к сети в песочнице без соответствующих прав, он запрашивает расширенные права и одобрение пользователя перед запуском.

Что я могу просматривать с его помощью?

Незафиксированные изменения, коммит HEAD, подготовленные к фиксации изменения, не подготовленные к фиксации изменения, отдельный коммит или сравнение двух коммитов или веток, при желании включая неотслеживаемые файлы с помощью параметра `--include-untracked`.

Существуют ли какие-либо ограничения на использование?

Да, его можно использовать только внутри каталога, управляемого Git, поскольку он работает с различиями Git.

Как он обрабатывает конфиденциальные данные в диффах?

Он явно запрещает копирование секретов, токенов, паролей, ключей API, закрытых ключей или других данных, подобных учетным данным, из диффа в тела параметров --comment или любые аргументы командной строки.

Все файлы