Refurb CLI
Refurb анализирует Python-код и предлагает точечные улучшения с кодами правил, пояснениями и учетом целевой версии языка.
- 2 535 ★ репозитория
- Последний коммит
- GPL-3.0
Расширенный доступ
Почему такой уровень
- Анализатор читает исходники и конфигурацию проекта; предложенные изменения нужно проверять отдельно.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/refurbОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Анализатор читает исходники и конфигурацию проекта; предложенные изменения нужно проверять отдельно.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Refurb ищет в Python-коде выражения, которые можно упростить или заменить современными приемами языка. Для каждого замечания он показывает файл, позицию и код проверки. Автор может запросить подробное объяснение с примерами, прежде чем менять реализацию. Правила можно выбирать по коду и категории, отключать для строки или настраивать для проекта. Целевая версия Python помогает ограничить предлагаемые возможности языка. Агент получает список небольших правок, которые удобно обсуждать и проверять тестами по отдельности.
Для кого. Мейнтейнерам Python-проектов, которые обновляют старый код небольшими проверяемыми изменениями.
Подходит, если
- После обновления Python нужно найти устаревшие приемы в существующем коде.
- Повторяющиеся выражения хочется упростить по конкретным правилам.
- Команда хочет разобрать рекомендацию анализатора перед изменением поведения.
- CI должен выдавать замечания в формате аннотаций GitHub.
Не подходит, если
- Требуется доказать функциональную корректность приложения без тестов.
- Рекомендации планируют применять массово без учета версии языка и контекста.
- Основная задача состоит в проверке архитектурных границ между модулями.
Пример запроса к агенту
Проверь этот Python-пакет через Refurb для версии 3.10. Объясни три рекомендации и предложи отдельные правки без автоматического применения.Ограничения
Сам Refurb требует Python 3.10 или новее, хотя умеет проверять код для версии 3.7 и выше через отдельный параметр. Если целевая версия не задана, используется версия локального интерпретатора, что может дать неподходящие советы для CI. Часть проверок отключена по умолчанию, поэтому охват зависит от конфигурации. Игнорирование строки скрывает замечания и требует осмысленного выбора, особенно если общий noqa подавляет все проверки этой строки.
Как отключить. Уберите Refurb из CI или pre-commit и удалите пакет из окружения. Уже принятые правки кода останутся в проекте.
Частые вопросы
Как узнать смысл кода проверки?
Используйте `refurb --explain FURB123` с нужным кодом. Сопоставьте примеры со своим участком.
Можно ли проверить код для старого Python?
Да. Задайте `--python-version` в формате x.y. Сам анализатор все равно запускается на поддерживаемом новом интерпретаторе.
Как узнать активные проверки?
Добавьте `--verbose`. Просмотрите список до оценки полноты отчета.
Можно ли отключить одно правило?
Да. Есть `--ignore` и точечный комментарий noqa с кодом. Предпочитайте узкое исключение с понятной причиной.
Как вывести аннотации GitHub?
Укажите `--format github`. Проверьте, что вывод обрабатывается вашим заданием CI.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI и плагин для ревью кода агентом: читает git diff и пишет замечания по строкам с учетом контекста
Локальный индекс кодовой базы с десятью MCP-инструментами: граф зависимостей, история git, здоровье кода и архитектурные решения без повторного grep на каждом ш
Simplify Codebase
simplify-codebase
Скилл «сначала докажи, потом удаляй»: поиск случайной сложности в коде и безопасное удаление без поломок. README на китайском
Ревью кода с опорой на классические книги по инженерии: находки со ссылками на источник, уровнем серьезности и несколькими режимами разбора
CLI открывает правки и документы в терминале, чтобы человек оставил замечания к строкам и передал их кодовому агенту
Методы для агента в одном CLI: сравнение вариантов, разбор проблем и правки кода по шагам, всего 20 слэш-команд.
Коротко о README
Конфигурация поддерживает выбор проверок по категориям и сортировку замечаний. Для расширенных случаев можно передавать параметры используемому Mypy.