Copilot Code Review: Soporte para archivos de instrucciones personalizadas por ruta

La personalización en la revisión de código de GitHub Copilot ha dado un paso adelante. Con la nueva actualización, ahora es posible utilizar archivos de instrucciones personalizadas delimitados por ruta, lo que aporta una guía más específica para partes concretas del repositorio. Esta característica se complementa con otras actualizaciones significativas que también merece la pena resaltar.

Soporte para archivos de instrucciones delimitados por ruta

La funcionalidad de revisión de código de Copilot ahora admite archivos *.instructions.md que contienen una sección applyTo, facilitando así la entrega de orientación en la revisión de código para archivos o directorios específicos dentro del repositorio. Esta opción ya había estado disponible para otras características de Copilot, y ahora se extiende a la revisión de código, mejorando la relevancia y el enfoque del feedback en solicitudes de extracción (pull requests).

Entre las ventajas que proporciona esta nueva capacidad se encuentran:

• Orientación específica: Permite definir instrucciones para áreas concretas del código, como el frontend o la seguridad, usando archivos de instrucciones separados.
• Orientación precisa mediante applyTo: Permite incluir una sección applyTo con patrones globos de ruta (path globs) para señalar exactamente dónde se aplican las instrucciones, ignorando aquellos archivos que no tengan applyTo.
• Instrucciones concisas y enfocadas: Se pueden mantener directrices específicas para cada parte del código, lo que promueve la claridad y efectividad en la revisión.

Comenzar rápidamente

Para activar esta nueva funcionalidad, los usuarios deben crear o actualizar un archivo, por ejemplo, frontend.instructions.md, dentro del directorio .github/instructions de su repositorio. A continuación, se debe incluir una sección applyTo con uno o más patrones globos (por ejemplo, webapp/src/**) y añadir instrucciones breves y comprensibles. Al realizar un commit y abrir o actualizar una pull request que incluya una ruta coincidente, Copilot usará las instrucciones pertinentes.

Ejemplo de configuración:

# frontend.instructions.md
applyTo:
  - webapp/src/**
  - ui/components/**
---
- Énfasis en accesibilidad (ARIA, gestión de foco).
- Preferir tokens de diseño.
- Señalar componentes obsoletos bajo `legacy/`.

Para más detalles, se puede consultar la documentación sobre las instrucciones personalizadas de Copilot.

Otras actualizaciones de personalización

Instrucciones a nivel organizacional

Además de las mejoras mencionadas, se han incorporado instrucciones a nivel de organización en la revisión de código de Copilot. Si una organización ya mantiene instrucciones a este nivel, ahora se incluirán automáticamente al generar retroalimentación para las revisiones de las pull requests. Esta mejora busca garantizar que los estándares y buenas prácticas de codificación se apliquen de manera consistente en todos los repositorios asociados.

Supresión de las directrices de codificación

En una reciente comunicación, se había anunciado que la función de directrices de codificación (previamente en vista previa privada para Copilot Enterprise) sería parcialmente suprimida. Ahora, se ha decidido eliminar por completo esta funcionalidad. De aquí en adelante, todas las especificaciones de personalización deberán ser añadidas en los archivos copilot-instructions.md o *.instructions.md.

Conclusiones

Las nuevas características para la revisión de código en GitHub Copilot no solo amplían la personalización, sino que también facilitan a los equipos de desarrollo al proporcionar pautas más específicas y aplicadas según la estructura del proyecto. Para aquellos que buscan optimizar su flujo de trabajo y mantener estándares en sus proyectos, la implementación de archivos de instrucciones personalizadas se presenta como una herramienta poderosa.

Para seguir explorando más sobre estos temas y otras actualizaciones, se invita a los lectores a visitar el blog y mantenerse informados sobre las últimas innovaciones en el ecosistema de GitHub Copilot.