Sincronizar skills vendorizados com upstream
Pré-requisitos: CLI gh autenticada. Execute tudo a partir da raiz do repositório.
Fluxo de trabalho
-
Execute
node scripts/skills-sync.mjs status. Estados e o que fazer:up-to-date— nada a fazer.local— skill próprio, sem upstream; nada a sincronizar.upstream-updated— avanço rápido seguro:node scripts/skills-sync.mjs pull <plugin>/<skill>.locally-modified— editamos desde a última linha de base. Se as edições forem intencionais,node scripts/skills-sync.mjs accept <plugin>/<skill>.diverged— ambos os lados mudaram: mesclar manualmente (seção abaixo).fetch-error (...)— upstream inacessível ou movido; verifiquesource/skillPathnoskills-lock.jsondo plugin em relação ao repositório upstream.
-
Após todas as alterações:
node scripts/skills-sync.mjs verify, depois faça commit com uma mensagem que liste quais skills foram puxados ou mesclados e de quais commits upstream.
Mesclagem manual para skills divergentes
Nunca sobrescreva cegamente um skill divergente — pull --force descarta nossas personalizações.
node scripts/skills-sync.mjs diff <plugin>/<skill>— diff completo, vendorizado → upstream.- Identifique quais diferenças são personalizações INTENCIONAIS nossas
(
git log -p -- <plugin>/skills/<skill>mostra como a cópia vendorizada evoluiu) versus melhorias genuínas do upstream. - Edite os arquivos vendorizados para incorporar as melhorias do upstream preservando cada personalização local. Leia ambas as versões completamente antes de editar.
- Refaça a linha de base de AMBOS os lados:
node scripts/skills-sync.mjs seed <plugin>/<skill>(acceptapenas refaz a linha de base do hash vendorizado e deixaria o skill permanentemente marcado como atualizado pelo upstream).