Saltar a contenido

Skill Sets

Los skill sets te permiten personalizar los skills built-in de RaiSE para tu stack tecnológico específico sin hacer fork del framework. Creas una colección nombrada de archivos overlay que reemplazan solo las secciones que difieren de los defaults.

Gestionar Skill Sets con /rai-skillset-manage

La forma principal de trabajar con skill sets es a través del skill /rai-skillset-manage. Te guía a través del ciclo de vida completo — crear, inspeccionar, comparar y mantener — de forma conversacional.

/rai-skillset-manage

El skill detecta tus skill sets existentes, presenta tus opciones y ejecuta las operaciones CLI correctas por ti. Úsalo cuando:

  • Configurar un skill set para un nuevo stack o equipo
  • Verificar qué cambió tras una actualización de RaiSE (rai skill set diff)
  • Incorporar a un nuevo miembro del equipo a un set existente

Para crear o editar un skill individual, usa /rai-skill-create en su lugar.

Cómo Funciona

Los skills base usan un patrón manifest-first: leen comandos de herramientas desde .raise/manifest.yaml, recurren a detección de lenguaje, luego a defaults hardcodeados. Los overlays de skill set cortocircuitan esta cadena de detección — proporcionan comandos explícitos para tu stack.

Skill base (agnóstico de lenguaje)
  └── lee manifest → detecta lenguaje → defaults

Overlay de skill set (específico del stack)
  └── comandos explícitos, sin detección necesaria

Escribir un Overlay

Un overlay es un archivo SKILL.md dentro de tu directorio de skill set que reemplaza una sección específica de un skill base.

1. Crear el skill set

/rai-skillset-manage

Selecciona "Crear un nuevo skill set" y sigue los prompts. O directamente por CLI:

rai skill set create my-stack --empty

2. Agregar archivos de overlay

Crea un subdirectorio para cada skill que quieras personalizar, con un SKILL.md dentro:

.raise/skills/my-stack/
  rai-story-implement/SKILL.md
  rai-story-plan/SKILL.md

3. Escribir el overlay

Cada overlay requiere frontmatter que identifica qué reemplaza:

---
name: rai-story-implement
overlay: my-stack
replaces: Step 3 (Verify Task)
description: Verificación específica del stack para TypeScript.
---

## Comandos de Verificación

Después de cada ciclo RED-GREEN-REFACTOR, ejecuta:

​```bash
npx vitest run
npx eslint src/
npx tsc --noEmit
​```

4. Activar el skill set

rai init --skill-set my-stack

Esto escribe skill_set: my-stack en .raise/manifest.yaml. Todas las invocaciones de skill subsecuentes cargan tus overlays en lugar de las secciones base.

Skill Sets Incluidos

RaiSE incluye dos skill sets de referencia que puedes examinar y extender:

Nombre Stack Propósito
raise-dev Python (uv + pytest + ruff + pyright) Usado internamente por el proyecto RaiSE
raise-dev-ts TypeScript (vitest + eslint + tsc) Referencia para proyectos TypeScript

Estos se instalan bajo .raise/skills/ cuando ejecutas rai init.

Cuándo Usar Qué

Necesidad Solución
Cambiar comandos de test/lint/tipos Establece project.*_command en manifest.yaml
Guía de flujo de trabajo específica del stack /rai-skillset-manage → crear + overlays
Convenciones de equipo más allá de comandos Skill set + /rai-skill-create
Skills privados internos del proyecto Skill set de proyecto dedicado

Referencia CLI

Los comandos rai skill set son lo que /rai-skillset-manage usa internamente. Úsalos directamente si prefieres scriptear o automatizar operaciones de skill set.

rai skill set create

rai skill set create <nombre> [--empty]
Flag Descripción
<nombre> Nombre del skill set, usado como directorio bajo .raise/skills/
--empty Crear un set vacío (sin builtins copiados) — comenzar desde cero

Por defecto: copia todos los skills built-in como base inicial. Con --empty: crea un directorio vacío para solo overlays mínimos.

rai skill set list

rai skill set list

          Skill Sets
┏━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Nombre       ┃ Skills ┃ Ruta                    ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ my-stack     │     42 │ .raise/skills/my-stack  │
│ raise-dev    │      5 │ .raise/skills/raise-dev │
└──────────────┴────────┴─────────────────────────┘

rai skill set diff

rai skill set diff <nombre>

Muestra qué skills están agregados (en tu set, no en built-ins), modificados (contenido difiere) o sin cambios (idénticos a built-ins). Ejecuta tras una actualización de RaiSE para ver qué skills base cambiaron bajo tus overlays.

Skill set: my-stack

Modificados (3):
  ~ rai-story-implement
  ~ rai-story-plan
  ~ rai-gate

Sin cambios (37):
  = rai-session-start
  ...

Ver También