wiki-link

기존 위키 저장소를 현재 프로젝트에 심볼릭 링크로 연결하는 스킬이다.

사전 요구

조건	처리
CWD가 Git 저장소가 아님	안내 후 중단
CWD에 .wiki 심볼릭 링크가 이미 존재	현재 연결 대상을 보여주고 중단

워크플로우

1. 위키 소스 확인

사용자에게 질문한다: "위키 저장소의 경로 또는 git remote URL을 알려주세요"

입력값을 판별한다:

• https://, git@, .git으로 끝나는 문자열 → git remote URL (2-B로)
• 그 외 → 로컬 경로 (2-A로)

2-A. 로컬 경로인 경우

1. 경로가 존재하는지 확인한다. 없으면 안내 후 중단
2. wiki-manifest.yaml이 있는지 확인한다
   • 없으면 경고: "매니페스트가 없는 디렉토리입니다. 위키가 맞나요?"
   • 사용자가 계속 진행을 원하면 이어서 진행한다
3. 절대 경로로 변환한다
4. 심볼릭 링크 생성 단계(3)로 진행한다

2-B. git remote URL인 경우

1. URL에서 저장소 이름을 추출한다 (예: my-wiki.git → my-wiki)
2. 기본 clone 위치를 결정한다: CWD의 상위 디렉토리 (../)
3. 사용자에게 확인한다: "{상위폴더}/{repo-name}에 clone할까요? 다른 경로를 원하시면 알려주세요"
4. git clone 실행한다
5. clone된 디렉토리의 절대 경로를 확보한다
6. 심볼릭 링크 생성 단계(3)로 진행한다

3. 심볼릭 링크 생성

1. 프로젝트 루트에 .wiki 심볼릭 링크를 생성한다
   • OS와 셸 환경에 따라 명령이 다르다. references/symlink-guide.md를 참고하여 적절한 명령을 사용한다
   • 반드시 절대 경로를 사용한다. 상대 경로는 CWD 변경 시 깨질 수 있다
2. 생성 후 검증한다: .wiki/wiki-manifest.yaml을 읽어본다
   • 성공하면 다음 단계로
   • 실패하면 링크를 삭제하고 오류를 안내한다

4. .gitignore 등록

1. .gitignore에 .wiki가 등록되어 있는지 확인한다
2. 없으면 .gitignore 끝에 .wiki를 추가한다
3. .gitignore 파일 자체가 없으면 새로 생성한다

5. 결과 안내

연결 완료 메시지를 출력한다:

• 심볼릭 링크 경로: .wiki → {절대경로}
• 매니페스트 상태: 있음/없음

안전성 규칙

• 심볼릭 링크는 반드시 절대 경로로 생성한다
• 실제 디렉토리나 파일을 삭제하지 않는다
• .wiki가 실제 디렉토리(심볼릭 링크가 아닌)인 경우, 절대 건드리지 않고 사용자에게 수동 조치를 요청한다
• clone 실패 시 불완전한 디렉토리를 정리하고 오류를 안내한다