Arraydeck
Flujos de trabajo

Flujo de trabajo de Delphi en 4 pasos

03
De principio a fin

Abre un proyecto, cambia algo, revísalo

Un buen flujo de trabajo en Delphi es sencillo. Abre la carpeta del proyecto, pide un cambio, lee el diff y ejecuta el comando de compilación. Arraydeck sigue este ciclo con herramientas reales, por lo que cada paso deja una tarjeta en el chat que puedes expandir e inspeccionar, desde la primera búsqueda hasta el último código de salida. Nada queda oculto tras un resumen. Si un paso parece incorrecto, detienes el ciclo ahí, rechazas el cambio y reformulas la solicitud, y los archivos vuelven a su estado anterior. Los mismos cuatro pasos funcionan en una unidad pequeña o en un proyecto con muchos formularios. Tanto principiantes como mantenedores experimentados pueden empezar con una búsqueda en solo lectura, ya que no modifica archivos y muestra cómo está organizado el proyecto.

01

Abre la carpeta

Elige la carpeta que contiene tus archivos .dpr y .pas como la carpeta de trabajo del chat. Las herramientas de archivos operan dentro de ella, así que selecciona el proyecto que deseas modificar y no una carpeta superior con trabajo no relacionado. Una carpeta superior con muchos proyectos dificulta la lectura de la primera búsqueda y aumenta el riesgo de editar la unidad incorrecta.

02

Describe un cambio

Escribe una tarea en palabras sencillas, como el nombre de un procedimiento y qué debe cambiar, y selecciona Auto-run, Ask first o Plan only antes de enviarla. Las tareas pequeñas generan diffs pequeños que son fáciles de leer. Nombra la unidad si la conoces; el agente puede encontrarla con glob, pero una unidad nombrada acota la primera búsqueda.

03

Lee el diff

Expande la tarjeta edit_file, lee cada línea añadida y eliminada, luego acepta o rechaza el cambio. Si usaste Plan only, lee el plan primero y cambia a Ask first para ejecutarlo paso a paso. Un diff muy largo indica que la tarea era demasiado grande; recházala y divide la solicitud en dos más pequeñas.

04

Compila y prueba

Deja que Shell ejecute tu comando de compilación y tu comando de prueba, y lee el código de salida real en la tarjeta. Una compilación exitosa es una buena señal, pero solo tus propias pruebas te dicen si el comportamiento sigue siendo correcto. Ejecuta la compilación antes de las pruebas y mantén ambas tarjetas abiertas para que un fallo pueda rastrearse hasta un cambio específico.

Una unidad pequeña para practicar

Greeter.pas
unit Greeter;

interface

function Greet(const Name: string): string;

implementation

function Greet(const Name: string): string;
begin
  if Name = '' then
    Result := 'Hello, guest'
  else
    Result := 'Hello, ' + Name;
end;

end.

Greet recibe un nombre y devuelve un saludo. Si el nombre está vacío, responde Hola, invitado; de lo contrario, concatena el nombre al texto, y Result contiene el valor de retorno de la función. La sección interface declara la función, y la sección implementation contiene su código, que es la estructura típica de cada unidad.

Cuatro tareas para mantener software en Delphi

Dónde se guarda una configuración

Los principiantes que aprenden Delphi suelen preguntar dónde se guarda un valor en disco. Pídele a Arraydeck que busque dónde se escribe la configuración. El agente ejecuta grep para el nombre de la configuración en tus archivos .pas, luego read_file abre la unidad correspondiente y la respuesta aparece en el chat con nombres de archivo y líneas. No cambia nada. Abre la unidad en tu editor para confirmar que el procedimiento es el correcto y anota el nombre del archivo antes de pedir una edición. Esta búsqueda en solo lectura es una buena primera solicitud en cualquier proyecto que no hayas escrito tú. Anota el archivo y la línea antes de pedir cualquier edición, porque un nombre de archivo y un número de línea precisos hacen que la siguiente solicitud sea concisa y que el siguiente diff sea fácil de seguir para cualquiera que lea tu proyecto en el futuro.

Añade try finally para liberar un objeto

Pide un manejo más seguro: encuentra el procedimiento que crea un objeto y asegúrate de que se libere. El agente busca con grep, lee la unidad y propone el cambio con edit_file, envolviendo el código en try ... finally ... Free. En Ask first aparece el diff y no se escribe nada hasta que lo aceptas. Luego Shell ejecuta tu comando de compilación, y la tarjeta muestra el código de salida real. Ejecuta tus pruebas también. Una compilación exitosa prueba solo la sintaxis, no que el objeto se libere en cada camino, así que lee el diff con calma. Ejecuta las pruebas una vez más después de aceptar el diff y mantén la versión antigua de la unidad en tu copia de seguridad o control de versiones hasta que estés seguro de que el controlador libera todos los objetos en cada rama.

Renombra un procedimiento en todo el proyecto

Así se modernizan las aplicaciones en Delphi en pequeños pasos: renombra un procedimiento poco claro, un nombre a la vez. Pídele al agente que lo renombre en cada unidad. Usa grep para listar cada lugar donde aparece el nombre, luego edit_file cambia cada archivo, y los diffs muestran cada línea modificada. Renombra una vez. Revisa todos los diffs juntos, porque una palabra coincidente dentro de una cadena o un comentario no siempre es una llamada, luego compila el proyecto y ejecuta tus pruebas antes de aceptar el último archivo. Repite el renombramiento para el siguiente procedimiento solo cuando la compilación y las pruebas pasen, para que un error siempre esté en un diff pequeño y nunca se oculte dentro de una larga lista de cambios no relacionados en muchas unidades.

Explica un bucle línea por línea

La lógica del triángulo de Pascal explicada en una unidad corta es una solicitud de práctica adecuada. Pídele al agente que lea el bucle y describa, línea por línea, qué contiene cada variable en cada iteración. Llama a read_file, luego responde en el chat sin escribir nada, así que Plan only es suficiente. Verifica la explicación ejecutando la unidad tú mismo con tu comando de compilación y siguiendo el bucle en papel para 3 o 4 filas. Si el agente y el programa discrepan, confía en el programa y vuelve a hacer la pregunta con la línea exacta citada. Haz lo mismo para un segundo bucle si la primera respuesta ayudó, y pide una explicación más corta cuando un párrafo se sienta largo, porque siempre puedes solicitar más detalles exactamente en la línea que te confunde.

Arraydeck para Windows

Ejecuta los cuatro pasos en tu propio proyecto

Descargar Arraydeck ↗