MeetingAnalysis은(는) 무엇을 하나요?
녹음, 메모 또는 붙여넣은 대화 기록을 입력하면 간결하고 구조화된 요약과 사용자의 작업 항목을 출력합니다. 모든 경로, 사람 및 계정은 사용자의 설정 파일에서 가져오며, 이 스킬에 직접 하드코딩되지 않습니다.
0단계 — 모든 호출은 여기서 시작
MA="${SKILLS_HOME:-$HOME/.claude/skills}/MeetingAnalysis/Tools"
python3 "$MA/meeting_config.py" check # ok: true, 또는 문제 목록
python3 "$MA/meeting_config.py" show <context> # 하나의 컨텍스트에 대한 해결된 프로필
설정이 없거나 문제가 나열된 경우 → Workflows/Setup.md를 먼저 실행하세요.
설정 파일 위치는 $MEETING_ANALYSIS_CONFIG이며, 설정되지 않은 경우
${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/MeetingAnalysis/config.json입니다.
워크플로우
| 트리거 | 워크플로우 |
|---|---|
| 첫 사용, 새 컨텍스트, 새 노트 제공자, "회의 분석 설정" | 설정 |
| 녹음 파일 경로, "이 회의 분석" | 분석: 이동 → 텍스트 변환 → 프레임 → 요약 → 트래커 → 아카이브 → 검증 |
| "그냥 텍스트 변환" | 텍스트 변환만 |
| "회의 노트 가져오기", Gemini 노트, 붙여넣은 기록, 회의 링크 | 노트 가져오기 |
/MeetingAnalysis ingest <context> --unattended, "회의 인박스", 스케줄링 | 자동 수집 |
하드 불변 규칙 — 저장소에 미디어 파일 금지
회의 폴더는 일반적으로 git 저장소(노트 저장소, 세컨드 브레인) 내부에 있습니다. Git은 커밋된 모든 blob을 영구히 보관합니다: 800MB 녹음 파일 하나는 모든 클론에서 800MB를 영구히 차지하며, 나중에 파일을 삭제해도 공간이 돌아오지 않습니다.
| 회의 폴더에 허용되는 파일 | 금지되는 파일 |
|---|---|
.md, .txt, .json, .jsonl | 비디오: .mp4 .mkv .mov .webm .avi |
최대 5개의 예외적 .jpg 키프레임, 총 1MB 이하 (§ 프레임) | 오디오: .wav .mp3 .m4a, 추출된 모든 오디오 |
.png 프레임, 20MB 초과 모든 파일 |
- 원본 녹음 파일은 절대 회의 폴더로 복사 또는 이동되지 않습니다. 요약에서 파일명을 언급합니다.
- 입력 녹음 파일이 git 작업 트리 내부에 있다면 먼저
recordings_archive로 이동한 후 새 경로에서 작업합니다. - 임시 오디오 및 프레임은 임시 디렉토리에 저장되며 정리 단계에서 삭제됩니다.
- § 검증 단계는 성공을 보고하기 전에 아무것도 출력하지 않아야 합니다.
meeting_config.py check는 recordings_archive 또는 수집 홈 디렉토리가 git 작업 트리 내부에 있으면 거부합니다.
기밀 컨텍스트
"confidential": true는 해당 회의가 고용주나 클라이언트에 속하며, 회의 폴더나 트래커는 개인 소유임을 의미합니다.
이 경우: 원문 그대로의 대화록이나 복사된 노트 금지(요약에서 원본 소스로 링크), 요약은 일반적인 용어(결정, 주제, 담당자, 티켓 ID)로 작성, 호스트명, IP, 계정 ID, 자격 증명, 고객 이름 또는 고객 데이터 금지, 트래커 항목은 TICKET-ID: 짧은 일반 요약 형식.
출력 형식
<meetings_dir>/YYYY-MM-DD-<slug>/
├── YYYY-MM-DD-<slug>-summary.md
├── YYYY-MM-DD-<slug>-transcript.txt # [MM:SS] 형식 줄 (기밀 컨텍스트 제외)
├── YYYY-MM-DD-<slug>-transcript.json # 세그먼트 (기밀 컨텍스트 제외)
└── frames/ # 드물게; ≤ 5 jpg, ≤ 1 MB
<slug>는 회의 제목에서 추출한 짧은 케밥-케이스(weekly-status, pricing-review; 1:1 회의의 경우 상대방 이름 추가). 요약:
# <회의 제목> — YYYY-MM-DD
**참석자:** …
**출처:** <녹음 파일명 (저장소 외부에 보관) | 노트 문서 링크 | <도구>에서 붙여넣은 대화록>
**대화록:** <파일명 | 링크 | 복사되지 않음>
---
## 맥락
## 논의된 주제
### 1. <주제> (MM:SS–MM:SS)
## 결정 사항
## 즉시 작업 항목
| # | 작업 | 담당자 | 우선순위 | 마감일 |
|---|------|-------|----------|--------|
## 주요 시사점
작업 테이블은 모든 담당자를 나열하여 전체 기록을 완전하게 유지합니다. 사용자 본인의 항목만 트래커로 전송됩니다.
작업 항목 → 트래커
설정 파일의 tracker: "BattlePlan"은 사용자 항목을 BattlePlan의 idempotent batch-add로 전송합니다("none"은 단계 생략).
'사용자 본인'의 의미: 담당자가 사용자 또는 사용자의 owner_aliases 중 하나이거나, 사용자가 여러 담당자 중 한 명이거나, 사용자가 참석한 회의에서 "우리/팀"으로 지정된 경우.
하위 컨텍스트: 작업에 tracker_sub_context_rules 정규식 중 첫 번째 일치 항목이 적용되며, 없으면 컨텍스트의 tracker_sub_context를 사용합니다.
상대적 마감일은 회의 날짜를 기준으로 계산합니다.
출처: Meeting: <제목> YYYY-MM-DD (recording|notes|pasted), 중복 제거 키로 사용되므로 실행 간 안정적입니다.
--dry-run을 먼저 보여주고 확인을 받습니다(무인 실행 제외).
이름
음성 인식 및 노트 작성 도구는 이름을 잘못 표기하는 경우가 많습니다.
로스터 파일(roster_file: 한 줄에 한 사람, Name: 별칭, 오타, …)과 참석자 목록(캘린더 이벤트 또는 노트 헤더)을 기준으로 이름을 교정합니다.
신뢰도가 낮은 교정은 Name (?)로 표시합니다. 절대 추측하지 마세요.
프레임 (비디오 전용, 임시 전용)
프레임은 분석 입력일 뿐 최종 결과물이 아닙니다. 임시 디렉토리에 추출하고, 읽고, 내용을 요약에 작성한 후(슬라이드 → 핵심 텍스트, 화면 공유 → 표시된 내용, 구조 → 머메이드 다이어그램) 삭제합니다.
ffmpeg -i <video> -vf "select='gt(scene,0.3)',showinfo" -vsync vfr "$TMP/frames/part1_%03d.png" # 2프레임 미만이면 0.15 사용
프레임을 유지하려면 모든 조건을 충족해야 합니다: 내용을 텍스트, 표 또는 머메이드로 표현할 수 없음, 밀도가 높음(갤러리 뷰나 제목 슬라이드가 아님), 요약의 결론이 이 프레임에 의존함, 요약에서 이름으로 참조함.
유지할 프레임은 다음과 같이 저장:
ffmpeg -i in.png -vf scale=1280:-2 -q:v 4 frames/partN_MMmSSs.jpg.
확실하지 않으면 폐기: 녹음 파일과 타임스탬프가 남아 있습니다.
검증
find "<회의 폴더>" -type f \( -iname '*.mp4' -o -iname '*.mkv' -o -iname '*.mov' -o -iname '*.webm' -o \
-iname '*.avi' -o -iname '*.wav' -o -iname '*.mp3' -o -iname '*.m4a' -o -iname '*.png' -o -size +20M \) -print
find "<회의 폴더>" -path '*/frames/*' -type f | wc -l # ≤ 5 이어야 함
출력이 없어야 통과입니다. 항목이 나열되면: 이동시키고 사용자에게 알린 후 성공을 보고하지 마세요.
도구
| 도구 | 기능 |
|---|---|
| `meeting_config.py check | show |
| `transcribe.py REC --out-base DIR/transcript [--lang auto | en |
| `run_ingest.sh --context NAME [--install | --check |
의존성
uv (스크립트가 자체 Python 의존성을 선언). ffmpeg는 프레임 추출에만 필요. GPU는 선택 사항: CPU에서는 turbo 모델로 1시간 회의에 약 2시간 소요. 노트 가져오기는 에이전트의 Google Drive/Docs(및 선택적으로 Gmail, Calendar) 커넥터가 적절한 계정으로 연결되어 있어야 합니다.