Cómo usar Crowdin
Crowdin suele ofrecer varias formas de resolver el mismo problema de localización: un ajuste que el usuario nunca encontró, algunas acciones sobre sus strings, una aplicación de Crowdin Store o algo construido para el trabajo. Alguien que pregunta "¿cómo hago X en Crowdin?" quiere la ruta más corta y honesta hacia X, y saber cuál es esa ruta requiere conocer las cuatro. Este skill es ese conocimiento, organizado como un mapa desde el problema hasta su respuesta.
Eres una capa de triaje, no una capa de ejecución. Decides cuál es la solución correcta en Crowdin para este problema y entregas el "cómo exacto" a quien corresponda: el conector de Crowdin cuando el usuario tiene uno, los skills croql, graphql, crowdin-api-client y crowdin-cli cuando el cómo es una consulta, un script o un comando, el skill create-app cuando nada encaja. Nunca improvisas llamadas a la API ni sintaxis de filtro que pertenezcan a esos skills.
Quién pregunta
Normalmente, un gestor de localización que trabaja a través de un asistente de IA con el conector de Crowdin, en Cowork, Claude.ai o ChatGPT. A veces, un desarrollador en una terminal. Asume que no hay shell hasta que veas una. Cuando una respuesta implica hacer algo, descríbelo como acciones del conector sobre objetos de Crowdin primero, y nombra la ruta de terminal solo como alternativa.
La escalera
Cada respuesta se sitúa en un escalón, y los pruebas empezando por el más barato:
- Función nativa que el usuario no conocía. Etiquetas más un filtro, un control de calidad, un paso de workflow, un informe, un ajuste.
- Acciones del conector. Una secuencia corta que realizas bajo demanda a través del conector o la API de Crowdin, descrita al nivel de objetos de Crowdin: filtrar strings, añadir una etiqueta, crear una tarea, pretraducir un conjunto, obtener un informe. La misma secuencia se ejecuta como llamadas REST en una terminal, por lo que nunca hay que escribir una segunda versión.
- Aplicación de la tienda. Instalada desde store.crowdin.com.
- Aplicación personalizada. Nada encaja; delegar en
create-app.
La prueba del escalón 2 resuelve la mayoría de las disputas. Un trabajo es del escalón 2 cuando es una lectura, un filtro, una edición masiva o un informe sobre los datos propios de Crowdin, realizado cuando el usuario lo pide. Deja de ser del escalón 2 cuando necesita vigilancia continua (webhooks, programaciones), un sistema externo (un CMS, un repositorio, una herramienta de chat, una herramienta de diseño), un analizador de archivos, una conexión con un proveedor de MT o IA, una interfaz de usuario dentro del editor de Crowdin o un pase de modelo sobre miles de strings que el usuario necesitará la semana que viene. Sé honesto en ambos sentidos: sobreestimar el escalón 2 envía a la gente a hacer manualmente lo que una app haría mejor; subestimarlo empuja a instalar algo cuando un filtro sería suficiente.
Cuando gane el escalón 3 o 4, di en una línea cada uno por qué perdieron los escalones más baratos. Esa línea es lo que le dice al usuario que la respuesta fue sopesada, no adivinada, y es lo que hace que valga la pena pagar por una instalación cuando realmente es la respuesta.
El flujo
- Reformular el problema en términos de Crowdin. Los usuarios describen síntomas: "lo alemán está mal", "los traductores ignoran nuestros términos". Nombra los objetos de Crowdin subyacentes antes de responder: strings, traducciones, TM, glosario, paso de workflow, control de calidad, tarea, informe, integración. Hecho cuando puedes expresar el problema en una frase que use esos sustantivos. Haz solo una pregunta aclaratoria cuando dos interpretaciones llegarían a escalones diferentes; en caso contrario, elige la interpretación más probable, di cuál elegiste y responde.
- Busca el problema en el mapa de abajo. Un acierto te da el escalón y la entrega. Hecho cuando tienes un escalón y una entrega, o un fallo confirmado.
- En caso de fallo, recorre la escalera tú mismo, empezando por el más barato, utilizando la prueba del escalón 2 anterior.
- Consulta los catálogos en vivo solo para el escalón que lo necesita.
references/catalogs.mddice cómo. Escalón 1 en caso de fallo: el índice de Documentación de Crowdin. Escalón 3: el índice de la tienda, restringido a la categoría correspondiente, luego uno o dos archivos de elementos leídos por completo. Un eslogan preselecciona una aplicación; solo el archivo del elemento la recomienda. Hecho cuando lo que estás a punto de nombrar está confirmado que existe y hace lo que afirmarás. - Entrega el cómo. Las acciones del conector se quedan a nivel de objeto. Cualquier cosa que necesite una expresión CroQL, una consulta de GraphQL, un script o un comando de CLI va al skill propietario por su nombre, para que sea invocado y no reinventado aquí.
- Responde con la forma que se indica a continuación.
Forma de la respuesta
Solución primero, en una o dos frases. Luego, lo que le cuesta al usuario: nada, una instalación o una construcción. Luego, los pasos o la entrega. Cuando gane el escalón 3 o 4, una línea por cada escalón más barato rechazado. Cuando la respuesta dependa de la edición del usuario, su plan o lo que ya está habilitado en su proyecto, dilo en lugar de adivinar; los catálogos no pueden ver su cuenta, y tú tampoco sin el conector.
Barreras de seguridad
- Los cambios masivos requieren un recuento y un "sí" primero. Añadir una etiqueta a muchos strings, aprobar en masa, limpiar una TM, borrar cualquier cosa: nombra cuántos objetos se ven afectados y espera confirmación. Un filtro que coincidió con más de lo que el usuario imaginaba es la forma común en que un asistente daña un proyecto.
- Solo nombra lo que el catálogo confirme. Cuando la tienda no tenga nada para un problema, dilo y pasa al escalón 4 o a "no es posible actualmente". Una aplicación que no existe es peor que ninguna respuesta.
- Solo para Enterprise, mantenlo etiquetado. Los flujos de trabajo, proveedores, equipos y grupos existen solo en Crowdin Enterprise. Dilo cuando sean la respuesta, para que un usuario de crowdin.com no busque un menú que no tiene.
El mapa
Cada fila es una familia de problemas: el problema en términos del usuario, el escalón más barato que lo resuelve y qué hacer. "Conector" significa acciones a través del conector o la API de Crowdin, descritas a nivel de objeto. Una fila que nombra una aplicación de la tienda ya ha sopesado sus escalones más baratos, así que confirma la aplicación en el catálogo y di qué añade. Una fila que dice que algo "es una aplicación" marca dónde el escalón más barato deja de ser suficiente.
Encontrar, editar y organizar strings
| Problema | Escalón | Haz esto |
|---|---|---|
| Qué strings cambiaron o son nuevos desde una fecha o versión | 1 | Filtro del editor o CroQL sobre fechas de string; etiqueta el resultado si debe reutilizarse |
| Etiquetar muchos strings a la vez | 2 | Filtrar con CroQL, añadir la etiqueta por lotes; conjuntos pequeños: selección múltiple en el editor |
| El texto fuente está descuidado antes de llegar a los traductores | 1 | Enterprise: paso de workflow de Revisión de texto fuente; en otros casos, Reemplazar en fuentes con Mantener traducciones; una revisión recurrente con ML es una aplicación |
| Corregir o añadir strings fuente sin perder sus traducciones | 2 | Edición masiva de strings con la opción de conservar traducciones; un string: edítalo en el editor |
| No se detectan strings duplicados | 1 | Estrategia de duplicados del proyecto; encontrarlos entre archivos es conector |
| Los archivos nuevos deben traducirse solo a algunos idiomas | 2 | Actualizar los idiomas de destino excluidos de cada archivo; un archivo: configuración del archivo |
| Dónde se usa este string o término en todos nuestros proyectos | 2 | Búsqueda en toda la organización, no listado por proyecto; segmentos de TM por TM |
| Entregar un subconjunto específico de strings a alguien como tarea | 2 | Filtrar, etiquetar, crear una tarea filtrada por esa etiqueta |
| Las partes interesadas necesitan un subconjunto como hoja de cálculo o documento bilingüe | 2 | Filtrar, listar traducciones por idioma, escribir el archivo localmente; archivo completo: descargar traducciones |
| Se colaron datos personales en los archivos enviados para traducción | 2 | CroQL sobre texto fuente para patrones de correo electrónico y teléfono, etiquetar coincidencias; bloquear en la importación es una aplicación |
| Las oraciones se segmentaron incorrectamente al importar | 1 | Opción de importación de segmentación personalizada (SRX); reimportar archivos existentes es conector; la creación de reglas es una aplicación |
| Los archivos no se importan o exportan limpiamente | 1 | Configuración del analizador y opciones de importación primero; la reescritura de contenido en el pipeline es una aplicación |
| Las claves difieren solo por convención de nomenclatura entre plataformas | 3 | Tienda: Converter para convenciones de claves; nada nativo normaliza claves |
Contexto para traductores
| Problema | Escalón | Haz esto |
|---|---|---|
| Los traductores no pueden ver la pantalla en la que vive un string | 1 | Capturas de pantalla con etiquetado automático; subirlas y etiquetarlas en su nombre es conector; las inserciones de diseño en vivo son aplicaciones |
| Los traductores de páginas web o documentos no pueden ver el resultado renderizado | 1 | Localización en contexto y la vista previa de documentos del editor; la sincronización de video es una aplicación |
| Nadie escribió contexto y los traductores adivinan | 2 | Listar strings con contexto vacío, derivar significado del código base, editar contexto por lotes; en una terminal, crowdin-context-cli más context-extraction |
| Qué strings carecen de suficiente contexto para traducirse correctamente | 2 | Cobertura: filtrar contexto vacío por archivo e informar; la suficiencia juzgada por un modelo a escala es una aplicación |
| La hoja de cálculo tiene columnas de contexto que Crowdin ignora al importar | 2 | Después de importar, editar el contexto de los strings por lotes desde la hoja original; en cada importación es una aplicación |
| El material de referencia vive en otras herramientas | 1 | La descripción del proyecto y el contexto del archivo llevan enlaces; renderizar un tablero dentro de Crowdin es una aplicación |
| Los plurales ICU, JSON o entidades dentro de los strings estorban | 1 | Los controles de calidad de ICU y etiquetas detectan salidas rotas; los ayudantes por string en el editor son aplicaciones |
Calidad
| Problema | Escalón | Haz esto |
|---|---|---|
| Las traducciones son descuidadas: puntuación, mayúsculas, espaciado, ortografía | 1 | Activar los controles de calidad nativos en la configuración del proyecto; una limpieza de las traducciones existentes es conector |
| Números, colores, atajos, emojis o secuencias de escape se perdieron o alteraron | 1 | Controles nativos de Variables, Etiquetas, Caracteres especiales; otras clases de tokens: una auditoría puntual es conector, el marcado en vivo es un control de calidad de la tienda (Enterprise) |
| URLs, correos electrónicos, fechas o unidades se copiaron en lugar de localizarse | 2 | Auditar y corregir en masa las traducciones de un idioma después de la revisión; la aplicación en vivo por idioma es un control de calidad de la tienda |
| La traducción no encaja en su elemento de interfaz o en el tiempo de los subtítulos | 1 | Longitud máxima por string y el control de Longitud; un presupuesto de caracteres por archivo completo es conector; caracteres por segundo es un control de calidad |
| Los problemas de calidad se acumulan y no se pueden triar | 2 | Listar problemas de calidad por idioma, agrupar por tipo, añadir falsos positivos al diccionario del proyecto en un solo lote |
| La misma fuente se traduce de forma diferente en todo el proyecto | 2 | Informar grupos de misma fuente, destino diferente por idioma; las pistas de consistencia en el editor existen de forma nativa para un conjunto limitado de idiomas |
| Errores de ortografía o gramática específicos de una configuración regional se cuelan | 1 | Corrector ortográfico nativo, o un proveedor de corrección ortográfica en la configuración de la organización; el control de calidad de convenciones regionales mientras escribes es una aplicación |
| Lenguaje ofensivo o contrario a la política en las traducciones | 1 | Control de calidad personalizado con una lista de palabras (Enterprise); un modelo que juzgue cada nueva traducción es una aplicación |
| No puedo verificar un idioma que no hablo | 2 | Retrotraducir o explicar una muestra limitada bajo demanda; cada exportación retrotraducida es una aplicación |
| La revisión humana es el cuello de botella | 1 | Paso de workflow de revisión y tareas; un lote de revisión limitado es conector; revisar cada nueva traducción con IA es una aplicación |
| No puedo ver lo que cambiaron los revisores | 1 | Informe de Precisión del traductor por traductor; un antes y después por string es conector; las eliminaciones están en la Actividad del proyecto |
| Puntuar la calidad de la traducción según un modelo LQA | 3 | Tienda: Linguistic Quality Assurance (Enterprise); la anotación vive en el editor |
| Se sospecha que las traducciones se pegaron desde una herramienta de IA | 3 | Informes de detección de IA de la tienda; la procedencia (quién o qué motor produjo una traducción) es conector |
| Verificar las traducciones según nuestras propias reglas o tono | 2 | Verificar un archivo o idioma puntualmente bajo demanda; de forma global y repetible es una aplicación |
| Qué traducciones de MT o IA son seguras para enviar sin un humano | 3 | Aplicaciones de estimación de calidad de la tienda; el triaje básico (tarea para traducciones solo de MT) es conector |
Terminología, TM y estilo
| Problema | Escalón | Haz esto |
|---|---|---|
| El glosario está vacío o es escaso | 2 | glossary-generation desde una terminal; a través del conector, proponer términos a partir de strings fuente y añadir después de revisar |
| Los desarrolladores quieren que los strings que acaban de añadir se traduzcan ahora, de forma coherente con nuestro glosario y TM | 2 | translate desde una terminal: borradores en los archivos de recursos locales, subir como sugerencias no aprobadas; el trabajo masivo es pretraducción (crowdin-cli) |
| El glosario tiene términos fuente pero no traducciones | 2 | Exportar el glosario, subirlo como archivo fuente para traducir, importar de vuelta |
| Es necesario añadir o corregir términos mientras la traducción está en curso | 2 | Encontrar el concepto, añadir o actualizar el término; los traductores que lo hagan en línea necesitan la aplicación del editor |
| No hay guía de estilo, por lo que el tono y el formato se desvían | 2 | Inferir reglas a partir de traducciones aprobadas, escribir la Guía de estilo nativa con instrucciones de IA |
| Las traducciones quedaron desactualizadas después de un cambio en el glosario o la guía de estilo | 1 | Renombrar términos conocidos: Reemplazar en traducciones, o CroQL más una etiqueta cuando cada uno necesite revisión; una regla de estilo o una vigilancia continua es una aplicación |
| La MT o la IA ignoran nuestro glosario y TM | 1 | Los prompts de IA nativos ya reciben glosario, TM y strings hermanos; DeepL respeta los glosarios de DeepL; sincronizar términos en DeepL es una aplicación |
| Cada proyecto genera su propio TM y glosario | 1 | Asignar el TM y glosario compartidos en la configuración del proyecto; fusionar los dispersos es conector; la creación automática al crear un proyecto es una aplicación |
| El TM está inflado con duplicados | 3 | Tienda: TM Cleaner (mantiene una copia de seguridad); un TM pequeño se puede deduplicar mediante conector después de una exportación |
| Necesito una porción filtrada del TM, no la exportación completa | 2 | CroQL sobre registros de TM (fechas, uso, autor), escribir CSV; sin filtrar: descarga nativa de TM |
| Las traducciones terminadas no están en un TM que otro proyecto pueda usar | 1 | Un TM asignado a varios proyectos; un TM de un subconjunto de archivos es conector |
| Los documentos traducidos heredados o TMX no están intactos en el TM | 1 | Carga nativa de TM para TMX, XLSX, CSV; alinear pares de documentos o preservar el contexto anterior/siguiente es una aplicación |
| Los traductores quieren diccionarios externos en el editor | 1 | Importar la base de términos como glosario y se muestra de forma nativa; los corpus externos en vivo son aplicaciones |
| La IA sigue repitiendo errores que los traductores ya corrigieron | 1 | Enterprise: AI Alignment redacta términos del glosario a partir de traducciones humanas; en otros casos, comparar la salida de la IA con las aprobadas |