allra-error-handling
Estandarizar el manejo de errores en Java
Los equipos de backend suelen crear excepciones, cuerpos de respuesta y comportamientos de logging inconsistentes entre servicios. Esta skill proporciona a Claude, Codex y Claude Code un patrón Allra concreto para el manejo de errores en Java.
Descargar el ZIP de la skill
Subir en Claude
Ve a Configuración → Capacidades → Skills → Subir skill
Activa y empieza a usar
Recursos legibles por agentes
Usa estos enlaces cuando un AI Agent, crawler o script necesite contexto limpio en lugar de leer toda la página.
Pruébalo
Usando "allra-error-handling". Pedir una excepción de usuario faltante.
Resultado esperado:
El asistente propone una excepción de dominio que extiende la base compartida de excepciones de negocio y se asigna al código de error de usuario no encontrado.
Usando "allra-error-handling". Pedir manejo de errores de validación.
Resultado esperado:
El asistente describe un flujo de controller advice que recopila errores de campo, devuelve la forma de respuesta estándar y evita exponer valores rechazados sensibles.
Usando "allra-error-handling". Pedir orientación de logging.
Resultado esperado:
El asistente recomienda logs warn para fallos de negocio esperados y logs error para fallos inesperados del sistema, con redacción de datos personales.
Auditoría de seguridad
Riesgo medioThe static external command findings are false positives caused by markdown code fences in SKILL.md, not executable shell or Ruby code. The weak cryptography and reconnaissance alerts are also false positives from normal prose or Java examples. A moderate issue remains because examples show rejected values and email addresses in responses or logs, which can expose personal data if copied directly.
Problemas de riesgo medio (1)
Patrones detectados
Puntuación de calidad
Lo que puedes crear
Crear excepciones de servicio consistentes
Generar clases de excepción personalizadas que sigan el patrón BusinessException y ErrorCode de Allra.
Implementar manejo global de errores de API
Crear un controller advice de Spring Boot que asigne excepciones de negocio, validación e inesperadas a respuestas estándar.
Revisar estándares de manejo de errores
Comprobar el código de la capa de servicios para verificar el lanzamiento consistente de excepciones, los formatos de respuesta y los niveles de logging.
Prueba estos prompts
Crea una excepción personalizada de Java para un pedido faltante usando el estándar de manejo de errores de Allra.
Extiende el enum ErrorCode para fallo de pago, cuenta duplicada y acceso prohibido a la cuenta.
Implementa un manejador global de excepciones de Spring Boot que siga el estándar de Allra y evite filtrar valores sensibles.
Revisa este flujo de errores de servicio y controlador según el estándar de Allra. Identifica excepciones inconsistentes, formas de respuesta y riesgos de logging.
Mejores prácticas
- Usa un único catálogo compartido de códigos de error para cada límite de servicio.
- Redacta datos personales, tokens, contraseñas y secretos rechazados en logs y respuestas.
- Maneja las excepciones de negocio esperadas por separado de las excepciones inesperadas del sistema.
Evitar
- No devuelvas stack traces ni detalles internos de excepciones a los clientes de API.
- No registres en logs entradas de usuario sin procesar, credenciales, tokens ni identificadores personales completos.
- No crees formatos de respuesta no relacionados para cada controlador.
Preguntas frecuentes
¿Esta skill proporciona código ejecutable?
¿A qué frameworks está dirigida?
¿Puedo usarla fuera de proyectos Allra?
¿Maneja excepciones de seguridad?
¿Deben devolverse los valores rechazados en errores de validación?
¿Claude Code o Codex pueden aplicar esto durante una revisión de código?
Detalles del desarrollador
Autor
Allra-FintechLicencia
MIT
Repositorio
https://github.com/Allra-Fintech/allra-ai-skills/tree/main/backend-plugin/skills/error-handlingRef.
main
Estructura de archivos
📄 SKILL.md