add template

2026-04-17 10:35:09 +09:00
parent 5c308e14b2
commit e8f6208df1
41 changed files with 1133 additions and 0 deletions
@@ -0,0 +1,103 @@
+# LLM Wiki 사용법
+
+## 전체 흐름
+
+```text
+제가 raw/에 원본 투입
+        ↓
+AI(Gemini CLI)가 wiki/로 컴파일
+        ↓
+wiki/ 지식을 조합해서 output/ 결과물 생성
+```
+
+## 1단계: 원본 수집
+
+raw/의 적절한 하위 폴더에 원본을 넣는다.
+
+| 수집한 것 | 넣는 곳 |
+|---|---|
+| 웹 아티클, 블로그 | `raw/articles/` |
+| 도서 | `raw/books/` |
+| 논문 | `raw/papers/` |
+| 순간 떠오른 아이디어 | `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에게 요청할 때 대상 문서, 원하는 정리 기준, 출력 형식을 구체적으로 말할수록 좋다
+- 문서는 **분류 → 요약 → 연결 → 융합 → 재사용** 순서로 관리한다