Skill: Codex Academic Notes Engine 🎓
이 스킬은 AI 에이전트가 학술 강의 녹화(비디오 또는 오디오)를 처리하고, 시각적 및 음성 자료를 분석하여 Obsidian용 고성능 대학 노트를 생성할 수 있게 합니다.
이 스킬을 사용하는 경우
다음과 같은 경우 이 스킬을 사용하세요:
- 사용자가 강의 녹화본을 처리해 달라고 요청할 때 (예: "OBS로 녹화한 운영체제 강의를 가져와서 노트를 생성해 줘").
- 슬라이드가 포함된 비디오 또는 오디오 파일로부터 노트를 요약하거나 구조화하려 할 때.
- 깨끗한 노트를 검증하고 사용자의 Obsidian 저장소로 직접 내보내려 할 때.
에이전트 작업 흐름 (단계별)
1단계: Codex로 세션 번들 준비
Codex CLI를 실행하여 미디어를 검사하고, 최적화된 오디오 트랙(16kHz 모노)을 추출하며, 슬라이드 변경을 감지합니다:
codex prepare "<비디오_또는_오디오_경로>" --subject <과목명_또는_코드> [--date YYYY-MM-DD]
Codex가 생성하는 결과:
.codex_bundles/<세션_ID>/ 디렉토리에 작업 패키지를 생성합니다:
manifest.json: 기술 메타데이터, 길이, 과목, 타임스탬프가 포함된 슬라이드 목록.agent_context.md: 통합된 지침 및 강의 템플릿.audio/lecture.opus: 청취 및 전사에 최적화된 오디오 트랙.slides/slide_HHMMSS.png: 각 슬라이드 변경 시점에 대응하는 중복 제거된 스크린샷.
2단계: 자료 검사
- 번들 폴더에서
manifest.json과agent_context.md를 읽어 과목 메타데이터와 캡처된 슬라이드 목록을 확인합니다. slides/폴더의 이미지를 검토합니다(다이어그램, 화면 코드, 수식, 슬라이드 제목 분석).- 오디오 트랙 또는 음성 내용을 분석하여 강사의 설명을 전사하고 요약합니다.
3단계: Obsidian 노트 요약 작성
다음 학술 지침을 엄격히 준수하여 Markdown 콘텐츠를 작성합니다:
- YAML 프론트매터:
---
materia: "<과목명>"
codigo: "<코드>"
fecha: YYYY-MM-DD
docente: "<강사명>"
estado: processed
tags: [<과목_태그>]
---
-
제목:
# <과목명>: <세션 중심 주제> -
📌 과제, 작업 및 행정 공지: 시험 공지, 과제, 마감일, 특별 조건을 추출합니다:
- [ ] [HH:MM:SS] 과제 설명 (마감일: ...) -
🧠 핵심 개념 및 시험 경고: Obsidian 네이티브 callout을 사용합니다:
> [!tip] 핵심 개념: [개념]정의 및 이론적 중요성.> [!warning] 시험 힌트: [강조된 점]강사가 중요한 점이나 일반적인 오류를 지적할 때.> [!example] 실습 시연예제, 시연 또는 실제 사례.
- 📝 강의의 시간 순서 및 개념적 전개:
타임스탬프와 함께 시간 블록별로 구성:
### [HH:MM:SS] [다룬 하위 주제]
- 필수 시각적 연결: 강사가 캡처된 슬라이드를 소개하거나 설명하는 정확한 시간에 Obsidian 구문을 사용하여 이미지를 삽입합니다:
![[slide_HHMMSS.png]]. - 슬라이드에 보이는 다이어그램이나 코드를 구두 설명과 연계하여 설명합니다.
- 수학 공식은 LaTeX(KaTeX:
$formula$인라인 또는$$formula$$블록)로 작성합니다. - 코드 조각은 해당 블록(
python,c,sql등)으로 강조 표시합니다.
- 📜 구간별 인덱싱된 전사:
2-3분마다 강사의 말을 그대로 인용하거나 충실히 요약:
> [HH:MM:SS] 전사된 텍스트 또는 관련 인용...
4단계: Obsidian으로 내보내기
생성된 초안을 <bundle_dir>/notes.md에 저장하고 다음 명령을 실행합니다:
codex export "<bundle_dir>" "<bundle_dir>/notes.md"
Codex는:
- 문서를 검증합니다.
- 모든 슬라이드 이미지를 Obsidian 첨부 폴더(
attachments/Codex/)에 자동으로 복사합니다. - 노트를 저장소 내 과목 폴더에 배치합니다(
Classes/<과목명>/YYYY-MM-DD - <주제>.md). manifest.json의 상태를exported로 업데이트합니다.
5단계: 사용자에게 확인
생성된 Obsidian 노트의 경로, 다룬 주제 요약, 발견된 과제를 포함하여 완료를 알립니다.