Cómo revisar código con hallazgos verificables.
La revisión debe vincular los hallazgos con un comportamiento o riesgo concreto. Evita tratar las preferencias de estilo como defectos si no existe una convención del proyecto.
Adapta el flujo de trabajo a tu tarea.
Revisa el código frente al comportamiento esperado y las convenciones, vinculando los hallazgos con líneas o casos concretos. Distingue defectos, riesgos relevantes y sugerencias opcionales de estilo, con un ejemplo reproducible cuando sea posible.
- Qué aportas
- Diferencias de código y convenciones del proyecto.
- Qué obtienes
- Posibles defectos y hallazgos de mantenibilidad con referencias.
Mira la entrada y el resultado.
Entrada y salida ilustrativas · ejemplo didáctico, no una ejecución de WebAct en directo
Ejemplo campo
Python code review: def average(total, count): return total / count. No zero-count contract supplied.
Ejemplo completo
Finding: count=0 raises ZeroDivisionError. Reproduction: average(10, 0). Contract question: should an empty set return a designated value or raise a deliberate domain error? Proposed action: define that behavior and add a zero-count test before changing the implementation. Ordinary nonzero division is not itself identified as a defect.
Carga esta entrada en el prompt y cópialo en WebAct para probar la tarea. Tu resultado puede diferir del ejemplo.
Decisiones y solución de problemas.
¿Deben las preferencias de estilo notificarse como errores?
Etiquétalas según las convenciones del proyecto. Una preferencia es distinta de un comportamiento que incumple un requisito.
¿Por qué una revisión señala un problema que el código llamador ya previene?
Examina el contrato de la función y los puntos de llamada. Explicita el supuesto en lugar de evaluar el fragmento como si no tuviera contexto.
Pruébalo con tu propia fuente.
Sustituye el ejemplo por tu material en el prompt. Conserva los requisitos que necesites y copia la tarea en WebAct.
Personalizar y copiar la tarea ↑