alfredzhang98/research-obsidian-skill

ai-wiki — 파일 내용을 지식 베이스로 정리 (경량, 기본값)

"이걸 정리해줘"라는 요청을 AI 관리 폴더 안에 올바른 이름과 올바른 링크가 포함된 노트로 변환합니다.

이 명령어는 주제를 생성하지 않습니다. 하나의 노트를 생성하며, 기존 노트에 대한 [[wikilink]]가 최소 하나 이상 필요합니다. 주제 허브 아래에 상호 링크와 함께 노트를 배치하려면 /ai-wiki-full을 사용하세요.

주제가 기본적으로 비활성화된 이유: 모든 논문에 자체 허브가 있으면 허브는 아무것도 정리하지 않습니다 — 그저 논문에 더 긴 이름을 부여할 뿐입니다. 주제는 연구 방향이지, 논문의 주제가 아닙니다. 기준은 references/note-specs.md의 "주제로 인정되는 기준" 섹션에 있습니다.

출력 위치

이 스킬이 정리하는 모든 것은 AI 관리 폴더에 저장됩니다.

영역	처리 방법
AI 관리 폴더 (<AI_WIKI>/**)	생성 / 편집 / 이동 / 이름 변경 / 삭제 — 자유롭게 처리
사용자의 개인 노트 폴더	자유롭게 읽고 검색; 추가 편집은 허용; 삭제, 이름 변경, 이동, 덮어쓰기 전에는 반드시 물어보기
.claude/rules/, CLAUDE.md	정적 구성 — 사용자가 Claude의 동작 변경을 요청할 때만 편집; updated: 갱신. 유일한 동적 예외는 .claude/rules/active.md
.obsidian/, .trash/	접근 가능하지만 수정 금지 — Obsidian 구성을 편집하면 볼트가 손상될 수 있음

권한 레이어에서 차단되는 것은 없으므로 위의 제한은 판단에 기반합니다. 볼트는 보통 git 저장소가 아니며, 수동으로 작성된 노트를 잘못 덮어쓰면 파일 동기화 버전 기록에서만 복구할 수 있습니다.

이러한 영역에서 읽고 그 요약을 AI 관리 폴더에 정리하는 것이 바로 이 스킬의 목적입니다.

참고 파일 — 네 개 모두 읽지 말고 필요한 것만 읽으세요

파일	읽어야 할 때
references/vault-guide.md	어느 폴더에 넣을지 결정할 때 — 라우팅 테이블, 사용자 표현 예시, 태그/위키링크 모델
references/note-specs.md	논문 노트, 학습 노트, 주제 계획을 작성할 때 — 파일명, 머리말, 섹션 사양, 표현 규칙
references/figures-diagrams.md	노트에 그림이 필요할 때 — 추출 명령어, 삽입 형식, mermaid 규칙
references/tools.md	입력에 대해 어떤 스킬 또는 CLI를 사용할지 선택할 때, 그리고 종단 간 워크플로

일상적인 정리(명확한 폴더 하나, 그림 없음)에는 이 파일들이 필요 없습니다 — 아래 절차만으로 충분합니다.

절차

1. 분류 — references/vault-guide.md의 라우팅 테이블에서 정확히 하나의 대상 폴더를 선택하세요. 콘텐츠 하나, 폴더 하나; 교차하는 내용은 tags:와 [[wikilinks]]로 처리하며, 중복 사본은 절대 만들지 않습니다.
   • 확정되지 않았거나, 탐색 중이거나, 일괄 처리된 내용은 실제 폴더가 아닌 Inbox/로 보냅니다.
   • 두 폴더 사이에서 진정으로 모호한 경우: 질문하고, 추측하여 중복하지 마십시오.
2. 이름 짓기 — references/note-specs.md에 따라 (소문자 케밥-케이스):
   • 논문 → Research/papers/<첫 번째 저자 성>-<연도>-<2-3-키워드-슬러그>.md (이 명령어는 주제를 생성하지 않으므로 노트는 papers/의 루트에 위치합니다; /ai-wiki-full은 노트를 papers/<주제-슬러그>/ 아래에 배치합니다)
   • 학습 → Research/learning/<주제-슬러그>-<YYYYMMDD>.md
3. 먼저 기존 노트 확인 — 쓰기 전에 대상 폴더를 Glob으로 검색하세요 (논문의 경우 Research/papers/**/*.md 사용; 주제별 하위 폴더에 주의하세요). 올바른 노트를 업데이트하는 것이 거의 중복을 만드는 것보다 낫습니다. 이미 존재하는 노트가 있으면 병합하고 그 사실을 알리십시오.
4. 작성 — Templates/에 있는 일치하는 스켈레톤(paper-note.md / learning-note.md)을 Read하고 그 자리에서 채우십시오. 절대 메모리에서 구조를 재구성하지 마십시오. 섹션 지침은 스켈레톤의 {{...}} 프롬프트가 아닌 references/note-specs.md에 있습니다.
   • > [!callout] 블록은 강조 시스템입니다 — 유지하고, 새 유형을 추가하지 마십시오.
   • 상단의 빠른 카드는 마지막에 작성합니다: 완성된 노트를 압축합니다. 여섯 줄을 채울 수 없다면 아래 노트가 완료되지 않은 것입니다.
   • S0 "이 논문이 하는 일을 평이한 언어로"는 필수입니다: 분야 기본기를 알지만 이 논문을 읽지 않은 사람을 위해 3-5문장. 순서: 그들이 직면한 상황, 그들이 구축한 것, 그것이 작동하는 이유, 그들이 얻은 결과. 이 섹션을 쓸 수 없다면 논문을 이해하지 못한 것입니다 — 계속하기보다 멈추고 다시 읽으십시오.
   • 논문 노트는 순서대로 답변합니다: S0 평이한 언어 → S1 배경 → S2 기존 연구가 할 수 없었던 것 → S3-S4 방법 및 수학 → S5 실행된 것 → S6 결과 → S7 한계 및 저자의 향후 연구 → S8 나의 분석 및 연구 기회.
   • S2와 S8이 노트가 존재하는 이유입니다 — 둘 다 일반적인 산문으로 채워질 수 없습니다. S4의 수학은 노트에서 재구성 가능해야 하며, 단순히 알아볼 수 있는 수준이어서는 안 됩니다.
   • 각 S8 기회는 네 가지 항목(기회 → 왜 여전히 해결되지 않았는지 → 첫 번째 실험 → 어떤 주제 아래에 정리되는지)을 모두 포함합니다. "취할 가치가 있는 기회 없음 — <이유>"도 유효합니다; 지어낸 기회는 유효하지 않습니다.
   • 전문적인 표현: 은유적인 레이블("이 논문의 컷", "평결", "가장 강력한 숫자")을 사용하지 마십시오. 표현 표는 references/note-specs.md를 참조하십시오. 모든 판단은 구체적인 증거에 기반해야 합니다.
   • 쓰기 전에 논문을 읽으십시오. 초록만으로 섹션을 채우지 마십시오. PDF 텍스트를 섹션에 사용할 수 없으면 그럴듯한 내용을 채우는 대신 {{not available in source}}라고 쓰십시오.
5. 그림 — references/figures-diagrams.md에 따라: paper-figures 스킬을 통해 논문 그림을 _attachments/paper-figures/<논문-슬러그>/로 가져오고 (첨부 파일 트리는 평평하게 유지되며, 주제 폴더에 미러링되지 않습니다), 각 그림이 역할을 수행하는 섹션에 인라인으로 삽입합니다.
   • 삽입 접두사는 노트의 깊이에 따라 다릅니다: papers/ 루트에서는 ../../_attachments/..., papers/<주제-슬러그>/ 내부에서는 ../../../_attachments/...입니다. 이것은 노트가 이동될 때 조용히 실패하는 유일한 부분입니다 — 하나의 이미지를 점검하십시오.
   • 작성된 다이어그램은 mermaid 펜스를 사용합니다. ASCII 아트는 금지됩니다.
6. 링크 (필수, 최소 하나) — 노트에는 기존 노트에 대한 [[wikilink]]가 최소 하나 이상 포함되어야 합니다: Research/topics/의 허브, 다른 논문 노트, 또는 학습 노트.
   • 먼저 Research/topics/와 Research/papers/를 Glob으로 검색하고, 가장 가까운 대상을 선택한 후 링크만 던지지 않고 문장으로 관계를 설명하십시오.
   • 이 명령어는 주제를 생성하지 않습니다. 링크할 대상이 정말로 없다면, .claude/rules/active.md에 새로운 영역을 연다는 내용을 표시하고 사용자에게 허브를 구축하는 명령어는 /ai-wiki-full이라고 알리십시오.
   • 노트가 기존 주제에 맞는 경우, 해당 주제의 S6 목록에 순방향 링크를 추가하십시오 — 상호 링크가 그래프 클러스터를 만듭니다.
7. 등록 — 이것이 새로운 방향을 열거나 진행 중인 작업인 경우, 한 줄 포인터를 .claude/rules/active.md에 추가하고 updated:를 갱신하십시오. 거기에 상태를 미러링하지 마십시오. active.md는 이 워크플로가 설정 변경을 명시적으로 요청하지 않고도 건드리는 유일한 규칙 파일입니다.

완료 전 자가 점검

• 작성된 모든 경로가 AI 관리 폴더 안에 있는가
• 파일명이 노트 유형의 사양과 일치하는가; 논문 노트는 papers/ 루트에 있는가 (이 명령어는 주제를 생성하지 않음)
• 삽입 접두사가 노트의 깊이와 일치하는가, 그리고 하나 이상의 이미지를 점검했는가
• 머리말이 완전한가 (tags:가 존재하고 구체적이며, 단순히 research/가 아님)
• 기존 노트에 대한 [[wikilink]]가 최소 하나 이상 있고, 관계가 설명되었는가
• 실제 템플릿 파일에서 작성되었으며, 섹션 순서와 콜아웃이 그대로 유지되었는가
• S0 평이한 언어 요약이 채워졌고, 전문 용어를 덤프하지 않았는가
• 빠른 카드가 마지막에 작성되었는가; 여섯 줄 모두 구체적인 진술이며 독립적으로 이해 가능한가
• 전달된 노트에 {{placeholder}}가 남아 있지 않은가
• 은유적인 레이블이 없는가
• 그림이 인라인으로 삽입되었으며, 끝에 덤프되지 않았는가
• 논문 노트: S2는 실제 이전 방법과 그 구체적인 실패를 명명했는가; S7은 저자 명시/내 의견/그들의 향후 연구를 분리했는가; S8의 결론은 증거를 인용하고 각 기회는 네 가지 항목을 모두 포함하는가
• 학습 노트: S1은 사용자의 질문을 그대로 담고 있는가; S5는 실제 숫자 예제를 포함하는가
• 사용자에게 작성된 정확한 경로를 알렸는가

관련

상호 링크가 있는 주제 허브를 생성하거나 찾으려면 /ai-wiki-full을 사용하세요. 입력 유형별 도구 선택: references/tools.md. 전체 영역 규칙: .claude/rules/permissions.md.