Refactoring Python Code With an AI Agent

· Programación

  1. Guía para refactorizar código Python usando un agente de IA. Incluye diagnóstico de code smells, verificación de tests, aplicación de cambios uno a uno, y validación mediante linters (Ruff, mypy) y cobertura de tests.
  2. El flujo requiere 4 pasos: configurar el proyecto con herramientas de calidad (Ruff, mypy, Coverage.py), diagnosticar code smells, verificar que los tests cubran el código (≥85%), y refactorizar de forma iterativa con validación en cada paso.
  3. Se usa Python 3.10+, pytest, Git, uv package manager, y un agente de IA (ej: Claude Code). El proyecto debe tener AGENTS.md con reglas y CLAUDE.md para cargarlas. La rama 'refactor' aísla los cambios de 'main'.
  4. Cada refactorización sigue el ciclo: pedir un cambio por fila del plan, ejecutar quality gate (tests + Ruff + mypy), revisar diff, y commitear si pasa. Los tests no deben cambiar; se detectan cambios no autorizados con 'git status --short tests/'.
  5. El plan identifica 15 tipos de code smells (magic numbers, nested conditionals, duplicated code, etc.) y 7 bugs existentes (ID 0 actúa sobre último elemento, init borra base de datos existente, error handling incompleto). Los bugs se documentan pero se arreglan después.

code quality · refactoring · ai assisted · testing · python

Leer el original

Más en Programación