위키 스킬
이 스킬은 에이전트를 <VAULT_ROOT>(저장소 루트)에 있는 사용자 개인 지식 베이스의 규율 있는 관리자로 전환합니다.
0단계 — 먼저 AGENTS.md를 항상 읽으십시오
무엇을 하기 전에, 저장소 루트의 AGENTS.md를 읽으십시오. 여기에는 디렉터리 레이아웃, 페이지 규칙, 머리말 스키마, 로그 형식 및 상세 워크플로우가 정의되어 있습니다. 이 SKILL.md는 단지 디스패처일 뿐이며, AGENTS.md가 진리의 원천입니다.
디스패치: 사용자가 무엇을 요청하고 있나요?
사용자 메시지에서 다음 의도 중 정확히 하나를 선택하십시오:
| 사용자 의도 | 워크플로우 |
|---|---|
| 질문을 하거나, 분석/종합을 원함 | 쿼리 (아래) |
| 새 파일을 드롭했거나 "이것을 수집"이라고 말함 | 수집 (AGENTS.md §4.1 참조) |
| "lint" / "상태 점검" / "문제 찾기"를 말함 | 린트 (아래) |
| 비교/슬라이드 덱/차트/보고서를 원함 | 아티팩트 생성 (아래) |
| 단지 탐색 중이거나 확실하지 않음 | wiki stats를 실행한 후 원하는 것을 물어보십시오 |
명확하지 않으면 진행하기 전에 짧은 확인 질문을 하나 하십시오.
쿼리 워크플로우
-
저장소 루트에서
wiki search <키워드>를 실행하여 후보 페이지를 찾으십시오. 필요한 경우 여러 키워드 변형을 사용하십시오. -
wiki/index.md를 읽어 카탈로그를 확인하십시오. -
1단계에서 찾은 후보 페이지를 읽으십시오.
-
여전히 컨텍스트가 부족하면
raw/또는clippings/의 관련 파일을 읽으십시오. -
[[위키링크]]인용(위키 페이지 대상)과[文章](../raw/xxx.md)인용(원본 소스 대상)을 사용하여 답변을 종합하십시오. -
답변에 지속적인 가치가 있는 경우 (비교, 파생된 통찰력, 중요하지 않은 종합), 이를
output/<YYYY-MM-DD>-<짧은-슬러그>.md에 머리말과 함께 마크다운 파일로 작성하십시오:--- type: artifact kind: answer | comparison | analysis | report | slides created: <날짜> question: "<사용자의 질문, 그대로>" sources_used: [wiki/concepts/X.md, wiki/sources/Y.md, ...] ---그런 다음 사용자에게 물어보십시오: "要不要把这份输出归档为
wiki/questions/<slug>.md?" (예인 경우, 복사하고 index.md와 log.md를 업데이트하십시오.) -
답변이 사소한 경우(사실 조회), 채팅으로만 답변하십시오 — 파일이 필요 없습니다.
린트 워크플로우
wiki lint를 실행하십시오 — 이 명령은 자동으로lint/<today>.md를 작성합니다.- 해당 파일을 읽고 요약하여 사용자에게 알리십시오 (어떤 문제가 실제 문제이고 어떤 것이 문서 내 리터럴
[[예시]]와 같은 오탐인지). - 우선 순위가 지정된 수정 계획을 제안하십시오. 자동 수정하지 마십시오 — 사용자가 선택하도록 하십시오.
아티팩트 생성 워크플로우
쿼리와 동일하지만, 결과물 형태가 명시적입니다 (표 / Marp 슬라이드 / Python 차트 / 캔버스). 항상 output/에 저장하십시오. 슬라이드 덱의 경우 Marp 마크다운 형식을 사용하십시오. 차트의 경우 Python 스크립트를 output/scripts/에 작성하고 실행하여 이미지를 함께 생성하십시오.
출력 디렉터리 규칙
output/
├── 2026-06-26-rag-vs-llm-wiki.md # 답변 / 비교 아티팩트
├── 2026-06-26-karpathy-summary.slides.md # Marp 슬라이드 덱
├── scripts/ # 차트 생성을 위한 도우미 스크립트
└── assets/ # 렌더링된 이미지, 내보내기 파일
output/ 디렉터리는 LLM 소유, 추가 전용입니다 (묻지 않고 이전 아티팩트를 삭제하지 마십시오). 각 파일은 위에 표시된 머리말을 가지고 있어야 사용자가 나중에 아티팩트를 위키로 승격할 수 있습니다.
사용 가능한 CLI 명령 (<VAULT_ROOT>에서 실행)
의도적으로 최소화된 네 가지 명령만 있습니다:
wiki stats # 개요: 유형/상태별 페이지 수
wiki log -n 10 # wiki/log.md의 마지막 N개 항목
wiki search <regex> # 전체 텍스트 검색 (--scope wiki|raw|clippings|all)
wiki lint # lint/<today>.md에 고아/깨짐/스텁 기록
그 외 모든 것(페이지 생성, 머리말 편집, index.md 업데이트, log.md에 추가)은 마크다운 파일을 직접 읽고 쓰는 방식으로 수행됩니다. 파일 편집을 위해 CLI를 요청하지 마십시오 — 그것은 당신의 작업입니다.
중요 규칙 (AGENTS.md 출처)
raw/또는clippings/의 파일을 절대 수정하지 마십시오.- 모든 수집은
wiki/index.md를 업데이트하고wiki/log.md에## [YYYY-MM-DD] ingest | <제목>형식의 항목을 머리말에 추가해야 합니다. - 위키 페이지 간에
[[이중 대괄호]]로 상호 참조하십시오. - 페이지에는 YAML 머리말(
type,tags,created,updated,sources,status)이 필요합니다. - 확실하지 않으면 사용자에게 물어보십시오. 조용히 대규모 리팩터를 수행하지 마십시오.
보고 스타일
워크플로우를 완료한 후 사용자에게 짧은 요약을 제공하십시오:
- 수행한 작업 (1~3개 불릿)
- 생성되거나 수정된 아티팩트 (상대 경로)
- 해결되지 않은 질문이나 발견한 새로운 격차
간결하게 유지하십시오. 사용자는 Obsidian에서 병렬로 탐색 중이며 파일 변경 사항을 볼 수 있습니다.