# python-refactor-expert

Субагент python-refactor-expert для Claude Code переписывает Python-код без изменения логики: наводит порядок в архитектуре, выносит настройки и внедряет тайпхинты. Пригодится после реализации новых фич.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 372 у репозитория
- Автор: Giuseppe Trisciuoglio
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-python/agents/python-refactor-expert.md
- Обновлён: 2026-09-10
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/python-refactor-expert

## Что делает

Субагент анализирует кодовую базу на предмет запахов кода и перерабатывает логику небольшими шагами, проверяя результат тестами. Первым делом он заглядывает в `CLAUDE.md` или `pyproject.toml`, поэтому проектные правила всегда имеют приоритет над общими шаблонами. Для работы ему выделена модель `sonnet` и системные инструменты: чтение, запись и редактирование файлов, поиск через `Glob` и `Grep`, а также вызовы терминала `Bash`.

В работе агент опирается на принципы SOLID и чистую архитектуру. Он преобразует глубокие вложенные условия в защитные проверки с ранним возвратом, разбивает громоздкие функции на короткие хелперы и выносит скрытые константы в конфиги на базе Pydantic Settings.

В веб-сервисах на FastAPI субагент переводит прямое создание зависимостей на `Depends`, а жёсткие связи между сервисами заменяет протоколами через `typing.Protocol`. Если в проекте нет тестов, верифицировать безопасность правок субагенту не удастся.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
```
В чате агента (не в терминале):
```text
/plugin install developer-kit-python@developer-kit
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-python/agents/python-refactor-expert.md

## Когда брать
- развернуть вложенные ветвления в защитные проверки с ранним возвратом
- вынести скрытые константы и параметры в Pydantic Settings
- заменить прямое создание сервисов на внедрение зависимостей через `Depends`
- изолировать слои бизнес-логики с помощью `typing.Protocol`
- разбить монолитную структуру каталогов на модули по фичам

## Примеры запросов агенту
- Проверь `services/orders.py` и отрефактори вычисление скидок с помощью ранних возвратов.
- Переведи инициализацию репозиториев в роутере `api/v1/users.py` на FastAPI `Depends`.
- Разбей функцию расчёта доставки на короткие хелперы и покрой её типами по PEP 8.

## Похожие
- [ruby-refactor](https://affpapa.org/nevibecode/skills/ruby-refactor.md) — скилл · 307 установок
- [solid](https://affpapa.org/nevibecode/skills/solid.md) — скилл · 3700 установок
- [clean-code](https://affpapa.org/nevibecode/prompts/clean-code.md) — промпт · ★ 788 у репозитория
- [python-clean-architecture](https://affpapa.org/nevibecode/plugins/python-clean-architecture.md) — плагин · ★ 11 у репозитория
- [software-design-principles](https://affpapa.org/nevibecode/skills/software-design-principles.md) — скилл · ★ 38 у репозитория
- [clean-code-guard](https://affpapa.org/nevibecode/skills/clean-code-guard.md) — скилл · 4900 установок

Из того же набора: [giuseppe-trisciuoglio/developer-kit](https://affpapa.org/nevibecode/by/giuseppe-trisciuoglio/developer-kit.md) — 191 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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