Preamble

_DW_VER="1.0.0"
npx dot-wiki check --skill-version "$_DW_VER" 2>/dev/null || true

preamble 출력에 SKILL_UPDATE_AVAILABLE 또는 UPDATE_AVAILABLE이 있으면:

1. "dot-wiki {new} 버전이 나왔습니다 (현재 {old})" 한 줄 표시
2. 업데이트 방법: npx skills add dev-goraebap/dot-wiki --all -g
3. 현재 스킬 작업을 계속 진행

wiki-commit

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

사전 요구

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

CLI 명령

dot-wiki commit -m "commit message"

이 명령은:

1. .wiki symlink를 resolve하여 원본 위키 저장소 경로를 찾는다
2. 변경사항 확인 (없으면 종료)
3. git add -A + git commit
4. remote가 있으면 git push

워크플로우 (에이전트 판단 필요 부분)

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

remote가 설정되어 있으면:

1. git fetch origin 실행
2. 로컬 브랜치가 remote보다 뒤처져 있으면 git pull --rebase 시도
3. 충돌 발생 시:
   • wiki-manifest.yaml 충돌: pinned/context 배열은 양쪽 엔트리 모두 유지
   • 일반 문서 충돌: 사용자에게 충돌 내용을 보여주고 해결 방법 제안
   • 충돌 해결 후 매니페스트를 다시 읽어서 YAML 구조가 유효한지 확인

2. 의미 단위 커밋

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

• 같은 SDLC 단계의 문서 변경: 하나의 커밋으로 묶음
• 매니페스트 변경: 별도 커밋
• 서로 다른 SDLC 단계: 별도 커밋

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

AskUserQuestion 도구를 사용하여 커밋 전 확인한다:

• question: "다음과 같이 커밋합니다:\n1. docs: ERD 초안 추가 (design/hr-logical-erd.mmd)\n진행할까요?"
• options:
  • label: "예, 커밋하세요", description: "위 내용으로 커밋 진행"
  • label: "아니요, 취소", description: "커밋하지 않고 중단"

각 커밋에 대해 dot-wiki commit -m "message"를 실행한다.

3. 원격 push

커밋 완료 후 remote가 있으면:

• AskUserQuestion 도구를 사용하여 push 여부를 확인
• 승인 시 git push 실행 (CLI의 commit 명령이 자동으로 처리)