16. Instrucciones de Proyecto (.github/copilot-instructions.md), Commits IA y Seguridad
Estandariza el código generado por Copilot con archivos de instrucciones de repositorio, redacta commits automáticos y audita vulnerabilidades.
¿Por qué Configurar .github/copilot-instructions.md en tu Proyecto?
¿Te ha pasado que cada vez que le pides código a Copilot tienes que repetirle "Usa PHP 8.3 con strict_types, usa PDO con consultas preparadas, usa Bootstrap 5 y responde en español"? VS Code soluciona esto de raíz mediante el archivo estándar .github/copilot-instructions.md.
Cuando creas ese archivo dentro de la carpeta .github/ en la raíz de tu proyecto, GitHub Copilot lo lee automáticamente de forma silenciosa y adjunta esas reglas arquitectónicas a absolutamente todas las preguntas del chat y ediciones que realices.
Generación de Mensajes de Commit con IA (✨) y Auditoría de Seguridad
| Función Integrada | Cómo Activarla en VS Code | Buenas Prácticas de Uso |
|---|---|---|
| Instrucciones del Repositorio | Crear el archivo .github/copilot-instructions.md. |
Especificar versión del lenguaje, arquitectura MVC, prohibición de consultas SQL concatenadas y convenciones de nombres. |
| Mensajes de Commit con IA (✨) | En el panel de Git (Ctrl+Shift+G), hacer clic en el icono de chispas ✨ dentro del cuadro de texto del commit. |
Asegúrate de poner primero tus archivos en Staged Changes (+) para que Copilot analice exactamente ese diff y redacte un commit tipo Conventional Commits. |
| Copilot Code Review | Seleccionar código ➔ Clic derecho ➔ Copilot ➔ Review and Comment. | Úsalo antes de hacer commit para detectar vulnerabilidades de seguridad (XSS, SQLi), variables no inicializadas o casos borde olvidados. |
Tab sin leer qué hace cada línea y nunca subas archivos .env con contraseñas reales al repositorio.
⚡ Plantilla Oficial .github/copilot-instructions.md para Proyectos Web
Coloca este archivo en tu repositorio para que GitHub Copilot respete siempre tus estándares de código y seguridad.
# Instrucciones Oficiales del Proyecto para GitHub Copilot
## 1. Idioma y Estilo de Comunicación
- Responde siempre en **español** técnico, claro y conciso.
- Los nombres de variables, funciones, tablas y comentarios deben escribirse en español o inglés consistente según el archivo actual.
## 2. Estándares de Backend (PHP 8.3 & MySQL/MariaDB)
- Incluye siempre `declare(strict_types=1);` en la primera línea de todo archivo PHP nuevo.
- Declara tipos explícitos en todos los parámetros de funciones, propiedades de clases y tipos de retorno (`: void`, `: array`, `: ?string`).
- **Seguridad SQL Obligatoria:** Usa exclusivamente `PDO` con sentencias preparadas (`prepare()` y `execute()`). Queda estrictamente prohibido concatenar variables dentro de cadenas SQL.
- **Seguridad XSS Obligatoria:** Escapa toda salida en las vistas HTML usando `htmlspecialchars($valor, ENT_QUOTES, 'UTF-8')` o el helper `e()`.
## 3. Estándares de Frontend (HTML5, CSS3, JS ES2022+ y Bootstrap 5)
- En JavaScript, utiliza sintaxis moderna (`const`, `let`, `async/await`, `fetch`). No utilices `var` ni jQuery.
- En HTML, prioriza etiquetas semánticas (`<header>`, `<main>`, `<section>`, `<article>`) y atributos de accesibilidad (`aria-label`, `alt`).
- Para estilos de interfaz, utiliza las clases utilitarias nativas de **Bootstrap 5.3** antes de crear reglas CSS personalizadas.Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿En qué ruta exacta de tu proyecto debes guardar el archivo de instrucciones personalizadas para que GitHub Copilot en VS Code lo lea y aplique automáticamente en todas tus consultas?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Visual Studio Code & GitHub Copilot Profesional y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.
🏛️ Autoría y Propiedad Intelectual: Obra educativa original de David Amador para Kilopolis Academia (Solucionáticos), estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.