Changelog

Todos los cambios relevantes del skill seudonimizador-clinico-juridico se documentan en este archivo.

El formato sigue Keep a Changelog y la numeración aplica Semantic Versioning en su lectura adaptada para skills (mayor = ruptura de comportamiento, menor = ampliación o refuerzo de reglas, parche = correcciones puntuales).

[1.5] — sin publicar

Multiidioma: el marco de la respuesta puede salir en otro idioma, sin cambiar nada del español.

Añadido

• Idioma de la respuesta. Un código de idioma tras el modo, solo en la primera línea y con el caso en la línea siguiente (/seudonimizar A en). Idiomas: en, fr, ca, gl y eu; es es el original y la referencia. Sin código, todo funciona exactamente como antes.
• Catálogos i18n-<código>.md, uno por idioma, descubiertos por nombre de fichero (añadir un idioma no exige editar SKILL.md), más i18n-es.md, la referencia generada del original. 55 claves por catálogo (50 literales extraídos del original y 5 entradas nuevas: aviso de traducción y las preguntas de las puertas de entrada).
• Aviso de traducción al final de la salida, en el idioma elegido, solo cuando no es el español. En eu es una advertencia reforzada y bilingüe (euskera y español).
• Verificación automática: tools/linea_base.py (el español no cambia), tools/validar_i18n.py (validador de catálogos), tools/extraer_es.py (extractor de la referencia y comprobación de que no queda texto visible sin clave), una suite de pruebas en tests/ y el workflow de GitHub Actions .github/workflows/verificar.yml (check verificar). Solo biblioteca estándar de Python.
• Documentación: docs/estado-traducciones.md (quién escribió y quién revisó cada idioma), docs/guia-web-github.md (guía paso a paso desde el navegador), AGENTS.md y CLAUDE.md.

Cambiado

• Cambios al original: solo adiciones, delimitadas por <!-- i18n:inicio --> y <!-- i18n:fin -->; ninguna línea reescrita ni eliminada (git diff --numstat: 45 líneas añadidas, 0 eliminadas):
  • SKILL.md: bloque «Idioma de la respuesta» y una línea en «Archivos del skill».
  • flujo.md: bloque «Idioma de la salida», tras la plantilla del paso 5.
  • auditoria.md: bloque «Idioma de la salida del modo audit», que además aclara que los tokens y los dos marcadores fijos no cuentan como idiomas mezclados en la comprobación 6.
• Versión 1.5.0 en los tres manifiestos y en el README. El paquete de la Release incluye ahora los i18n-*.md; el resto de su forma no cambia.
• El frontmatter y la description de SKILL.md no se han tocado.

Corregido

• Sin correcciones en el original ni en el comportamiento en español.

Limitaciones

• Las traducciones son borradores de IA, sin revisión humana, y contienen frases de seguridad y de contenido clínico y jurídico. eu es experimental, de alto riesgo: ninguna comprobación automática puede detectar un error de traducción en euskera. Estado detallado en docs/estado-traducciones.md.
• No se ha ejecutado el skill con un idioma distinto del español en ninguna plataforma real, sino solo una simulación con subagentes de contexto limpio (10 escenarios, ver tests/escenarios.md), que no equivale a una plataforma real. Lo verificado es automático (pruebas, validadores, comparación con la línea base) y simulado.
• El texto libre que el modelo redacta dentro del marco (justificaciones, decisiones por defecto) se genera en el momento en el idioma elegido: no está en el catálogo y no lo ha revisado nadie.
• Los términos oficiales (RGPD) se comprobaron por búsqueda web, no abriendo el texto oficial: EUR-Lex sirve un desafío anti-bots que impide leerlo desde el entorno de desarrollo. El catalán, el gallego y el euskera no son lenguas oficiales de la UE, así que no hay RGPD oficial en ellas (hecho conocido, no comprobado).
• Si una plataforma carga solo SKILL.md y no los catálogos, el idioma no funciona: el skill responde en español y lo dice (fallo seguro).
• Los tokens y los marcadores [DATO_ELIMINADO] y [NO_CONSTA] no se traducen: en un caso en otro idioma aparecerán palabras españolas entre corchetes.
• El código de idioma solo se reconoce con la primera línea de exactamente tres elementos (o dos, si falta el modo). Cada invocación del comando decide su idioma; solo los mensajes de seguimiento conservan el anterior.

[Sin publicar]

Añadido

• PRIVACY.md: política de privacidad pública del plugin, que el directorio de plugins de Claude exige para publicar. Describe qué trata el skill, qué no recoge ni envía, y que la retención depende de la plataforma de IA usada.
• Icono del plugin (PNG cuadrado de 1024 × 1024 px) en la carpeta .claude-plugin/, requerido por el directorio de plugins de Claude (ICON_MISSING).

Cambiado

• Versión de los manifiestos alineada con el CHANGELOG: plugin.json, .claude-plugin/plugin.json y .claude-plugin/marketplace.json pasan de 1.3.0 a 1.4.0.

• dist/ sale del control de versiones (queda en .gitignore). El .zip y el .skill son binarios que el validador del directorio de plugins de Claude no puede inspeccionar (BINARIES_NOT_INSPECTED) y retenía el envío. Ahora se publican como activos de una GitHub Release, y los enlaces del README apuntan a releases/latest/download/…. scripts/build-dist.sh sigue generándolos.

[1.4] — 2026-08-07

Añadido

• El repositorio es ahora un plugin conforme a Agent Plugins 1.0.0, el formato portátil de empaquetado de la Agentic AI Foundation. Se añaden plugin.json (portable, con el $schema canónico) y .claude-plugin/plugin.json (Claude Code). Habilita una vía de instalación nueva —como plugin en Claude Code y Cowork, Opción 5 del README— sin retirar ninguna de las anteriores.
• scripts/build-dist.sh: el paquete de dist/ se armaba a mano; ahora se regenera con un script. Al cambiar de sitio la fuente del skill, dejar el empaquetado como algo que recordar habría sido una fuente de derivas.

Cambiado

• El skill pasa de la raíz del repositorio a skills/seudonimizador-clinico-juridico/, junto con flujo.md, auditoria.md, plantilla-entrada.md y plantilla-tokens.md. Es la ubicación fija que el §6.1 de la spec exige para descubrir skills. Los acompañantes quedan planos al lado del SKILL.md, no bajo references/, porque el cuerpo los referencia por nombre pelado.
• Enlaces del README actualizados a la ruta nueva.

Sin cambios

• El contenido del skill no se toca: ni el SKILL.md, ni el flujo, ni las plantillas, ni el protocolo de auditoría.
• El paquete de dist/ conserva exactamente la misma forma: una carpeta seudonimizador-clinico-juridico/ con los cinco .md y la LICENSE. Verificado comparando la lista de ficheros antes y después de regenerarlo. Las opciones 1 a 4 del README (claude.ai, Perplexity, Mistral y Claude Code) siguen funcionando igual.

[1.3] — 2026-06-10

Añadido

• README.md — Opción 3: Mistral AI (Skills). Instalación nativa en el espacio Work descomprimiendo el paquete y seleccionando la carpeta del skill, con renumeración de las opciones siguientes (Claude Code → 4, Otras IA → 5).

Cambiado

• SKILL.md — descripción del frontmatter reducida a 455 caracteres / 468 bytes (antes 912 bytes) para cumplir el límite de 500 caracteres que aplica Mistral. Se conservan el trigger /seudonimizar, los cuatro modos (A, B, C, audit) y la advertencia RGPD/LOPDGDD; se recorta el número de ejemplos de activación y la descripción pasa a bloque escalar YAML (>-). La lógica del skill no se toca.
• README.md — nota técnica de la Opción 2 actualizada con los límites por plataforma (Perplexity 1024 bytes, Mistral 500 caracteres) y la longitud real vigente.

Notas

• No hay cambios de comportamiento. El salto de versión refleja la ampliación de plataformas soportadas (Mistral) y el ajuste del descriptor, no un cambio de reglas.
• Paquetes dist/*.zip y dist/*.skill regenerados con el SKILL.md corregido.

[1.2] — 2026-05-31

Motivación

El paquete no se importaba como skill en Perplexity: devolvía description exceeds maximum length of 1024 characters. La causa no era el número de caracteres (1006, por debajo del límite) sino que Perplexity mide ese límite en bytes UTF-8. Al estar la descripción en español, los caracteres acentuados y la ñ ocupan 2 bytes cada uno, elevando el total a 1027 bytes. Claude.ai cuenta caracteres (o aplica un margen mayor), por lo que la importación allí nunca falló y el problema pasó desapercibido.

Cambiado

• SKILL.md — descripción del frontmatter condensada de 1027 a 912 bytes UTF-8. Se mantienen el trigger /seudonimizar, los cuatro modos (A, B, C, audit), las frases de activación en lenguaje natural y la advertencia RGPD/LOPDGDD. Se reduce el número de ejemplos redundantes y se elimina el marcado Markdown del frontmatter. La lógica del skill no se toca.

Añadido

• README.md — Opción 2: Perplexity (Skills). Instalación nativa por .zip, paralela a la de Claude.ai, con renumeración de las opciones siguientes (Claude Code → 3, Otras IA → 4) y una nota técnica sobre el límite en bytes UTF-8 para evitar la recaída al editar la descripción.

Notas

• No hay cambios de comportamiento. Una instalación previa en Claude.ai produce salidas idénticas; el salto de versión refleja la ampliación de plataformas soportadas y la documentación nueva, no un cambio de reglas.
• Paquetes dist/*.zip y dist/*.skill regenerados con el SKILL.md corregido.

[1.1] — 2026-05-11

Motivación

Tras pruebas en uso real se detectó que el skill, durante la fase de transformación, introducía ocasionalmente matices narrativos, contextualizaciones o inferencias clínicas/jurídicas que no figuraban en el texto original. El parafraseo previsto para reducir especificidad estaba añadiendo contenido. Una alucinación silenciosa en este skill contamina el razonamiento posterior (clínico, jurídico, didáctico) sin dejar rastro detectable, lo que la hace más grave que la fuga de un identificador residual.

La v1.1 endurece la regla de fidelidad al original como prioridad operativa por encima de cualquier otra transformación.

Cambiado

• flujo.md — Regla 1 transversal reescrita como prohibición estricta y prioritaria.
  • Prohíbe explícitamente introducir cualquier dato, síntoma, hecho, fecha, cuantía, argumento, diagnóstico, antecedente, circunstancia procesal o inferencia que no figure literalmente en el texto original.
  • Acota el parafraseo de los pasos 3.4 y 4: solo puede reducir especificidad, nunca añadir matices ni "redondear" la narrativa.
  • Regla operativa explícita: ante la duda entre rellenar y omitir, omitir prevalece.
• SKILL.md — Preámbulo reforzado y bump a v1.1.
  • La sección "Por qué este skill" detalla los marcadores y la regla de omisión preferente.
  • "Para qué sirve" añade el Control de fidelidad como cuarto entregable obligatorio de la salida.

Añadido

• Marcador [DATO_ELIMINADO] como convención formal para eliminar un dato del original sin sustituirlo (distinto de [NO_CONSTA], que se reserva para datos del original cuya lectura es ambigua).
• Bloque obligatorio "Control de fidelidad" en el paso 5 de flujo.md. Tras la auditoría de riesgo residual y antes de las decisiones por defecto. Fuerza al modelo a declarar si hay elementos sin correspondencia en el original y a listarlos si los hay. Actúa como auto-control explícito.
• Comprobación 7 en auditoria.md (modo audit): fidelidad al original. Condicional al aporte del texto original junto al seudonimizado. Si no se aporta, se marca No aplicable honestamente. Una fuga en esta comprobación escala el nivel de riesgo a alto automáticamente.

Notas

• La instalación del paquete .skill queda inalterada: misma estructura, mismo trigger /seudonimizar, mismos cuatro modos (A, B, C, audit).
• Los marcadores [DATO_ELIMINADO] y [NO_CONSTA] no aparecen en plantilla-tokens.md (que cataloga seudónimos de personas, lugares y entidades) sino que son convenciones del flujo. No requieren actualización del catálogo de tokens.
• Pendiente: validar empíricamente con casos reales si la nueva instrucción reduce las alucinaciones detectadas. Si persisten, considerar añadir un paso 0 de extracción literal de hechos antes de transformar.

[1.0] — 2026-05-09

Añadido

• Descriptor inicial del skill con cuatro modos: A (clínico), B (jurídico), C (generalización extrema), audit (auditoría de texto ya seudonimizado).
• Flujo operativo de seis pasos con reglas duras transversales.
• Catálogo de tokens con convenciones de etiquetado consistente.
• Protocolo de auditoría con seis comprobaciones y rúbrica de riesgo residual.
• Plantilla de entrada para el usuario.
• Marco normativo en SKILL.md: distinción RGPD entre seudonimización (Art. 4.5) y anonimización (Considerando 26).
• Documentación pública: README con tres opciones de instalación (Claude.ai, Claude Code, otras IAs) y guía profesional en PDF.
• Licencia CC BY 4.0.

Probado

• Caso clínico depresivo con consumo de sustancias (modo A).
• Caso jurídico civil de responsabilidad contractual con cuantías relevantes (modo B).
• Caso jurídico penal con elementos mediáticos para someter el modo C a tensión.

Pendiente

• Validación con casos reales por profesionales habilitados.
• Pruebas de encadenamiento con /cie11-formulacion-clinica, /dsm-formulacion-clinica y /codigo-civil-formulacion-juridica.
• Calibrado para población infanto-juvenil.
• Catálogo de tokens ampliado para jurisdicción mercantil técnica y casos administrativos complejos.