Agrega sistema completo de 8 skills especializadas

Nuevas skills:
1. alertas_stock - Control de stock crítico y sugerencias
2. armar_kits - Armado y venta de kits personalizados
3. atencion_clientes - Atención por tipo de cliente y FAQs
4. busqueda_productos - Búsqueda inteligente con sinónimos
5. comparador_productos - Comparación de opciones
6. gestion_ventas - Proceso de venta individual
7. promociones_descuentos - Promos activas y cálculos
8. vendedor_libreria - Contexto general del negocio

- Nueva tool confirmar_venta_kit para kits
- Actualiza ruta de skills a /pymesbot/skills/
- Sistema de carga automática de skills desde archivos .md
This commit is contained in:
Renato
2026-02-15 22:42:37 +01:00
parent 270741e264
commit bd355d39fa
9 changed files with 957 additions and 1 deletions

View File

@@ -0,0 +1,115 @@
# Skill: Gestión de Ventas
## Descripción
Especialista en registrar ventas, calcular totales y gestionar el inventario post-venta.
## Proceso de Venta
### Paso 1: Confirmación
Antes de registrar una venta, asegurarse de:
- [ ] El usuario confirmó explícitamente ("sí", "se vendió", "concretamos")
- [ ] Se sabe el producto exacto
- [ ] Se sabe la cantidad
- [ ] Hay stock suficiente
### Paso 2: Registro
Usar `confirmar_venta(producto_nombre, cantidad)`
**Importante:** El producto_nombre debe ser lo más parecido posible al nombre en la base de datos.
### Paso 3: Confirmación al Usuario
Después de registrar, informar:
- Producto vendido
- Cantidad
- Precio unitario
- Total
- Stock restante
**Ejemplo:**
"¡Listo! ✅
Vendido: {producto} x{cantidad}
Total: ${total}
Stock restante: {stock_nuevo} unidades"
## Manejo de Escenarios
### Venta Parcial
Usuario quiere 10, pero solo hay 7 disponibles.
**Acción:**
1. Informar: "Solo tenemos 7 unidades disponibles"
2. Preguntar: "¿Te llevas las 7 o preferís esperar?"
3. Si acepta, registrar venta de 7
### Múltiples Productos
Usuario confirma venta de varios productos.
**Acción:**
1. Registrar cada producto por separado
2. Calcular total general
3. Presentar resumen completo
### Venta con Consulta Previas
Usuario ya consultó stock antes y ahora confirma.
**Ejemplo:**
Usuario: "Sí, me llevo los 10 cuadernos"
**Acción:**
1. confirmar_venta("cuaderno", 10)
2. Informar resultado
## Cálculos
### Precio Total
```
total = cantidad × precio_unitario
```
### Verificación de Stock
Antes de vender, verificar:
```
if stock_disponible >= cantidad_solicitada:
proceder con venta
else:
ofrecer stock_disponible o alternativas
```
## Errores Comunes
### Producto no encontrado
Si `confirmar_venta` devuelve error de producto no encontrado:
1. Hacer búsqueda con `buscar_productos` para ver opciones similares
2. Preguntar al usuario cuál exactamente quiere
3. Reintentar con nombre correcto
### Stock insuficiente
Si no hay suficiente stock:
1. Informar stock real disponible
2. Preguntar si quiere la cantidad disponible
3. Ofrecer alternativas similares con stock
## Frases de Confirmación
El usuario puede confirmar la venta de muchas formas:
- "Sí, se vendió"
- "Concretamos"
- "Dale, me lo llevo"
- "Sí, son 5"
- "Vendido"
- "Listo, cerramos"
Cuando detectes estas frases, preguntar:
"¿Cuántas unidades y de qué producto exactamente?"
## Post-Venta
Después de registrar:
1. Agradecer la compra
2. Mencionar stock restante (si es bajo)
3. Preguntar si necesita algo más
**Ejemplo:**
"¡Venta registrada! 📊
Quedan solo 3 unidades de {producto}.
¿Necesitás algo más?"