wiki-commit

위키 저장소의 변경사항을 의미 단위로 커밋하고, 원격 저장소가 있으면 동기화하는 스킬이다.

사전 요구

#	검증	실패 시
1	CWD에 .wiki 심볼릭 링크 존재	"/wiki 스킬로 위키 환경을 먼저 구성해주세요"
2	.wiki resolve 경로에 .git 존재	"위키 저장소가 Git으로 초기화되지 않았습니다"

워크플로우

1. 위키 저장소 경로 확인

• CWD의 .wiki 심볼릭 링크를 resolve하여 원본 경로를 얻는다
• CWD 자체가 위키 저장소이면 그대로 사용한다

2. 원격 저장소 동기화 (remote가 있을 때)

원본 위키 저장소에서:

git remote -v

remote가 설정되어 있으면:

1. git fetch origin 실행
2. 로컬 브랜치가 remote보다 뒤처져 있으면 git pull --rebase 시도
3. 충돌 발생 시:
   • wiki-manifest.yaml 충돌: documents 배열은 양쪽 엔트리 모두 유지 (append-only 원칙). profiles 섹션 충돌은 사용자에게 보여주고 선택 요청
   • 일반 문서 충돌: 사용자에게 충돌 내용을 보여주고 해결 방법 제안
   • 충돌 해결 후 YAML 파싱 검증 (매니페스트인 경우)
4. remote가 없으면 이 단계를 건너뛴다

3. 변경사항 확인

git status --short

변경사항이 없으면 "변경사항이 없습니다" 안내 후 중단.

4. 의미 단위 커밋

변경된 파일들을 분석하여 의미 단위로 나눠서 커밋한다:

• 같은 SDLC 단계의 문서 변경: 하나의 커밋으로 묶음
  • 예: planning/ 하위 파일 여러 개 변경 → docs: 기획 문서 업데이트
• 매니페스트 변경: 별도 커밋
  • 예: docs: 매니페스트에 ERD, API 명세 등록
• 서로 다른 SDLC 단계: 별도 커밋
  • 예: planning/ + design/ 동시 변경 → 2개 커밋

커밋 메시지 형식: docs: {변경 요약}

각 커밋 전에 사용자에게 확인:

"다음과 같이 커밋합니다:

1. docs: ERD 초안 추가 (design/hr-logical-erd.mmd)
2. docs: 매니페스트에 ERD 등록 (wiki-manifest.yaml)

진행할까요?"

5. 원격 push (remote가 있을 때)

커밋 완료 후 remote가 있으면:

1. 사용자에게 push 여부 확인: "원격 저장소에 push할까요?"
2. 승인 시 git push 실행
3. push 실패 시 원인 안내 (권한, 네트워크 등)

6. 결과 안내

• 커밋 수, 변경된 파일 목록
• push 결과 (해당 시)
• 현재 위키 저장소 상태 요약