메뉴
Vault Intelligence System (vis) CLI를 활용한 Obsidian vault 시맨틱 검색, 자동 태깅, MOC 생성, 관련 문서 연결, 주제별 문서 연결, 주제 수집, 태그 통계, 지식 공백 분석, 중복 감지, 학습 리뷰 등 vault 지식 관리 전반을 지원하는 skill. vault 검색, 문서 정리, 태그, MOC, 관련 문서, 주제 수집, 중복 검사, 학습 리뷰, 지식 공백, 클러스터링, 인덱싱, 주제별 문서 연결, 태그 통계 관련 작업 시 자동 적용.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
에러 로그, 스택 트레이스, 시스템 장애 정보를 분석하여 구조화된 버그 리포트를 자동 생성.
매일 아침 업무 시작 전 어제 작업 내역을 정리하여 Daily Note에 반영. 서브 에이전트 기반 병렬 처리로 메인 컨텍스트 절약. "어제 작업 정리해줘", "daily log", "업무 내역 정리" 등의 요청 시 자동 적용.
Claude Code 세션 탐색 및 분석. agf 데이터 소스(history.jsonl)를 활용한 세션 리스트 조회 및 상세 분석. "세션 목록", "session list", "agf" 등의 요청 시 자동 적용.
QA 테스트 결과, 이슈 내용, 조치 사항을 구조화된 QA 문서로 자동 생성.
신기술 스택 도입, 아키텍처 패턴, 구현 가이드를 구조화된 기술 문서로 자동 생성.
프롬프트 작성, brainstorming, planning, design, 설계, 기능 개발 시 Prompt Contracts 프레임워크 적용. Goal/Constraints/Format/Failure Conditions 4요소로 명확한 명세 작성. "바이브 코딩" 방지. brainstorming, writing-plans, 설계, 기능 구현 관련 작업 시 자동 적용.
| name | vis |
| description | Vault Intelligence System (vis) CLI를 활용한 Obsidian vault 시맨틱 검색, 자동 태깅, MOC 생성, 관련 문서 연결, 주제별 문서 연결, 주제 수집, 태그 통계, 지식 공백 분석, 중복 감지, 학습 리뷰 등 vault 지식 관리 전반을 지원하는 skill. vault 검색, 문서 정리, 태그, MOC, 관련 문서, 주제 수집, 중복 검사, 학습 리뷰, 지식 공백, 클러스터링, 인덱싱, 주제별 문서 연결, 태그 통계 관련 작업 시 자동 적용. |
vis는 BGE-M3 기반 시맨틱 검색 엔진으로 Obsidian vault의 지식 관리를 지원하는 CLI 도구. 사용자의 요청을 분석하여 최적의 vis 명령어와 옵션을 자동 선택하여 실행.
사용자가 아래 의도를 표현하면 해당 vis 명령어를 적극 제안하고 실행.
| 사용자 의도 | vis 명령어 | 예시 요청 |
|---|---|---|
| 문서 검색 | vis search | "TDD 관련 문서 찾아줘", "리팩토링에 대해 검색해줘" |
| 주제별 문서 수집 | vis collect | "TDD 관련 자료 모아줘", "클린코드 문서 정리해줘" |
| 관련 문서 찾기 | vis related | "이 문서와 비슷한 거 찾아줘", "연관 문서 뭐 있어?" |
| MOC 생성 | vis generate-moc | "TDD MOC 만들어줘", "주제별 목차 생성해줘" |
| 자동 태깅 | vis tag | "이 문서에 태그 달아줘", "폴더 전체 태깅해줘" |
| 관련 문서 섹션 추가 | vis add-related-docs | "관련 문서 링크 넣어줘", "백링크 추가해줘" |
| 지식 공백 분석 | vis analyze-gaps | "vault에 빈 부분 뭐야?", "부족한 주제 찾아줘" |
| 중복 문서 감지 | vis duplicates | "중복 문서 있어?", "겹치는 내용 찾아줘" |
| 주제 분석 | vis analyze | "vault 주제 분포 보여줘", "어떤 주제가 많아?" |
| 클러스터 요약 | vis summarize | "문서 클러스터링해줘", "주제별로 묶어줘" |
| 학습 리뷰 | vis review | "이번 주 학습 정리해줘", "월간 리뷰 만들어줘" |
| 고립 태그 정리 | vis clean-tags | "안 쓰는 태그 정리해줘", "태그 정리" |
| 인덱스 갱신 | vis reindex | "인덱스 다시 만들어줘", "새 문서 반영해줘" |
| 태그 목록/통계 | vis list-tags | "태그 분포 보여줘", "어떤 태그가 많아?" |
| 주제별 문서 연결 | vis connect-topic | "TDD 주제 문서 연결해줘", "그래프 연결 작업" |
| 연결 진행 상황 | vis connect-status | "연결 작업 얼마나 됐어?", "진행 상황 확인" |
| 시스템 상태 확인 | vis info | "vis 상태 어때?", "캐시 상태 확인" |
vis search 실행 시, 사용자의 표현을 분석하여 최적의 옵션을 자동 조합.
| 판단 기준 | 검색 방법 | 옵션 |
|---|---|---|
| 정확한 용어/키워드 검색 ("~라는 단어", "정확히") | keyword | --search-method keyword |
| 개념/의미 기반 탐색 ("~에 대해", "~란 무엇") | semantic | --search-method semantic |
| 일반적인 검색 (기본) | hybrid | --search-method hybrid |
| 긴 문장, 복합 개념, 여러 주제 결합 | colbert | --search-method colbert |
| 사용자 표현 키워드 | 추가 옵션 | 효과 |
|---|---|---|
| "정확한", "가장 관련 높은", "best" | --rerank | 재순위화로 정확도 향상 |
| "다 찾아줘", "빠짐없이", "포괄적으로" | --expand | 동의어 + HyDE 확장 |
| "완전히", "깊이 있게", "철저하게" | --rerank --expand | 최고 품질 검색 |
| 결과가 부족할 때 | --top-k 20 | 더 많은 결과 반환 |
| 최근 문서만 | --threshold 0.5 | 높은 유사도만 |
# 기본 검색
vis search "검색어"
# 고품질 검색 (정확도 중요)
vis search "검색어" --rerank
# 포괄적 검색 (놓치지 않기)
vis search "검색어" --expand
# 최고 품질 (정확 + 포괄)
vis search "검색어" --rerank --expand
# 결과 저장
vis search "검색어" --output results.md
사용자가 특정 주제의 문서를 모으려 할 때 사용.
vis collect "주제" --output collection.md
vis collect "주제" --top-k 30 --expand # 포괄적 수집
특정 문서와 유사한 문서를 찾을 때 사용.
vis related "문서명.md" --top-k 10
주제별 Map of Content를 자동으로 생성할 때 사용.
vis generate-moc "주제" --top-k 50
vis generate-moc "주제" --output "MOC-주제.md" --include-orphans
문서에 hierarchical tag를 자동으로 부여.
vis tag "문서명.md" # 단일 문서
vis tag "폴더명/" --recursive # 폴더 전체
vis tag "문서명.md" --dry-run # 미리보기
vis tag "문서명.md" --tag-force # 기존 태그 무시하고 재생성
문서에 "관련 문서" 섹션을 자동으로 추가.
vis add-related-docs "문서명.md"
vis add-related-docs "문서명.md" --dry-run # 미리보기
vis add-related-docs --batch --pattern "000-SLIPBOX/*.md" # 배치 처리
vault에서 부족한 주제나 연결이 약한 영역을 분석.
vis analyze-gaps --top-k 20
내용이 유사한 중복 문서를 찾아 정리.
vis duplicates
vault 전체의 주제 분포를 분석.
vis analyze --output analysis.md
문서를 클러스터링하고 주제별로 요약.
vis summarize --clusters 5
vis summarize --topic "TDD" --clusters 3 --style detailed
vis summarize --since "2024-01-01" --output recent.md
일정 기간의 학습 활동을 리뷰.
vis review --period weekly
vis review --period monthly --output monthly-review.md
vis review --from 2024-08-01 --to 2024-08-31
vis review --topic TDD --period quarterly
vault의 태그 목록과 사용 통계를 확인.
vis list-tags # 전체 태그 목록
vis list-tags --depth 1 # 최상위 태그만
vis list-tags --min-count 5 # 5개 이상 문서에 사용된 태그
vis list-tags --output tags.md # 파일로 저장
주제(태그)를 기준으로 MOC 생성 + 관련 문서 링크를 한 번에 처리.
vis connect-topic "TDD" # MOC + 관련 문서 링크
vis connect-topic "TDD" --dry-run # 미리보기
vis connect-topic "TDD" --skip-moc # 관련 문서 링크만
vis connect-topic "TDD" --skip-related # MOC만
vis connect-topic "TDD" --related-k 5 --backup # 관련 링크 5개 + 백업
주제별 문서 연결 작업의 진행 상황을 확인.
vis connect-status # 요약
vis connect-status --detailed # 전체 주제 상세 현황
1개 이하 문서에서만 사용되는 고립 태그를 감지하고 정리.
vis clean-tags # 감지만
vis clean-tags --dry-run # 미리보기
새 문서 추가 후 또는 인덱스 갱신이 필요할 때.
vis reindex # 기본 재인덱싱
vis reindex --with-colbert # ColBERT 포함
vis reindex --force # 강제 전체 재인덱싱
vis reindex --include-folders 000-SLIPBOX 003-RESOURCES # 특정 폴더만
사용자가 "vis로 뭘 할 수 있어?", "vis 기능 알려줘" 등으로 질문하면 아래 내용을 기반으로 상세히 안내.
| 잘못된 옵션 | 올바른 사용법 |
|---|---|
--method | --search-method |
--k | --top-k |
--top | --top-k |
--output-file | --output |
--reranking | --rerank |
--query "TDD" | positional: vis search "TDD" |
--topic "TDD" | positional: vis collect "TDD" |
--file "문서.md" | positional: vis related "문서.md" |
--target "문서.md" | positional: vis tag "문서.md" |
--topic "TDD" (moc) | positional: vis generate-moc "TDD" |
--file "문서.md" (add) | positional: vis add-related-docs "문서.md" |
--similarity-threshold | --threshold (add-related-docs) |
상세 CLI 레퍼런스는 references/cli-reference.md 참조.