Community생산성 & 협업github.com

MeetingAnalysis

회의를 구조화된 요약과 추적 가능한 작업 항목으로 변환합니다. 로컬에서 녹음 파일을 자동으로 텍스트 변환하거나(faster-whisper), Google Meet/Gemini 노트를 가져오거나, 붙여넣은 기록을 바탕으로 요약과 결정 사항, 작업 테이블을 생성하고, 사용자 본인의 작업만 BattlePlan 트래커에 전송합니다.

MeetingAnalysis란 무엇인가요?

MeetingAnalysis 스킬은 회의 녹음, 메모 또는 붙여넣은 대화 기록을 입력받아 간결한 구조화 요약과 작업 항목을 생성하는 AI 에이전트 도구입니다. 로컬 환경에서 faster-whisper를 통해 녹음을 텍스트로 변환하며, CUDA(NVIDIA GPU), Apple Silicon(MPS), CPU(int8) 등 사용자의 하드웨어에 맞춰 최적화된 백엔드를 자동 선택합니다. Google Drive/Docs 커넥터를 통해 Google Meet 및 Gemini 노트를 직접 가져올 수 있고, 붙여넣기 형식의 회의록도 지원합니다. 생성된 요약에는 회의 맥락, 논의 주제(타임스탬프 포함), 결정 사항, 모든 참석자의 작업 항목 테이블이 포함되며, 사용자 본인의 작업만 BattlePlan 트래커에 idempotent하게 전송합니다. 또한 설정된 디렉토리에 녹음 파일을 자동 수집해 처리하는 무인 인박스 수집(AutoIngest) 워크플로우를 제공하며, 녹음 파일이 절대 git 저장소에 포함되지 않도록 하는 하드 불변 규칙이 적용되어 있습니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 사용자의 구성 파일에서 모든 경로와 계정을 읽어오므로 별도의 하드코딩이 없습니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/juanmherrerav/agent-workday-skills/tree/main/skills/MeetingAnalysis

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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 초과 모든 파일
  1. 원본 녹음 파일은 절대 회의 폴더로 복사 또는 이동되지 않습니다. 요약에서 파일명을 언급합니다.
  2. 입력 녹음 파일이 git 작업 트리 내부에 있다면 먼저 recordings_archive로 이동한 후 새 경로에서 작업합니다.
  3. 임시 오디오 및 프레임은 임시 디렉토리에 저장되며 정리 단계에서 삭제됩니다.
  4. § 검증 단계는 성공을 보고하기 전에 아무것도 출력하지 않아야 합니다.

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 checkshow
`transcribe.py REC --out-base DIR/transcript [--lang autoen
`run_ingest.sh --context NAME [--install--check

의존성

uv (스크립트가 자체 Python 의존성을 선언). ffmpeg는 프레임 추출에만 필요. GPU는 선택 사항: CPU에서는 turbo 모델로 1시간 회의에 약 2시간 소요. 노트 가져오기는 에이전트의 Google Drive/Docs(및 선택적으로 Gmail, Calendar) 커넥터가 적절한 계정으로 연결되어 있어야 합니다.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

BattlePlan

Daily execution plan from a task tracker (local CSV, Excel workbook, or Google Sheet). Groups open tasks by context and sub-context, estimates time, finds parallel threads, and writes ready-to-paste starting prompts per thread. Starts from yesterday instead of from zero — recaps the previous day's agent sessions and git commits, pre-fills the audit, and offers resume commands. Includes an end-of-day handoff (--close), an unattended morning draft (--draft), and task management (add, done, cancel, restore, sweep, batch import). USE WHEN plan my day, daily plan, battle plan, what should I work on, close the day, end of day handoff, morning draft, task overview, standup prep, prioritize tasks, add a task, mark task done, set up battleplan, configure task tracker.

CodeQuality

Code quality loop for any repo, seen through two lenses — a tool lens (linters, type checkers, security, dead-code and duplication scanners; fix by P0 security → P1 correctness → P2 maintainability) and a principle lens (SOLID + Clean Code smells; one principle at a time, propose → confirm → apply behind characterization tests). One manifest of free local tools, one scan, one fix loop, one mandatory Quality Improvement Report. USE WHEN improve code quality, analyze code, fix linting, reduce duplication, add types, security scan, test coverage, refactor, improve code design, apply SOLID, clean code refactor, reduce complexity, kill code smells, make code maintainable, refactor legacy code, single responsibility, dependency inversion, remediation sprint, install quality tools, quality baseline, smell report, refactoring roadmap, what should we fix first. NOT FOR the issue lifecycle, branches, PRs or merging (use IssueFlow; its Remediation workflow calls this skill to pick and scope the w

관련 스킬