2.9 KiB
Guía 4.5 — Habilidades de Agente y Comunidad (Skills)
El ecosistema de automatización cognitiva y gobernanza de código
Propósito: Esta guía documenta cómo los agentes de IA resuelven y ejecutan tareas críticas basándose en los skills congelados localmente en el directorio
.agents/skills/.
1. ¿Qué son los Skills Congelados?
Los Skills son directrices operacionales estructuradas en archivos SKILL.md que le indican al agente de IA exactamente cómo ejecutar ciertas disciplinas técnicas (como escribir pruebas, auditar seguridad o revisar código) bajo las reglas específicas de Banesco.
Al estar ubicadas localmente dentro del repositorio en .agents/skills/, garantizan que cualquier agente que trabaje en este proyecto las cargue automáticamente, previniendo la degradación y el olvido de convenciones.
2. Los 5 Skills Comunitarios Instalados
En el proyecto frontend-ai contamos con 5 skills core:
2.1 Test-Driven Development (.agents/skills/test-driven-development/SKILL.md)
- Objetivo: Escribir pruebas unitarias robustas en frontend (Vitest / Testing Library) antes de dar por completado un componente.
- Enfoque: Pruebas de renderizado, testing de interactividad (userEvent), mockeo de peticiones fetch y Zustand stores.
2.2 Systematic Debugging (.agents/skills/systematic-debugging/SKILL.md)
- Objetivo: Resolver problemas de estado, hidratación ("hydration mismatch") y dependencias rotas de daisyUI.
- Enfoque: Proceso analítico de 4 fases para aislar el error, reproducir localmente y corregir la causa raíz.
2.3 Code Review Excellence (.agents/skills/code-review-excellence/SKILL.md)
- Objetivo: Auditar la calidad del código antes de enviar a PR.
- Enfoque: Validaciones estrictas contra el checklist de
AGENT.md, detección de fugas de secretos y estándares de rendimiento.
2.4 Documentation Writer (.agents/skills/documentation-writer/SKILL.md)
- Objetivo: Mantener la documentación técnica auto-generada actualizada.
- Enfoque: Documentación clara de Props TypeScript, estados globales en Zustand y esquemas de API Routes.
2.5 Security Best Practices (.agents/skills/security-best-practices/SKILL.md)
- Objetivo: Asegurar el frontend contra vulnerabilidades bancarias comunes.
- Enfoque: Sanitización de HTML, prevención de XSS, gestión de cookies con flags seguras y encriptación de datos sensibles.
3. Cómo Activar los Skills en tu Sesión de IA
Cuando interactúes con tu agente, puedes pedirle explícitamente que aplique un skill particular:
"Agente, implementa el formulario de transferencia y luego activa el skill 'security-best-practices' para validar que no haya fugas de datos y que las cookies se gestionen según los estándares de seguridad."
El agente leerá el archivo .agents/skills/security-best-practices/SKILL.md y aplicará las directrices precisas durante el desarrollo.