AIDiyTeams/tomako-dev-skills

Habilidad de Extracción de Todos los Repositorios de Tomako

Palabras clave: $pull-all / $extraer / $extraer código, extraer todos o repositorios específicos.

Convención del Área de Trabajo (tomako-workspace)

Abrir Cursor en el directorio raíz de tomako-workspace y ejecutar todos los comandos desde allí (no hacer cd a tomako-dev-skills para ejecutar):

cd /ruta/a/tomako-workspace
./tomako-dev-skills/scripts/pull-all.sh pull

tomako-workspace/
├── Tomako/
├── Tomako-portal/
├── Skills-OL/
├── tomako-dev-skills/
└── Tomako2/          # Repositorio personal: extracción individual con --repo Tomako2

Selección de un Solo Repositorio

Para extraer solo repositorios específicos, usa --repo (los alias son los mismos que en push-all: frontend, portal, dev-skills, etc.):

./tomako-dev-skills/scripts/pull-all.sh pull --repo Tomako
./tomako-dev-skills/scripts/pull-all.sh pull --repo portal

Repositorios Cubiertos

Tomando como base el directorio raíz de tomako-workspace, se procesan por defecto los siguientes repositorios git (se omiten si no existen):

Directorio	Descripción
Tomako/	Frontend
Tomako-portal/ o cibos-portal/	Backend (uno de los dos)
Skills-OL/	Skills en línea
tomako-dev-skills/	Este repositorio de skills

Si los nombres de directorio difieren, se pueden sobrescribir con variables como LOCAL_FRONTEND_DIR. Para incluir repositorios como Tomako2, cc-connect, etc., en la extracción completa predeterminada, configura EXTRA_GIT_REPOS="Tomako2 cc-connect".

Protocolo de Ejecución

1. Directorio de trabajo = raíz de tomako-workspace
2. Primero ejecuta status para conocer el estado de cada repositorio (opcional)
3. Luego ejecuta pull para obtener lo último del remoto; si hay cambios sin confirmar, por defecto se hace stash → pull/rebase → stash pop automáticamente, sin marcar el repositorio como omitido
4. Si entre los repositorios procesados se encuentra tomako-dev-skills/ y la extracción fue exitosa sin conflictos, el script ejecutará automáticamente ./tomako-dev-skills/install.sh, para que los skills nuevos o actualizados queden inmediatamente disponibles en el agente

Comandos Comunes

# Ver ramas, adelantos/atrasos y cambios sin confirmar de cada repositorio
./tomako-dev-skills/scripts/pull-all.sh status

# Extraer todo (por defecto con rebase; si hay cambios sin confirmar, autostash por defecto)
./tomako-dev-skills/scripts/pull-all.sh pull

# Deshabilitar autostash: falla si hay cambios sin confirmar y lista los archivos
AUTOSTASH=0 ./tomako-dev-skills/scripts/pull-all.sh pull

# Extraer solo el repositorio de skills; tras éxito, instala automáticamente por defecto
./tomako-dev-skills/scripts/pull-all.sh pull --repo tomako-dev-skills

# Escenario especial: evitar instalación automática después de extraer
AUTO_INSTALL_DEV_SKILLS=0 ./tomako-dev-skills/scripts/pull-all.sh pull --repo tomako-dev-skills

Plantilla de Ejecución para el Agente

Cuando el usuario diga $pull-all:

./tomako-dev-skills/scripts/pull-all.sh status
./tomako-dev-skills/scripts/pull-all.sh pull

El flujo predeterminado ya protege los cambios locales sin confirmar y continúa con la extracción; no omitas repositorios porque el área de trabajo esté sucia.

Cuando el usuario diga «extraer skills», «extraer tomako-dev-skills»:

./tomako-dev-skills/scripts/pull-all.sh status --repo tomako-dev-skills
./tomako-dev-skills/scripts/pull-all.sh pull --repo tomako-dev-skills

Tras el segundo paso, se ejecuta automáticamente ./tomako-dev-skills/install.sh; el agente no necesita ejecutarlo por separado.

Conflictos y Excepciones

• Cambios sin confirmar: Por defecto se hace stash automático, se extrae y luego se restaura; solo falla y lista archivos si se establece explícitamente AUTOSTASH=0
• Conflicto durante pull/rebase: El script lista las rutas completas de los archivos en conflicto, no los resuelve automáticamente; informa al usuario para que los resuelva manualmente y luego vuelva a ejecutar $pull-all o $push-all
• Conflicto durante stash pop: El script lista las rutas completas de los archivos en conflicto; informa al usuario para que resuelva esos conflictos primero y luego ejecute $push-all para confirmar
• Fallo en instalación de tomako-dev-skills: El script marca el fallo y conserva la salida de install.sh; normalmente es porque ya existe una copia local divergente que el usuario debe migrar o eliminar antes de reintentar
• Repositorio inexistente: Se omite automáticamente sin error

Requisitos de Respuesta Antes de Entregar

Resumir el resultado de cada repositorio: actualizado / sin necesidad de actualizar / instalado automáticamente / fallido; si hay conflictos, listar las rutas completas de los archivos. Solo usar «omitido» cuando el repositorio no exista, no se pueda identificar la rama, o en escenarios no operativos.

Relacionados

• Enviar cambios: skills/push-all/SKILL.md ($push-all / $confirmar)
• Resolución de rutas: scripts/lib/workspace-paths.sh