Prompts Maestros logo
Prompts Herramientas Agentes

Prompt: Refactorizar Código Aplicando Buenas Prácticas

Revisa y mejora un fragmento de código en el lenguaje que elijas, aplicando buenas prácticas, limpieza estructural y mayor legibilidad.

Este prompt está pensado para revisar y mejorar fragmentos de código aplicando buenas prácticas, nombres claros y estructuras más mantenibles. La versión gratuita ofrece una revisión básica con una versión ligeramente mejorada del código.

La versión extendida profundiza en la refactorización, explica las decisiones de diseño y proporciona una checklist de buenas prácticas para ayudarte a consolidar hábitos de código limpio y profesional.

Actúa como un desarrollador senior. Revisa el siguiente código en [LENGUAJE] para aplicar buenas prácticas y crea una versión corregida y mejorada del código. # INFORMACIÓN DEL USUARIO: - Lenguaje de programación: [LENGUAJE] - Fragmento de código actual: [CODIGO] - Objetivo o comportamiento esperado: [OBJETIVO] Devuelve: 1. Breve explicación de qué hace el código. 2. Lista de mejoras recomendadas (legibilidad, nombres, estructura básica). 3. Una versión corregida y algo más limpia del mismo código.
# CONTEXTO: Eres un ingeniero de software senior especializado en clean code, refactorización y revisión de código en equipos profesionales. Tu misión es revisar el siguiente fragmento de código, detectar oportunidades de mejora y entregar una versión corregida y mejor estructurada. # INFORMACIÓN DEL USUARIO: - Lenguaje de programación: [LENGUAJE] - Fragmento de código completo: [CODIGO] - Entorno o framework principal: [ENTORNO] - Objetivo funcional del código: [OBJETIVO] - Enfoque principal de mejora (legibilidad, rendimiento, mantenibilidad): [ENFOQUE_PRINCIPAL] # BLOQUES DE RESPUESTA: ## 1. Diagnóstico General del Código Explica brevemente qué hace el código, qué tan legible es y cuáles son los problemas más relevantes (nombres, duplicidad, acoplamiento, comentarios, etc.). ## 2. Lista de Mejoras y Buenas Prácticas Enumera recomendaciones concretas organizadas por categoría (nomenclatura, estructura, manejo de errores, rendimiento básico). Indica el impacto de cada mejora. ## 3. Versión Corregida y Refactorizada Presenta una versión mejorada del código, siguiendo buenas prácticas del lenguaje indicado. Mantén el mismo comportamiento, pero con estructura más clara y mantenible. ## 4. Explicación de Decisiones de Diseño Describe por qué se hicieron ciertos cambios (extracción de funciones, renombrado de variables, simplificación de condiciones, etc.) y cómo eso ayuda a mantener el código a largo plazo. ## 5. Checklist de Buenas Prácticas Aplicadas Incluye una lista breve de puntos verificados (nombres claros, funciones cortas, manejo de errores, comentarios útiles, etc.) marcada según se cumpla en la nueva versión. # CRITERIOS DE CALIDAD: - Mantener el comportamiento funcional original del código. - Evitar introducir dependencias innecesarias o patrones excesivamente complejos. - Priorizar claridad, mantenibilidad y coherencia con el estilo del lenguaje. - Explicar los cambios de forma que un desarrollador intermedio pueda aprender del proceso.
# CONTEXTO: Eres un ingeniero de software en clean code, refactorización y revisión de código en equipos profesionales. . # INFORMACIÓN DEL USUARIO: - Lenguaje de programación: [LENGUAJE] - Fragmento de código completo: [CODIGO] - Entorno o framework principal: [ENTORNO] - Objetivo funcional del código: [OBJETIVO] - Enfoque principal de mejora (legibilidad, rendimiento, mantenibilidad): [ENFOQUE_PRINCIPAL] # BLOQUES DE RESPUESTA: ## 1. Diagnóstico General del Código ## 2. Lista de Mejoras y Buenas Prácticas ## 3. Versión Corregida y Refactorizada ## 4. Explicación de Decisiones de Diseño ## 5. Checklist de Buenas Prácticas Aplicadas # CRITERIOS DE CALIDAD: - Mantener el comportamiento funcional original del código. - Evitar introducir dependencias innecesarias o patrones excesivamente complejos.
Este prompt pertenece a la categoría de Programación y Código

¿Qué hace el prompt?

Versión Básica

  • Analiza un fragmento de código en el lenguaje indicado y explica su propósito general.
  • Detecta problemas básicos de estilo, legibilidad y organización.
  • Propone una versión corregida y ligeramente mejorada del código.
  • Ofrece recomendaciones simples de buenas prácticas para el caso concreto.

Versión Extendida

  • Analiza un fragmento de código en el lenguaje indicado y explica su propósito general.
  • Detecta problemas básicos de estilo, legibilidad y organización.
  • Propone una versión corregida y ligeramente mejorada del código.
  • Ofrece recomendaciones simples de buenas prácticas para el caso concreto.
  • Analiza el código a nivel de estructura, responsabilidades y flujo de datos.
  • Aplica principios de clean code (nombres claros, funciones pequeñas, separación de responsabilidades).
  • Propone una versión refactorizada y comentada del código.
  • Incluye observaciones sobre complejidad, posibles bugs y puntos de extensión futura.
  • Entrega una checklist de buenas prácticas aplicada al fragmento analizado.

Versión Eficiente

  • Analiza el código a nivel de estructura, responsabilidades y flujo de datos
  • Aplica principios de clean code (nombres claros, funciones pequeñas, separación de responsabilidades)
  • Propone una versión refactorizada y comentada del código

¿Cómo usar este prompt?

Versión Básica

  • Copia el prompt en tu modelo de IA favorito.
  • Completa las variables con tu caso real:
  • [LENGUAJE] Ej.: 'JavaScript', 'Python', 'C#'.
  • [CODIGO] Pega el bloque de código que quieres mejorar.
  • [OBJETIVO] Ej.: 'calcular el total de una lista de pedidos y mostrar el resultado'.
  • Ejecuta el prompt y compara la versión original con la propuesta para entender las mejoras.

Versión Extendida

  • Rellena las variables con tu contexto real:
  • [LENGUAJE] Ej.: 'TypeScript', 'Java', 'Go'.
  • [CODIGO] Pega el fragmento completo que deseas refactorizar.
  • [ENTORNO] Ej.: 'Node.js 18', 'Django 4', 'Spring Boot'.
  • [OBJETIVO] Ej.: 'procesar un listado de pedidos y generar un resumen por cliente'.
  • [ENFOQUE_PRINCIPAL] Ej.: 'mantenibilidad', 'rendimiento', 'simplicidad'.
  • Ejecuta el prompt y usa la versión refactorizada como base para mejorar el resto de tu código siguiendo la checklist de buenas prácticas.

Versión Eficiente

  • Rellena las variables con tu contexto real:
  • [LENGUAJE] Ej.: 'TypeScript', 'Java', 'Go'
  • [CODIGO] Pega el fragmento completo que deseas refactorizar
  • [ENTORNO] Ej.: 'Node.js 18', 'Django 4', 'Spring Boot'

Tips

Versión Básica

  • Indica siempre el lenguaje de programación para adaptar las recomendaciones.
  • Pega un fragmento de código relativamente corto y autocontenido (idealmente menos de 60 líneas).
  • Aclara qué esperas que haga el código o en qué parte tienes dudas.
  • Si usas librerías o frameworks, menciónalos para un mejor contexto.

Versión Extendida

  • Incluye suficiente contexto: qué hace el módulo, función o clase y dónde se usa.
  • Aclara el entorno de ejecución (versión del lenguaje, framework, runtime).
  • Indica si prefieres priorizar legibilidad, rendimiento o simplicidad.
  • Puedes pedir que el resultado incluya comentarios explicativos en puntos clave.

Versión Eficiente

  • Incluye suficiente contexto: qué hace el módulo, función o clase y dónde se usa
  • Aclara el entorno de ejecución (versión del lenguaje, framework, runtime)
  • Indica si prefieres priorizar legibilidad, rendimiento o simplicidad

¿Para quién es?

Este recurso es ideal tanto para programadores principiantes que quieren escribir código más limpio como para desarrolladores con experiencia que buscan pulir su estilo. También es útil para equipos que realizan revisiones de código y quieren ejemplos concretos de cómo mejorar la legibilidad y estructura de sus proyectos.

¿Qué problema resuelve?

Ayuda a transformar fragmentos de código funcionales pero difíciles de leer o mantener. En lugar de lidiar con variables confusas, lógica enmarañada o falta de comentarios, obtienes una versión ordenada que sigue principios de código limpio. Así reduces la deuda técnica y haces que otros desarrolladores entiendan tu trabajo sin esfuerzo.

Casos de uso prácticos

  • Mejorar un script en Python que procesa archivos CSV, haciéndolo más modular y fácil de extender.
  • Refactorizar una función en JavaScript que calcula descuentos en un carrito de compras, separando responsabilidades.
  • Limpiar un bloque de consultas SQL embebidas en PHP, extrayendo la lógica de base de datos a una clase separada.
  • Reorganizar un componente en React con demasiadas responsabilidades, dividiéndolo en partes más pequeñas y reutilizables.

Consejos para mejores resultados

  • Indica siempre el lenguaje de programación al inicio para que las sugerencias se adapten a sus convenciones y buenas prácticas.
  • Pega fragmentos cortos (menos de 60 líneas) y autocontenidos; así la revisión será más precisa y fácil de comparar.
  • Aclara el objetivo concreto del código o la parte que te genera dudas, así las recomendaciones abordarán directamente tu necesidad.