Planeación de un proyecto con GitHub Copilot

Administra el proyecto conGitHub Issues mediante Copilot. En este tutorial, usarás las características de creación de propuestas con agente de Copilot para convertir la idea del producto en epopeyas, características y tareas. Las epopeyas representan grandes cuerpos de trabajo, mientras que las características y las tareas dividen el trabajo en partes más pequeñas y accionables. Al final, tendrás un trabajo pendiente estructurado listo para compartir con tu equipo.

Información general del proyecto

Es importante definir lo que quieres que haga el producto. En la fase de planeación del ciclo de vida de desarrollo de software (SDLC), las ideas se convierten en tareas que requieren acción al dividir el proyecto en epopeyas, características y fragmentos de trabajo más pequeños. Esto te ayuda a organizar tus ideas, establecer prioridades y preparar a tu equipo para el desarrollo.

Cuando se usa Copilot, se impulsa este proceso. Copilot puede sugerir una estructura y rellenar los detalles, pero los mejores resultados se obtienen cuando se tiene una idea de cómo deseas organizar el trabajo. Copilot trabaja con tus ideas para ayudarte a refinar, expandir y documentar tu plan.

En este escenario, planearás un nuevo sitio web de compras que permitirá a los usuarios:

• Examinar un catálogo de productos con categorías y búsqueda
• Agregar artículos a un carro de la compra
• Completar un pago de forma segura

El objetivo es usar Copilot para convertir rápidamente esta visión en un plan de proyecto estructurado, creando epopeyas y propuestas detalladas que capturen cada parte del sitio.

Configuración del repositorio

Configura un repositorio con GitHub Issues habilitado. Consulta Crear un repositorio nuevo.

De forma predeterminada, las propuestas están habilitadas para los nuevos repositorios. Si deseas usar un repositorio existente pero no ves la pestaña Propuestas, sigue estos pasos para habilitar las propuestas:

1. En el repositorio, selecciona Configuración.
2. En "Características", activa la casilla Propuestas.

Generar propuestas del proyecto

Con el repositorio configurado, puedes usar Copilot para convertir la visión del proyecto en un conjunto de propuestas que requieren acción.

Iniciar en la vista envolvente de Copilot

1. En la parte superior derecha de cualquier página de GitHub, haz clic en el botón situado junto a la barra de búsqueda.

   Se muestra el modo de página completa, inmersiva, de Copilot Chat.

2. En el panel de chat, adjunta el repositorio del sitio web de compras. Esto permite que Copilot acceda al repositorio y cree propuestas directamente en él.

Crear una propuesta de epopeya

1. Escribe una descripción detallada del proyecto como solicitud. Por ejemplo:
   I’m planning to create a shopping website in React and Node.js. The site should allow users to browse products by category, search for items, add products to a cart, and complete checkout. Please help me plan the project by creating issues and breaking it down into epics, features, and tasks.
2. Envía la indicación. Copilot generará un árbol de propuestas, normalmente con una epopeya en la parte superior y subpropuestas para cada característica o tarea principal

Navegar por el árbol de propuestas

1. Haz clic en la epopeya para ver sus detalles en el área de trabajo. Navega por el área de trabajo para explorar el árbol de propuestas.

2. Cada propuesta normalmente incluye un título y una descripción. Los metadatos adicionales, como etiquetas o usuarios asignados, se pueden editar directamente en el área de trabajo.

3. Puedes expandir o contraer subpropuestas para centrarse en partes específicas del proyecto.

   El árbol de propuestas proporciona una visión general clara de la estructura del proyecto, lo que facilita la navegación entre epopeyas, características y tareas.

4. En esta primera iteración del borrador, Copilot solo puede generar propuestas de alto nivel. Puedes refinar aún más estos propuestas dividiéndolas en tareas o características más pequeñas. Vamos a refinar la propuesta "Característica: esqueleto de la interfaz de usuario y navegación".

   Solicita a Copilot lo siguiente:
   Can you break down the issue "Feature: UI Skeleton and Navigation" into smaller tasks?

   Copilot generará varias subpropuestas nuevas, como:

   • Tarea: Configurar la estructura del proyecto de React y los archivos iniciales
   • Tarea: Crear páginas de marcador de posición para las rutas principales
   • Tarea: Implementar el componente de barra de navegación de todo el sitio
   • Tarea: Integrar la navegación con el enrutamiento
   • Tarea: Agregar diseño dinámico básico

5. Repite este proceso para las propuestas de características restantes de la epopeya.

Mejorar las descripciones de propuestas

Cuando termines de generar el árbol de propuestas, es posible que observes que las descripciones de propuestas de Copilot pueden ser breves o poco claras. Para que sean accionables, refina cada propuesta según sea necesario.

1. Comienza con la propuesta recién generada, como "Tarea: Crear páginas de marcador de posición para las rutas principales".

   Solicita a Copilot lo siguiente:
   Can you improve the description for “Task: Create placeholder pages for main routes”? Please provide a detailed technical summary, list the main routes to be included, outline the steps for implementation, and specify what should be delivered for this task.

2. Copilot generará una nueva versión del borrador de la propuesta "Tarea: Crear páginas de marcador de posición para las rutas principales".

   En la parte superior izquierda de la propuesta, haz clic en la lista desplegable de control de versiones y selecciona la Versión 2 para revisar los nuevos cambios.

3. Revisa y decide si deseas mantener la versión revisada de Copilot, editar más o solicitar de nuevo más detalles.

4. Repite este proceso para otras propuestas de la epopeya, refinando las descripciones y desglosando las tareas según sea necesario.

5. Una vez que estés satisfecho con las descripciones de la propuesta, haz clic en Crear todo para crear las propuestas en el repositorio.

Desvincular propuestas

Si Copilot genera una subpropuesta que no pertenece al árbol de propuestas, puedes desvincularla del árbol de propuestas.

1. En el árbol de propuestas del área de trabajo, haz clic en junto a la subpropuesta y, a continuación, haz clic en Desvincular subpropuesta.
2. La propuesta se desvinculará de su elemento primario y ya no aparecerá bajo esa epopeya en el árbol.

Pasos siguientes

Ahora que has generado y refinado las propuestas del proyecto, puedes asignarlas a los miembros del equipo adecuados o incluso a Copilot para obtener más ayuda. Para obtener más información sobre cómo asignar Copilot o colaboradores a propuestas y cómo continuar planeando e implementando el proyecto con las características con agente de Copilot, consulta Pedir a GitHub Copilot que cree una solicitud de incorporación de cambios.

Información adicional

• Uso de GitHub Copilot para crear propuestas
• Creación de pilotos del agente de programación de GitHub Copilot en tu organización
• Procedimientos recomendados a fin de usar GitHub Copilot para trabajar en tareas
• Aceleración del trabajo de desarrollo con GitHub Copilot Spaces