Files
2026-04-17 11:11:12 +09:00

3.4 KiB

LLM Wiki 사용법

전체 흐름

제가 raw/에 원본 투입
        ↓
AI(Gemini CLI)가 wiki/로 컴파일
        ↓
wiki/ 지식을 조합해서 output/ 결과물 생성

1단계: 원본 수집

raw/의 적절한 하위 폴더에 원본을 넣는다.

수집한 것 넣는 곳
웹 아티클, 블로그 raw/articles/
도서 raw/books/
논문 raw/papers/
영상 대본, 트랜스크립트 raw/videos/
순간 떠오른 아이디어 raw/ideas/
업무 기록, 암묵지 raw/work/
  • 웹 클리퍼 + Templater로 메타데이터 포함 수집 가능
  • 형식은 자유. 마크다운 권장
  • 한번 넣은 원본은 수정하지 않는다

2단계: Gemini CLI로 위키 컴파일

Gemini CLI는 이 프로젝트에서 다음 구조를 사용한다.

  • 지속 컨텍스트: GEMINI.md, raw/GEMINI.md, wiki/GEMINI.md, output/GEMINI.md
  • 반복 명령: .gemini/commands/wiki/*.toml
  • 스킬: .gemini/skills/llm-wiki-operator/
  • 서브에이전트: .gemini/agents/*.md
  • 훅: .gemini/settings.json, .gemini/hooks/*.cjs

기본 사용 예시

  • 자연어로 직접 요청:

    • raw/articles/문서정리방법론.md 읽고 wiki에 컴파일해줘
    • raw/에서 '유한요소법 모델링' 관련 문서들 찾아서 wiki 페이지로 정리해줘
    • raw/books/수치해석.md 내용을 기존 [[해석 모델링 원칙]] 페이지에 반영해줘
  • Gemini CLI 커스텀 명령 사용:

    • /wiki:compile raw/articles/문서정리방법론.md
    • /wiki:ask 해석 모델링 원칙에 대해 내 볼트에 뭐가 있어?
    • /wiki:connect 유한요소법 모델링과 다물리해석 문서
    • /wiki:draft 문제해결 관련 개념을 모아 output/에 문제해결 101 초안 작성

AI가 자동으로 지키도록 설정된 것

  • raw/ 수정 차단 훅
  • wiki/ 수정 시 index.md, log.md 갱신 리마인더
  • wiki 페이지 frontmatter 규칙
  • [[wikilink]] 내부 링크 규칙

3단계: 지식 활용

질문하기

해석 모델링 원칙에 대해 내 볼트에 뭐가 있어?

AI는 이 순서로 찾는다.

  1. wiki/index.md
  2. 관련 wiki/ 페이지
  3. raw/는 마지막 수단

문서 연계·융합 요청

유한요소법 모델링과 다물리해석 문서를 연계해서 공통 원칙을 정리해줘

내 볼트에서 수치해석 안정성과 모델 검증 관련 지식을 찾고, 서로 보완되는 내용을 융합해줘

결과물 생성

wiki/에서 문제해결 관련 개념들 모아서 output/에 문제해결 101 초안 만들어줘

wiki/에서 문서 정리와 지식 활용 관련 내용 정리해서 가이드 초안 만들어줘

4단계: 설정 변경 후 새로고침

Gemini CLI 인터랙티브 세션 안에서 아래 명령으로 구조 변경을 반영한다.

  • /memory refresh 또는 /memory show
  • /commands reload
  • /skills reload
  • /agents reload
  • /hooks panel

터미널에서 빠르게 확인하려면 다음 명령도 쓸 수 있다.

  • gemini --version
  • gemini skills list

주의사항

  • raw/ 파일은 절대 수정하지 않는다 — 원본 보존이 핵심
  • 위키 페이지가 이미 있으면 새로 만들지 말고 업데이트
  • AI에게 요청할 때 대상 문서, 원하는 정리 기준, 출력 형식을 구체적으로 말할수록 좋다
  • 문서는 분류 → 요약 → 연결 → 융합 → 재사용 순서로 관리한다