From f0eb7230200fce17a25ba534ee808ce9334da13b Mon Sep 17 00:00:00 2001 From: brobert Date: Fri, 17 Oct 2025 15:02:20 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20actualizar=20comandos=20a=20espa=C3=B1o?= =?UTF-8?q?l=20y=20a=C3=B1adir=20comandos=20desconocidos?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: aider (openrouter/openai/gpt-5) --- docs/commands-inventory.md | 18 +++++++++++------- docs/plan-ayuda-bot.md | 10 +++++----- docs/whatsapp-style-guide.md | 3 ++- 3 files changed, 18 insertions(+), 13 deletions(-) diff --git a/docs/commands-inventory.md b/docs/commands-inventory.md index c2ad617..f41905f 100644 --- a/docs/commands-inventory.md +++ b/docs/commands-inventory.md @@ -119,13 +119,13 @@ Ejemplos ## /t configurar (recordatorios) Alias: `config`, `configurar` -Sintaxis: `/t configurar daily|l-v|weekly|off [HH:MM]` +Sintaxis: `/t configurar diario|l-v|semanal|off [HH:MM]` Valores admitidos y alias -- `daily`: también `diario`, `diaria` → recordatorio diario. -- `weekdays`: también `l-v`, `lv`, `laborables` → lunes a viernes. -- `weekly`: también `semanal` → semanal (asume lunes). -- `off`: también `apagar`, `ninguno` → sin recordatorios. +- `diario`/`diaria` → recordatorio diario (se guarda como `daily`). +- `laborables` (`l-v`, `lv`) → lunes a viernes (se guarda como `weekdays`). +- `semanal` → semanal (asume lunes; se guarda como `weekly`). +- `off`/`apagar`/`ninguno` → sin recordatorios (se guarda como `off`). Hora - Formato `HH:MM` (minutos 00–59; hora se normaliza a 0–23). @@ -151,8 +151,8 @@ Comportamiento actual - Ayuda rápida con comandos básicos, límites y ejemplos cortos. - “Ayuda avanzada” lista alias y detalla opciones y límites. -Plan futuro -- Se centralizará el contenido en un módulo único y se uniformará el estilo. +Nota +- El contenido de ayuda está centralizado y consistente. --- @@ -169,6 +169,10 @@ Ejemplo --- +## Comandos desconocidos + +Ante comandos no reconocidos, el bot responde por DM con un mensaje que incluye el encabezado “❓ Comando no reconocido”, la sugerencia “Prueba `/t ayuda`” y la ayuda rápida inline. + ## Notas adicionales - Estilo y formato: diff --git a/docs/plan-ayuda-bot.md b/docs/plan-ayuda-bot.md index 9834e94..c88ac0a 100644 --- a/docs/plan-ayuda-bot.md +++ b/docs/plan-ayuda-bot.md @@ -42,7 +42,7 @@ Objetivo: hacer la ayuda consistente, útil ante comandos desconocidos, visible - Comandos: `/t soltar`, `/t unassign`, `/t dejar`, `/t liberar`, `/t renunciar` - Un solo ID - Configurar recordatorios - - Comandos: `/t configurar daily|l-v|weekly|off [HH:MM]` + - Comandos: `/t configurar diario|l-v|semanal|off [HH:MM]` - Mapea alias a `daily`, `weekdays`, `weekly`, `off`; hora opcional con normalización - Ayuda - Comandos: `/t ayuda`, `/t help`, `/t ?`, y variante “ayuda avanzada” @@ -86,7 +86,7 @@ Objetivo: hacer la ayuda consistente, útil ante comandos desconocidos, visible - Criterios de aceptación: - Formateadores devuelven exactamente el formato esperado y no rompen los existentes. -### Fase 2 — Centralizar contenido de ayuda +### Fase 2 — Centralizar contenido de ayuda (completado) - Objetivo: tener una única fuente de verdad para la ayuda. - Cambios: @@ -110,12 +110,12 @@ Objetivo: hacer la ayuda consistente, útil ante comandos desconocidos, visible - `getQuickHelp()` incluye `/t web` y comandos básicos. - `getFullHelp()` cubre scopes de “ver”, formatos de fecha y límites. -### Fase 3 — Comportamiento ante comandos desconocidos +### Fase 3 — Comportamiento ante comandos desconocidos (completado) - Objetivo: responder útilmente cuando no se reconoce la acción. - Cambios en `src/services/command.ts`: - Reemplazar la respuesta “Acción X no implementada aún” por: - - Encabezado tipo: `*NO RECONOCÍ ESE COMANDO*` + - Encabezado tipo: `❓ Comando no reconocido` - Sugerencia: “Prueba `/t ayuda`” - Adjuntar `getQuickHelp(baseUrl)` en el mismo mensaje - Mantener logging/telemetría si aplica (ej. `Metrics.inc('commands_unknown_total')` opcional) @@ -129,7 +129,7 @@ Objetivo: hacer la ayuda consistente, útil ante comandos desconocidos, visible - Criterios de aceptación: - DM siempre; mensaje claro y accionable. -### Fase 4 — Unificar el comando /t ayuda +### Fase 4 — Unificar el comando /t ayuda (completado) - Objetivo: que `/t ayuda` y “ayuda avanzada” usen el módulo centralizado. - Cambios en `src/services/command.ts`: diff --git a/docs/whatsapp-style-guide.md b/docs/whatsapp-style-guide.md index 87fcbc2..d51129a 100644 --- a/docs/whatsapp-style-guide.md +++ b/docs/whatsapp-style-guide.md @@ -59,6 +59,7 @@ Localización Buenas prácticas - Evitar párrafos largos; preferir 1–3 líneas por bloque. +- Los mensajes de 'Uso:' llevan el prefijo ℹ️. - Incluir uso cuando falten argumentos: - Ej.: `ℹ️ Uso: \`/t tomar 26\` o múltiples: \`/t tomar 12 19 50\` o \`/t tomar 12,19,50\` (máx. 10)` - Mensajes de error claros y accionables: “No puedes tomar esta tarea… Pide acceso a un admin si crees que es un error.” @@ -76,7 +77,7 @@ Ayuda rápida - `/t n Descripción 2025-11-05 @Ana` - `/t ver` (en grupo) · `/t ver mis` (DM) · `/t ver todos` - `/t x 26` · `/t tomar 12` -- `/t configurar daily|l-v|weekly|off [HH:MM]` +- `/t configurar diario|l-v|semanal|off [HH:MM]` - `/t web` _El bot responde por DM, incluso si escribes desde un grupo._ ```