Sincronizar habilidades empaquetadas con upstream
Requisitos: gh CLI autenticado. Ejecuta todo desde la raíz del repositorio.
Flujo de trabajo
-
Ejecuta
node scripts/skills-sync.mjs status. Estados y qué hacer:up-to-date— no hay nada que hacer.local— habilidad propia, sin upstream; no hay nada que sincronizar.upstream-updated— avance rápido seguro:node scripts/skills-sync.mjs pull <plugin>/<skill>.locally-modified— hemos editado desde la última línea base. Si las ediciones son intencionadas,node scripts/skills-sync.mjs accept <plugin>/<skill>.diverged— ambos lados cambiaron: fusionar manualmente (sección a continuación).fetch-error (...)— upstream inalcanzable o movido; verificasource/skillPathen el archivoskills-lock.jsondel plugin contra el repositorio upstream.
-
Después de todos los cambios:
node scripts/skills-sync.mjs verify, luego confirma con un mensaje que enumere qué habilidades se extrajeron o fusionaron y de qué commits upstream.
Fusión manual para habilidades divergidas
Nunca sobrescribas a ciegas una habilidad divergida: pull --force descarta nuestras personalizaciones.
node scripts/skills-sync.mjs diff <plugin>/<skill>— diff completo, empaquetado → upstream.- Identifica qué diferencias son NUESTRAS personalizaciones deliberadas
(
git log -p -- <plugin>/skills/<skill>muestra cómo evolucionó la copia empaquetada) frente a mejoras genuinas del upstream. - Edita los archivos empaquetados para incorporar las mejoras del upstream mientras preservas cada personalización local. Lee ambas versiones por completo antes de editar.
- Re-baselinea AMBOS lados:
node scripts/skills-sync.mjs seed <plugin>/<skill>(acceptsolo re-baselinea el hash empaquetado y dejaría la habilidad marcada permanentemente como upstream-actualizada).