벤더링된 스킬을 업스트림과 동기화
전제 조건: gh CLI가 인증되어 있어야 함. 모든 작업은 리포지토리 루트에서 실행.
워크플로
-
node scripts/skills-sync.mjs status실행. 상태 및 처리 방법:up-to-date— 할 일 없음.local— 자체 스킬, 업스트림 없음; 동기화할 필요 없음.upstream-updated— 안전한 fast-forward:node scripts/skills-sync.mjs pull <plugin>/<skill>.locally-modified— 마지막 기준선 이후 수정됨. 수정이 의도적이라면node scripts/skills-sync.mjs accept <plugin>/<skill>.diverged— 양쪽 모두 변경됨: 수동 병합 필요(아래 절 참조).fetch-error (...)— 업스트림에 접근할 수 없거나 이동됨; 플러그인의skills-lock.json에서source/skillPath를 업스트림 리포지토리와 확인.
-
모든 변경 후:
node scripts/skills-sync.mjs verify를 실행한 다음, 어떤 스킬을 가져오거나 병합했는지와 업스트림 커밋을 명시하는 커밋 메시지로 커밋.
분기된 스킬의 수동 병합
분기된 스킬을 절대 맹목적으로 덮어쓰지 마세요 — pull --force는 사용자 정의를 폐기합니다.
node scripts/skills-sync.mjs diff <plugin>/<skill>— 전체 차이점 표시, 벤더링된 버전 → 업스트림.- 어떤 차이점이 의도적인 사용자 정의인지 식별 (
git log -p -- <plugin>/skills/<skill>는 벤더링된 복사본이 어떻게 진화했는지 보여줌) 대 진정한 업스트림 개선. - 모든 로컬 사용자 정의를 보존하면서 업스트림 개선 사항을 통합하도록 벤더링된 파일을 편집. 편집 전에 두 버전을 모두 완전히 읽음.
- 양측 모두 재기준:
node scripts/skills-sync.mjs seed <plugin>/<skill>(accept는 벤더링된 해시만 재기준하여 스킬이 영구적으로 upstream-updated로 표시됨).