NanoClaw 업스트림 업데이트 도우미
커스터마이징한 NanoClaw 포크에 업스트림 변경사항을 안전하게(백업·충돌 미리보기·검증 포함) 병합해 주는 스킬입니다.
개발·코딩고급★ 30,471⑂ 12,865AI 점수 7/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
/update-nanoclaw 명령으로 실행되는 업스트림 동기화 런북입니다.
- 사전 점검: 작업 트리가 깨끗한지 확인하고,
upstream리모트가 없으면 URL을 물어 추가한 뒤main/master브랜치를 자동 판별합니다. - 안전망: 작업 전에 타임스탬프가 붙은 백업 브랜치와 태그(
pre-update-<hash>-<시각>)를 만들어 언제든 되돌릴 수 있게 합니다. - 미리보기:
git log/git diff로 업스트림 변경 파일을 스킬·호스트 소스·컨테이너·빌드 설정·버전 핀 등으로 분류해 보여줍니다. - 경로 선택: 전체 병합(기본), 원하는 커밋만 cherry-pick, rebase, 또는 미리보기만 보고 중단 중에서 고를 수 있습니다.
- 충돌 처리:
git merge --no-commit --no-ff드라이런으로 충돌 파일을 먼저 보여주고, 실제 병합 시에는 충돌 파일만 열어 마커만 정리합니다(불필요한 리팩터링 금지). - 검증과 후속 작업:
pnpm run build/pnpm test, 필요 시 컨테이너 타입체크와 이미지 빌드/pull, 락파일 변경 시 의존성 설치, CHANGELOG의[BREAKING]항목 마이그레이션, 스킬 업데이트 연계, 업그레이드 마커 기록, 마지막으로 롤백 명령과 서비스 재시작 안내까지 이어집니다.
토큰 절약을 위해 충돌이 실제로 발생한 파일만 여는 것을 원칙으로 삼습니다.
이런 분께 추천
- NanoClaw를 포크해서 자기 환경에 맞게 고쳐 쓰는 운영자
- 업스트림을 따라가고 싶지만 재설치 없이 내 수정사항을 지키고 싶은 분
- 병합 전 무엇이 충돌할지 먼저 확인하고, 실패하면 즉시 되돌릴 수 있는 절차를 원하는 분
활용 예시
- 정기 동기화:
/update-nanoclaw실행 → 업스트림 커밋 목록과 변경 파일 분류를 확인 → 충돌 없음이 확인되면 전체 병합 후pnpm run build까지 자동 검증. - 핫픽스만 가져오기: 미리보기에서 필요한 버그픽스 커밋 해시 2개만 골라 cherry-pick, 나머지 실험적 변경은 그대로 남겨두기.
- 문제 발생 시 롤백: 병합 후 빌드가 깨졌다면 요약에 출력된
git reset --hard pre-update-<hash>-<시각>한 줄로 이전 상태 복구.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/update-nanoclaw 폴더를 내 ~/.claude/skills/update-nanoclaw/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw && mkdir -p ~/.claude/skills && cp -r /tmp/nanoclaw/.claude/skills/update-nanoclaw ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 원하는 위치에서 저장소를 클론합니다:
git clone https://github.com/nanocoai/nanoclaw.git - 스킬 폴더가 없다면 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r nanoclaw/.claude/skills/update-nanoclaw ~/.claude/skills/ - 이미 NanoClaw를 포크해 쓰고 있다면, 별도 복사 없이 그 프로젝트 폴더 안의
.claude/skills/update-nanoclaw를 그대로 사용해도 됩니다. - Claude Code를 NanoClaw 프로젝트 루트에서 실행합니다.
- 실행 전 반드시
git status로 변경사항을 커밋 또는 stash 하세요(작업 트리가 더러우면 스킬이 중단됩니다). /update-nanoclaw를 입력하고, 질문에 따라 병합 방식을 선택합니다.- 문제가 생기면 마지막 요약에 표시된 백업 태그로
git reset --hard <태그>하여 되돌립니다.
GitHub에서 원본 보기 ↗라이선스: MIT