51 lines
2.9 KiB
Markdown
51 lines
2.9 KiB
Markdown
# 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.
|