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-discover

프로젝트에서 위키에 넣을 만한 문서를 찾아서, .wiki/에 복사하고 컨텍스트에 올릴지 제안하는 스킬이다.

사전 요구

#	검증	실패 시
1	CWD가 Git 레포	"Git 레포에서만 동작합니다"
2	CWD에 .wiki 심볼릭 링크 존재	"/wiki 스킬로 위키 환경을 먼저 구성해주세요"
3	.wiki/wiki-manifest.yaml 존재	"매니페스트가 없습니다"

CLI 명령

dot-wiki discover

이 명령은:

1. .wiki/ 하위에서 매니페스트에 등록되지 않은 문서를 찾는다
2. 최근 git 변경에서 새로 추가된 문서를 찾는다
3. 후보 목록을 출력한다

워크플로우

0. 사용자가 직접 파일을 지정한 경우 (우선 경로)

사용자가 특정 파일 경로를 제공하거나 "이 파일 등록해줘"라고 요청한 경우, discover를 건너뛰고 바로 해당 파일을 처리한다.

1. 파일이 존재하는지 확인
2. .wiki/ 하위 적절한 디렉토리에 복사
3. AskUserQuestion 도구를 사용하여 원본 처리 확인:
   • question: "원본 파일({원본 경로})을 어떻게 할까요?"
   • options:
     • label: "유지", description: "원본을 프로젝트에 그대로 둠"
     • label: "삭제", description: "위키에 복사했으므로 원본 삭제"
4. AskUserQuestion 도구를 사용하여 컨텍스트 등록 확인:
   • question: "이 문서를 어디에 등록할까요?"
   • options:
     • label: "pinned (상시)", description: "항상 에이전트가 인식"
     • label: "context (현재 작업용)", description: "지금 작업에만 필요"
     • label: "등록 안 함", description: "위키에 복사만 하고 컨텍스트에는 올리지 않음"
5. 선택에 따라 dot-wiki context add 또는 dot-wiki context pin으로 등록

1. 자동 스캔 모드

사용자가 특정 파일을 지정하지 않은 경우 dot-wiki discover를 실행한다.

2. 후보 판단 (에이전트)

CLI가 출력한 후보 목록에 대해:

1. 파일 내용을 읽고 위키에 넣을 가치가 있는지 판단
2. .wiki/ 하위 적절한 디렉토리를 추론 (SDLC 단계별)

3. 후보 제안

AskUserQuestion의 multiSelect 옵션을 사용하여 후보를 제안:

• question: "위키에 넣을 문서를 선택해주세요"
• multiSelect: true
• options: 각 후보 파일
  • label: "{파일명}", description: "→ .wiki/{추론된 경로}"

4. 처리 실행

선택된 파일에 대해:

1. .wiki/ 하위에 복사
2. 원본 유지/삭제 선택 (AskUserQuestion)
3. dot-wiki context add로 등록