Cómo traer la última versión de "crowdar-qa-skills"

Esta guía te explica paso a paso cómo actualizar tu copia local del repositorio crowdar-qa-skills cada vez que el equipo técnico suba una nueva funcionalidad, un cambio o un arreglo (fix) a la rama principal main.

1. ¿Por qué tengo que hacer esto?

El repositorio crowdar-qa-skills vive en GitLab, en un servidor compartido por todo el equipo. Cuando alguien sube una mejora (una skill nueva, un playbook corregido, un ajuste de configuración), esa mejora queda guardada ahí, en GitLab — no llega sola a tu computadora.

Pensalo como una carpeta compartida en la nube: si un compañero agrega un archivo nuevo, a vos no te aparece automáticamente en tu copia local hasta que la "sincronizás". En Git, esa sincronización se llama hacer un pull ("traer" los cambios).

En resumen: si no repetís este proceso de vez en cuando, vas a seguir trabajando con una versión vieja de las skills y los playbooks, sin las mejoras ni los arreglos que ya están disponibles.

2. ¿Cuándo tengo que hacer esto?

Hacé este proceso cada vez que:

Situación	Ejemplo
El equipo técnico avisa que subió una mejora o un fix	"Ya está arreglado el problema del playbook de regresión, actualizá tu copia"
Vas a arrancar a trabajar después de unos días sin tocar el proyecto	Empezás el día y querés asegurarte de tener todo al día antes de usar el asistente
Notás que una skill o un playbook no se comporta como te lo explicaron en una guía nueva	Puede ser que tu copia local todavía no tenga ese cambio

¡IMPORTANTE! Este proceso asume que ya tenés el repositorio crowdar-qa-skills descargado (clonado) en tu computadora, dentro de VSCode. Si es la primera vez y todavía no lo tenés, mirá el punto 6 antes de seguir.

3. Antes de arrancar: lo que necesitás tener a mano

No hace falta saber programar, pero sí tener esto:

Dato	Detalle
VSCode abierto con la carpeta del proyecto `crowdar-qa-skills`	Es el editor que se usa junto con Claude Code
Conexión a la red/VPN de la empresa, si el acceso a GitLab lo requiere	Sin esto, no vas a poder conectarte al repositorio

4. Paso a paso (con VSCode, sin usar la terminal)

Esta es la forma recomendada si no te sentís cómodo/a usando comandos.

Paso 1 — Abrir el panel de "Control de código fuente"

En el margen izquierdo de VSCode, hacé clic en el ícono que parece una rama con puntitos (Source Control / Control de código fuente).

Paso 2 — Confirmar que estás sobre la rama `main`

Mirá la barra azul en la esquina inferior izquierda de VSCode. Ahí vas a ver el nombre de la rama en la que estás parado/a (por ejemplo, main o el nombre de otra rama).

Si ya dice main, seguí al Paso 3.
Si dice otra cosa, hacé clic ahí, y en la lista que aparece arriba elegí main.

Paso 3 — Traer los cambios ("Pull")

Todavía en la barra azul inferior, vas a ver un ícono con dos flechas circulares (🔄) junto al nombre de la rama. Hacé clic en ese ícono.

Alternativa: en el panel de "Control de código fuente" (Paso 1), hacé clic en los tres puntitos (...) de arriba y elegí Pull.

VSCode se va a conectar a GitLab, va a revisar si hay algo nuevo, y si lo hay, lo va a descargar y aplicar solo, sin que tengas que hacer nada más.

Paso 4 — Confirmar que se actualizó

Una notificación breve suele aparecer abajo a la derecha confirmando la descarga. También podés confirmarlo revisando el historial: hacé clic derecho sobre cualquier archivo del proyecto en el explorador de VSCode y elegí "View Timeline", o abrí la pestaña de commits recientes en GitLab (ver punto 8) y compará la fecha del último commit.

5. Alternativa: por terminal (para quien se sienta cómodo/a)

Si preferís usar la terminal integrada de VSCode (Ctrl + ñ o Ctrl + j o menú Terminal > New Terminal), los mismos cuatro pasos anteriores se resumen en dos comandos, parados dentro de la carpeta del proyecto:

git checkout main
git pull

El primer comando te asegura que estás sobre la rama main; el segundo trae y aplica los cambios nuevos.

6. Si todavía no tenés el repositorio en tu computadora

Si esta es la primera vez que vas a trabajar con crowdar-qa-skills y todavía no lo descargaste, hacé esto una única vez:

Abrí VSCode.
Presioná Ctrl + Shift + P para abrir la paleta de comandos, escribí "Git: Clone" y elegilo.
Pegá esta dirección cuando te la pida: https://gitlab.crowdaronline.com/lippia/products/neo/crowdar-qa-skills.git
Elegí en qué carpeta de tu computadora querés guardarlo.
Cuando termine, VSCode te va a preguntar si querés abrir esa carpeta — elegí "Open".

A partir de ahí, ya podés seguir el punto 4 de esta guía cada vez que quieras traer novedades.

7. Problemas comunes (y qué hacer)

Lo que ves	Por qué puede pasar	Qué hacer
VSCode avisa que tenés "cambios locales" o "uncommitted changes" y no deja hacer el Pull	Modificaste algún archivo del proyecto y no lo guardaste (commiteaste) todavía	Guardá esos cambios primero (hacé un commit) o descartalos si no los necesitás, antes de repetir el Paso 3. Si no estás seguro/a de qué hacer, consultá al equipo técnico antes de descartar nada
Aparece un mensaje de "conflicto" (merge conflict)	Un archivo fue modificado tanto en tu copia local como en GitLab, en las mismas líneas	Esto requiere revisión manual — avisá al equipo técnico, no lo resuelvas a ciegas
El Pull tira error de conexión o de permisos	No tenés VPN activa, o tu usuario no tiene acceso al repositorio	Verificá tu conexión de red/VPN, y si el error persiste, pedile acceso al equipo técnico
No ves ningún ícono de rama en la barra inferior	La carpeta abierta en VSCode no es un repositorio de Git (o no es la carpeta correcta)	Confirmá que abriste la carpeta de `crowdar-qa-skills` clonada, no una subcarpeta ni una copia suelta

8. Ver los cambios directamente en GitLab (sin descargar nada)

Si solo querés ver qué cambió, sin bajarlo todavía a tu computadora, podés revisar el historial directo en el navegador, en:

https://gitlab.crowdaronline.com/lippia/products/neo/crowdar-qa-skills/-/commits/main

Ahí vas a ver la lista de cambios subidos a main, con fecha, autor y una breve descripción de cada uno.

9. Resumen visual del flujo

Alguien avisa que hay novedades en crowdar-qa-skills
            │
            ▼
Abrir VSCode → panel de Control de código fuente
            │
            ▼
Confirmar que estás en la rama "main"
            │
            ▼
Hacer clic en el ícono de Pull (🔄)
            │
            ▼
Copia local actualizada con las últimas skills y playbooks

10. Repositorio en GitLab

El repositorio crowdar-qa-skills se encuentra en:

https://gitlab.crowdaronline.com/lippia/products/neo/crowdar-qa-skills

Ahí podés ver el código, la documentación, el historial de commits y clonarlo si todavía no lo tenés (ver punto 6).

Versión actual de este manual: v1.0.0