push

source를 커밋하고 git remote로 push합니다.

push하지 않고 로컬 체크포인트만 원한다면 commit을 대신 사용하세요.

skillshare push                  # 자동 생성된 메시지
skillshare push -m "Add pdf"     # 커스텀 메시지
skillshare push --pull           # remote 변경 사항 병합 후 push, 그다음 sync
skillshare push --dry-run        # 미리보기

언제 사용하나요

• git을 통해 다른 머신들과 skill 변경 사항을 공유할 때
• skill을 remote repository에 백업할 때
• skill을 수정한 후 하나의 명령으로 커밋과 push를 함께 할 때

아직 공유하지 않고 로컬 체크포인트만 저장하고 싶다면 skillshare commit을 사용하세요.

동작 과정

옵션

플래그	설명
-m, --message <msg>	커밋 메시지 (기본값: "Update skills")
--pull	push 전에 remote 변경 사항을 병합한 뒤 target을 sync (Push와 Pull 함께 하기 참고)
--dry-run, -n	변경 사항을 적용하지 않고 미리보기

Git Root Scope

push는 git_root 설정 필드로 선택된 디렉터리(기본값: skills source)에서 동작합니다. scope 표는 commit — Git Root Scope를 참고하세요. git_root가 변경되었지만 git repo가 여전히 다른 scope의 디렉터리에 있는 경우, push는 이를 해결하기 위한 정확한 git init / mv 명령과 함께 "Git root mismatch" 오류를 출력합니다. Changing the scope after init를 참고하세요.

git_root: root에서 아직 push하지 않은 commit이 config.yaml 또는 config.yaml/ 아래 파일을 추가하거나 수정했다면, 이후 commit에서 삭제했더라도 push는 거부됩니다. --pull과 --dry-run에도 적용되며 staging이나 pull 전에 검사합니다. dry-run은 아무것도 변경하지 않습니다. 오류에는 해당 commit hash가 표시됩니다. push가 보내는 remote(upstream remote, 첫 push 전에는 origin)의 어떤 ref에도 포함되지 않은 commit을 아직 push하지 않은 것으로 보므로, 그 remote에 이미 있는 history는 거부되지 않습니다. push는 push.default나 remote.pushDefault와 관계없이 항상 현재 branch만 그 remote로 보냅니다.

다시 시도하기 전에 해당 commit에서 파일을 제거하세요. 오류에 표시된 git rebase -i <commit>(가장 오래된 해당 commit 바로 앞에서 시작합니다)로 해당 commit을 편집 대상으로 지정하고, 각 편집에서 git rm -r --cached -- config.yaml, git commit --amend, git rebase --continue를 실행하세요. Skillshare는 history를 자동으로 다시 쓰지 않습니다. 이미 공개된 config.yaml의 추적만 중단하는 commit은 push할 수 있습니다. 아직 push하지 않은 추가 commit 뒤에 삭제 commit을 만들어도 이전 내용은 history에 남습니다.

사전 준비 사항

source 디렉터리는 remote가 설정된 git repository여야 합니다.

# init 시점에 설정 (권장):
skillshare init --remote [email protected]:you/my-skills.git

# 또는 기존 설정에 remote 추가:
skillshare init --remote [email protected]:you/my-skills.git

Init은 초기 커밋을 자동으로 생성하므로, 설정 직후 바로 push가 동작합니다.

첫 Push 시 Upstream 매핑

첫 push 시(아직 upstream 트래킹이 없는 경우), skillshare push는 자동으로 upstream을 구성합니다.

• remote에 이미 기본 브랜치(예: main 또는 trunk)가 있는 경우, 로컬 변경 사항은 해당 remote 기본 브랜치로 push됩니다.
• remote가 비어 있는 경우, 현재 로컬 브랜치로 push됩니다.

이는 잘못된 remote 브랜치가 생성되는 것(예: remote는 main을 사용하는데 로컬은 master인 경우)을 방지합니다.

예시

# 자동 메시지로 빠르게 push
skillshare push

# 커스텀 커밋 메시지
skillshare push -m "Add commit-commands skill"

# push될 내용을 미리보기
skillshare push --dry-run

충돌 처리

remote에 더 새로운 커밋이 있는 경우:

$ skillshare push
✗ Push failed
  Remote may have newer changes

Next
  skillshare pull  get them first
  skillshare push  then push again

해결 방법:

skillshare pull    # remote 변경 사항을 내 변경 사항과 병합
skillshare push    # 내 변경 사항 push

pull은 remote 커밋을 아직 push하지 않은 내 커밋과 병합하므로, 두 번째 push는 성공합니다. 양쪽에서 같은 파일을 변경한 경우의 동작은 두 머신 모두 커밋한 경우를 참고하세요.

Push와 Pull 함께 하기

skillshare push --pull은 전체 왕복 과정을 명령 하나로 처리합니다:

1. 로컬 변경 사항을 커밋합니다 (있는 경우)
2. pull과 같은 방식으로 remote의 새 커밋을 병합합니다
3. 결과를 push합니다
4. pull처럼 git root scope에 포함된 항목에 대해 target을 sync합니다

병합 중 충돌이 발생하면 아무것도 push되지 않고 target도 sync되지 않습니다. 변경 사항은 로컬에 커밋된 상태로 남아 있으니, 충돌을 해결한 뒤 skillshare push --pull을 다시 실행하세요. push는 성공했지만 target sync가 실패한 경우에는 remote가 이미 업데이트되었으므로 출력된 skillshare sync ... --global 명령(git_root에 맞는 리소스별 명령)을 실행해 다시 시도하세요.

git_root: root에서 병합으로 remote가 추적하는 config.yaml이 들어오면, push --pull은 이 머신의 사본을 유지하고 같은 push에서 remote의 config.yaml을 제거합니다.

--pull은 rebase도, force-push도 하지 않습니다.

워크플로우

skill을 공유하는 일반적인 워크플로우:

# 1. skill 변경
# 2. remote로 push
skillshare push -m "Update my-skill"

# 다른 머신에서:
skillshare pull    # 변경 사항을 가져오고 동기화

참고 항목

• commit — push 없이 로컬 커밋
• pull — remote에서 pull
• sync — 로컬 target에 동기화
• Cross-Machine Sync — 전체 설정 가이드