Punto de partida. Actividad «Mejora del sitio asistida por IA», sesión 2 de 4. Abre el avance de la sesión anterior; los pasos de hoy indican qué conservar y qué completar. La guía de arranque permite preparar las herramientas sin depender de otros módulos.
Se explica
10 minutos · contexto, explicación y ejemplo
Las instrucciones del repositorio describen reglas que siguen siendo válidas entre tareas: estructura, estilo y forma de comprobar el sitio. El prompt describe el cambio de hoy. Una skill reúne un procedimiento reutilizable para un tipo de trabajo; no sustituye los criterios específicos de la tarea.
Una regla como «trabaja bien» no guía una decisión. «No añadas dependencias para un cambio de texto; verifica los enlaces modificados» sí puede contrastarse. No hace falta escribir muchos archivos: crearemos instrucciones breves y una lista de revisión que utilizaremos realmente.
Consultar ejemplos y conceptos de esta sesión
Ejemplo de instrucciones
Creamos .github/copilot-instructions.md:
# Project instructions
## Stack
- Node.js 22
- Express
- PostgreSQL
- Jest
## Architecture
The project follows:
route -> controller -> service -> repository
Do not bypass layers.
## Coding rules
- Use clear variable names.
- Avoid duplicated code.
- Do not add dependencies unless necessary.
- Never place secrets in source code.
## Testing
Every new feature must include tests.
Before considering a task complete:
1. run the test suite;
2. check for errors;
3. summarize the files modified.Estas instrucciones no corresponden a una tarea concreta.
Describen:
cómo debe trabajar el agente en este proyecto.
Prompt vs instrucciones
Es importante distinguirlos.
Prompt
¿Qué quiero hacer ahora?
Instrucciones
¿Cómo se trabaja aquí siempre?
Un prompt describe lo que queremos ahora:
Añade paginación a productos.
Las instrucciones describen reglas permanentes:
Utiliza la arquitectura existente. Añade tests. No añadas dependencias innecesarias.
¿Qué es una skill?
Una skill contiene instrucciones especializadas para realizar bien un determinado tipo de tarea.
Por ejemplo:
.github/skills/security-review/SKILL.md
La skill podría explicar:
Cuando revises seguridad:
- busca credenciales;
- revisa validación de entradas;
- comprueba SQL Injection;
- revisa autenticación;
- comprueba dependencias;
- genera un informe.
GitHub Copilot puede cargar una skill cuando detecta que es relevante para la tarea.
Instructions vs Skills
La diferencia puede entenderse fácilmente.
Las instrucciones son información útil casi siempre: «utilizamos Node.js», «todos los cambios deben tener tests».
Una skill es información útil para una tarea especializada: el procedimiento para realizar una revisión de seguridad.
Se trabaja
45 minutos · trabajo guiado sobre la actividad
- Revisa el cambio de la sesión anterior y anota dos decisiones que no quieras explicar de nuevo. Distingue una regla permanente de una instrucción exclusiva de aquel cambio.
- Crea
.github/copilot-instructions.mdsi utilizas Copilot, o el archivo de instrucciones que reconozca el agente del aula. Escribe objetivo del sitio, archivos relevantes, límites y comprobación manual. - Pide al agente que explique qué instrucciones ha encontrado. Verifica el contenido indicado; no des por leído un archivo solo porque exista.
- Crea una ficha de revisión con cuatro pasos: abrir cambio, comparar con objetivo, probar comportamiento y registrar resultado. Si el entorno admite skills, usa la plantilla enlazada en la guía; si no, aplica el mismo procedimiento desde el prompt.
- Prueba las instrucciones con una modificación pequeña de texto y comprueba si respeta los límites. Corrige una regla ambigua y conserva el ejemplo que motivó su revisión.
Cierre
5 minutos · comprobar el resultado
Al terminar la sesión:
Las instrucciones y la ficha se han usado en una tarea real. Explica qué información pertenece al prompt y cuál debe permanecer en el repositorio.