이 장은 다섯 번째 파트인 AI 협업을 시작합니다.
앞의 네 파트에서는 Obsidian 자체를 다루었습니다. 시작하는 방법, 설정, 글쓰기, 그리고 발행까지. 이 파트에서는 반대쪽을 다룹니다. Claude Code나 Codex처럼 로컬 파일을 직접 읽고 쓸 수 있는 AI 도구를 사용하면, Obsidian 볼트는 더 이상 당신만이 읽는 노트북이 아니라 AI가 직접 작업할 수 있는 작업대가 됩니다.
이 장에서는 먼저 시작하는 방법을 설명합니다. 난이도와 자동화 수준이 증가하는 세 가지 방법이 있습니다:
- 가장 간단한 방법: AI에 파일 경로를 직접 제공하여 원본 파일을 읽고 처리하게 합니다.
- Obsidian CLI: 파일을 직접 읽는 것보다 효율적이며, 볼트에 파일이 많을 때 적합합니다.
- Skill: 전체 워크플로를 하나의 명령어로 고정하여 완전 자동화합니다.
AI에 파일 경로 직접 제공하기
이것은 가장 간단한 방법입니다. 플러그인이 필요 없고, CLI 지식도 필요 없습니다.
여기서 말하는 AI는 Claude Code나 Codex처럼 로컬 파일을 직접 읽고 쓸 수 있는 도구를 의미하며, DeepSeek나 ChatGPT 같은 웹 기반 채팅 인터페이스가 아닙니다.
Claude Code나 Codex에 파일의 전체 경로를 주기만 하면, AI가 파일을 읽고 원본에서 직접 처리할 수 있습니다. 예를 들어:
- “이 노트의 핵심 요약:
/Users/yourusername/Documents/Obsidian/01Notes/some-note.md” - “이 글을 영어로 번역하고 원본을 덮어써”
- “이 초안의 오타와 논리 문제를 확인하고 수정해줘”
AI는 파일 내용을 읽고, 요청을 이해한 후 수정된 내용을 다시 씁니다. 요약, 번역, 다듬기, 서식 조정 같은 일회성 작업에 이 방법이 잘 맞습니다.
진입 장벽이 매우 낮아 바로 사용할 수 있습니다. 유일한 단점은 매번 요청과 경로를 수동으로 지정해야 하므로 가끔 사용하기에 적합합니다.
Obsidian CLI
파일 경로를 직접 제공하는 방법도 작동하지만, 볼트에 파일이 많아지면 AI가 파일을 무작정 스캔하는 속도가 느려지고 결과가 정확하지 않을 수 있습니다. 이때 CLI가 필요합니다.
Obsidian을 최신 버전으로 업데이트하면 CLI 인터페이스를 사용할 수 있어 AI가 명령어를 통해 볼트를 직접 조작할 수 있습니다.
어떤 분들은 이렇게 물을 수 있습니다: “AI가 이미 내 파일을 직접 읽을 수 있는데, 왜 CLI가 필요한가요?”
비유를 들어보겠습니다. Obsidian 볼트는 수백 권의 책이 있는 도서관입니다.
CLI가 없을 때: AI가 정보를 찾으려면 선반 사이를 돌아다니며 책을 하나씩 넘기거나, 당신이 “세 번째 줄, 두 번째 책으로 가"라고 알려줘야 합니다.
CLI가 있을 때: 도서관에 검색 시스템이 생깁니다. AI가 주제를 입력하면 시스템이 어떤 파일이 관련 있는지, 어디에 있는지, 노트에 어떤 키워드가 있는지 직접 알려줍니다. 또한 새 파일을 만들고, 속성을 업데이트하고, 폴더 간에 내용을 이동할 수도 있습니다.
효율성 차이는 엄청납니다. 볼트에 파일이 많아지면 CLI 유무에 따라 AI가 정보를 찾는 정확도와 속도가 완전히 다른 수준이 됩니다.
사용 방법
가장 간단한 방법: 대화 중에 AI에게 CLI를 사용하라고 직접 지시하는 것입니다.
예를 들어, AI가 노트를 정리하게 하려면 이렇게 말하면 됩니다: “Obsidian CLI를 사용해서 내 01Notes/ 폴더에서 XXX에 관한 내용을 검색해줘.” 그러면 AI가 obsidian search 명령어를 호출하여 파일을 무작정 스캔하는 대신 검색합니다. 일반적인 명령어는 다음과 같습니다:
- 내용 검색:
obsidian search vault="OBSIDIAN_VAULT" query="키워드" path="01Notes" - 파일 읽기:
obsidian read vault="OBSIDIAN_VAULT" path="04Output/filename.md" - 노트 생성:
obsidian create vault="OBSIDIAN_VAULT" path="target-path.md" content="..." - 폴더 목록:
obsidian files vault="OBSIDIAN_VAULT" folder="04Output"
이 명령어들을 외울 필요 없이, AI에게 하고 싶은 작업을 말하기만 하면 AI가 어떤 명령어를 사용할지 선택합니다.
더 편리한 방법은 이러한 작업을 Skill로 고정하는 것입니다. Skill에서 어떤 작업을 CLI로 수행할지 미리 정의하면, AI가 매번 상기시키지 않아도 Skill 규칙에 따라 자동으로 CLI를 사용합니다. 제 위챗 공식 계정 글쓰기 Skill이 이런 식으로 작동합니다. obsidian search로 자료를 검색하고, obsidian create로 글을 출력하며, obsidian property:set으로 속성을 설정하도록 지정되어 있습니다. AI가 이 Skill을 실행할 때마다 추가 지시 없이 자동으로 CLI를 사용하여 볼트를 조작합니다.
Skill: 워크플로를 하나의 명령어로 만들기
CLI는 ‘찾기’ 문제를 해결하지만, 여전히 매번 요구 사항을 수동으로 말해야 합니다. 고정된 워크플로가 있다면 Skill로 작성한 후, 나중에 하나의 명령어로 전체 프로세스를 실행할 수 있습니다.
먼저 Skill이 무엇인지 설명하겠습니다. 간단히 말해, Skill은 AI를 위해 미리 작성한 고정된 스크립트입니다. 모든 규칙, 워크플로, 서식 요구 사항을 포함합니다. 그런 다음 명령어를 내릴 때마다 AI가 이 스크립트에 따라 실행되므로 반복 설명이 필요 없습니다. Claude Code를 사용해 본 적이 있다면, Skill은 /skill-name 명령어에 해당합니다.
제가 Obsidian 파일을 처리하기 위해 Skill을 사용하는 몇 가지 시나리오는 다음과 같습니다:
영상을 텍스트로: Bilibili나 로컬 영상에서 오디오를 추출하고, 텍스트로 변환한 후 Obsidian 노트로 정리하여 받은 편지함 폴더에 바로 넣습니다.
양방향 링크 추가: 새 노트를 작성한 후, AI가 기존 노트를 스캔하여 관련 내용에 [[양방향 링크]]를 추가하여 정보 네트워크를 엮습니다.
글쓰기: 주제를 주면 AI가 자료를 검색하고, 주제 방향을 확인하며, 제 글쓰기 스타일을 학습하고, 초안을 작성하고, AI 냄새를 줄이기 위해 검토하고, 이미지를 추가한 후 최종 글을 04Output/ 폴더에 출력합니다.
교정 및 사실 확인: 완성된 초안을 AI에 던져서 문단별로 오류, 논리 문제, 확인할 가치가 있는 주장을 검토하게 합니다.
이러한 작업들은 예전에는 수동으로 했으며, 분산되어 있고 시간이 많이 들었습니다. Skill을 사용하면 하나의 명령어로 AI가 전체 프로세스를 실행하고, 주요 지점에서만 확인하면 됩니다.
개념만으로는 너무 추상적입니다. 구체적인 Skill 예시를 살펴보겠습니다.
저는 04Output/ 폴더를 위한 위챗 공식 계정 글쓰기 Skill을 만들었습니다. 주제 선정부터 발행까지의 전체 글쓰기 과정을 다룹니다. 작동 방식은 다음과 같습니다:
1단계: 주제 찾기. AI가 Reddit, Hacker News, X에서 최근 AI, 금융, 기술 분야의 인기 주제를 검색하여 몇 가지 후보 주제를 제시하면 선택할 수 있습니다.
2단계: 자료 검색. 주제가 확정되면 AI가 자동으로 최근 2년간의 관련 정보를 검색하여 지식 베이스 파일로 정리하고 저장합니다.
3단계: 방향 논의. AI가 3~4개의 글쓰기 각도와 해당 개요를 제시하면 선택할 수 있습니다. 확인 후 진행합니다.
4단계: 스타일 학습 및 초안 작성. 여러 모드 중 선택 가능: 자신이 발행한 글을 읽어 스타일을 학습하거나, Jiubian이나 Huashu 같은 작가의 스타일 템플릿을 적용하거나, 특정 글을 지정하여 즉석에서 스타일 특징을 추출합니다. 스타일을 학습한 후 초안을 작성합니다.
5단계: 검토. 세 번의 검토: 내용 정확성 확인, AI 냄새 줄이기(“주목할 만한”, “역량 강화”, “요약하자면” 같은 표현 교체), 문장 및 문단 세부 사항 다듬기.
6단계: 이미지 추가 및 발행. 이미지 자리 표시자를 삽입하고, 필요하면 위챗 공식 계정 초안함에 직접 푸시합니다.
전체 과정에서 AI는 Obsidian CLI를 사용하여 폴더를 조작합니다. 기존 노트를 자료로 검색하고, 브리핑과 지식 베이스 파일을 지정된 디렉토리에 저장하며, 최종 글을 04Output/에 출력하고 frontmatter 속성을 설정합니다. 파일을 수동으로 이동할 필요가 전혀 없습니다.
아래 스크린샷은 제가 AI에게 글쓰기 명령을 내렸을 때의 모습입니다:
이것은 04Output/ 폴더를 위한 예시일 뿐입니다. 어떤 폴더에든 자신만의 Skill을 만들 수 있습니다. 독서 노트 정리 Skill, 회의록 요약 Skill, 일지 검토 Skill 등. “이 폴더에서 AI가 나를 위해 무엇을 해주길 원하는지” 명확히 설명할 수 있다면, 그것을 Skill로 작성할 수 있습니다.
이 위챗 공식 계정 글쓰기 Skill을 오픈소스로 공개했습니다. 필요하시면 제 블로그에서 직접 다운로드할 수 있습니다: https://blog.discoverlabs.ac.cn/downloads/writing-gongzhonghao-skill/
요약
오늘 배운 내용:
- 가장 간단한 방법: AI에 파일 경로를 직접 제공하면 원본 파일을 읽고 처리할 수 있습니다. 요약, 번역, 수정 모두 가능합니다.
- Obsidian CLI: 볼트에 파일이 많을 때 CLI는 AI에게 ‘도서관 검색 시스템’을 제공하여 정보를 더 정확하고 빠르게 찾을 수 있습니다.
- Skill: 고정된 워크플로를 스크립트로 작성하여 하나의 명령어로 전체 프로세스를 실행합니다. 반복적인 워크플로에 적합합니다.
핵심 포인트:
- 세 가지 방법은 난이도와 자동화 수준이 증가하므로 필요에 따라 선택하세요.
- CLI + Skill의 조합이 AI와 Obsidian의 진정한 심층 통합입니다.
- Skill을 처음부터 작성할 필요 없이, AI가 대신 작성하도록 할 수 있습니다.