Desarrollo de características e iteración con Amazon Q Developer en GitHub - Amazon Q Developer

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Desarrollo de características e iteración con Amazon Q Developer en GitHub

nota

Amazon Q Developer para GitHub está en versión de vista previa y sujeto a cambios.

Puede usar Amazon Q Developer en GitHub para agilizar el desarrollo mediante la implementación automática de nuevas características y correcciones de errores, llevando las tareas desde la idea hasta una solicitud de extracción completa. Al añadir la etiqueta de desarrollo de características a un problema o al usar el comando de barra inclinada /q dev, Amazon Q Developer utiliza el problema, incluidos su título y descripción, así como el código del repositorio como contexto para generar nuevas correcciones de código y crear una solicitud de extracción. En la solicitud de extracción, puede proporcionar comentarios y Amazon Q Developer itera sobre el código sugerido.

Puede hacer que Amazon Q Developer realice el desarrollo de características un número limitado de veces al mes. Puedes aumentar el uso gratuito en cualquier momento registrando la instalación de la aplicación Amazon Q Developer en tu AWS cuenta. Para obtener más información, consulte Aumento de los límites de uso y los detalles de configuración en la consola de Amazon Q Developer.

importante

La aplicación de Amazon Q Developer intenta crear automáticamente las etiquetas de agente de desarrollo de Amazon Q y de agente de transformación de Amazon Q en los repositorios de GitHub a los que autorice el acceso. Si las etiquetas no se crean automáticamente o si se eliminan de forma no intencionada, puede crearlas manualmente en GitHub. Las etiquetas deben tener el nombre de agente de desarrollo de Amazon Q y de agente de transformación de Amazon Q para que se reconozcan y se procesen como etiquetas de Amazon Q Developer. Para obtener más información, consulte Creating a label en la Documentación de GitHub.

Cómo utilizar Amazon Q Developer para el desarrollo de características

  1. Si es necesario, inicie sesión en su cuenta de GitHub usando sus credenciales de GitHub.

  2. Navegue hasta la organización de GitHub y, a continuación, navegue hasta el repositorio en el que desee implementar nuevas características con Amazon Q Developer.

  3. Elija Problemas y, a continuación, cree un nuevo problema o elija uno existente. Para obtener más información, consulte Create an issue en la Documentación de GitHub.

    1. Para un número problema, en el campo de entrada de texto Añadir un título, introduzca un título que proporcione contexto a Amazon Q Developer para el desarrollo de la característica (por ejemplo: “Crear una aplicación de reconocimiento de imágenes”). También se debe incluir la descripción del problema, ya que también proporciona contexto.

      En el caso de un problema existente, puede editar el título y la descripción del problema para proporcionar contexto a Amazon Q Developer para el desarrollo de la característica. Para obtener más información, consulte Editing an issue en la Documentación de GitHub.

  4. Al crear un problema o configurar uno existente, puede aplicar la etiqueta de Amazon Q Developer de desarrollo de características o utilizar el comando de barra inclinada /q dev. Realice una de las siguientes acciones:

    • Para aplicar la etiqueta al problema, siga uno de estos pasos:

      • Seleccione el menú desplegable Asignar a Amazon Q que se proporciona como extensión del navegador y, a continuación, elija la etiqueta de Agente de Amazon Q Developer.

      • En el menú de la derecha, elija Etiquetas y, a continuación, elija la etiqueta del Agente de Amazon Q Developer.

    • Cómo usar el comando de barra inclinada /q dev en un comentario:

      1. En el problema, navegue hasta Añadir un comentario y, en el campo de entrada de texto del comentario, introduzca /q dev.

      2. Elija Comment (Comentario).

  5. Si se trata de un problema nuevo, elija Crear problema para terminar de crearlo con los detalles necesarios para que Amazon Q Developer desarrolle características. Si configura un problema existente, asegúrese de guardar los cambios. Para obtener más información, consulte Editing an issue en la Documentación de GitHub.

    Cuando Amazon Q Developer termina de generar cambios en el código para el desarrollo de la característica, comenta el problema y abre una solicitud de extracción.

  6. Navegue hasta el comentario que ha dejado Amazon Q Developer (ejemplo: “I finished generating the proposed code changes and opened a pull request: Resolve Create an image recognition app”) y, a continuación, elija el enlace de la solicitud de extracción.

    También puede navegar hasta la pestaña Solicitudes de extracción y, a continuación, elegir la solicitud de extracción creada por Amazon Q Developer.

  7. Elija la pestaña Archivos cambiados para ver los cambios en el código.

  8. Si está satisfecho con los cambios de código sugeridos, puede combinar la solicitud de extracción. Para obtener más información, consulte Combinación de una solicitud de extracción.

También puede revisar la solicitud de extracción para el desarrollo de la característica e iterar los cambios de código sugeridos enviando comentarios a Amazon Q Developer.

Cómo iterar en el código de desarrollo de características de Amazon Q Developer

  1. Elija la solicitud de extracción creada por Amazon Q Developer y, a continuación, elija la pestaña Archivos cambiados para ver los cambios en el código.

  2. Para la línea de código sobre la que quiera dejar comentarios y hacer que Amazon Q Developer itere, elija + para añadir un comentario y, a continuación, elija Iniciar una revisión.

    Tras enviar la revisión, Amazon Q Developer empieza a revisar el código en función de sus comentarios. Cuando Amazon Q Developer termine de revisar los comentarios, confirmará los cambios en la solicitud de extracción y le actualizará con un comentario.

  3. Elija Finalizar la revisión, elija el botón de opción Solicitar cambios y, a continuación, elija Enviar revisión para que se revise su opinión.

  4. Si está satisfecho con los cambios de código actualizados, puede combinar la solicitud de extracción o volver a iterar sobre el código con nuevos comentarios. Para obtener más información, consulte Combinación de una solicitud de extracción.

Amazon Q Developer se integra con los flujos de trabajo de GitHub Actions para crear un sistema de bucle de comentarios inteligente. Cuando se crea una solicitud de extracción, los flujos de trabajo configurados, como las pruebas unitarias, se ejecutan automáticamente. Si el flujo de trabajo falla, Amazon Q Developer analiza el resultado y, en función de los resultados y la información sobre el fallo, itera sobre los cambios en el código. A medida que se introducen cambios en el código y se ejecutan los flujos de trabajo, Amazon Q Developer interpreta los resultados y utiliza esta información para mejorar su enfoque. Esto crea un ciclo de aprendizaje continuo en el que cada iteración se basa en intentos anteriores y Amazon Q Developer puede hacer que las soluciones evolucionen.

La eficacia de un ciclo de comentarios depende de contar con pruebas y flujos de trabajo bien definidos que proporcionen comentarios significativos para que Amazon Q Developer los interprete y actúe en consecuencia. Puede configurar los flujos de trabajo mediante archivos YAML de GitHub Actions en su repositorio, lo que permite procesos de prueba y validación personalizados a los que Amazon Q Developer puede responder. Para obtener más información, consulte Understanding GitHub Actions en la Documentación de GitHub.