hwanh2/meeting-review

review — Post-Meeting Analysis

미팅 종료 후 전체 분석 리포트를 생성하는 스킬.

언제 사용하나

• 미팅이 끝났거나, 미팅 중간에 깊이 있는 정리가 필요할 때
• 사용자가 "분석해줘", "오늘 미팅 정리해줘" 같이 말할 때
• 캡처(notes.md)는 이미 충분히 쌓여 있고, 이제 의미 추출이 필요할 때

동작

1. 대상 미팅 결정

• 인자가 있으면 (review mitsui-q2) → ~/meetings/*-{mitsui-q2}/ 매칭
• 인자가 없으면 → ~/meetings/.current (활성 미팅) 우선
• 그것도 없으면 → ~/meetings/ 에서 가장 최근 수정된 폴더
• 매칭 실패 시 사용자에게 후보 목록 제시 후 중단

2. 사전 검증 (가벼운 체크)

대상 미팅 폴더에 다음이 있는지 확인:

• notes.md (필수)
• images/slide-*.png (없어도 OK)
• context.md (없어도 OK, 있으면 분석 품질 ↑)

notes.md가 없으면 ❌ {폴더}: notes.md 없음 안내 후 중단.

3. meeting-analyzer 에이전트 호출

Task 도구로 meeting-analyzer 서브에이전트를 호출한다. 이유:

• 분석은 장문 작업 (수천~수만 토큰)
• 메인 세션 컨텍스트를 보호 (미팅 진행 중 caprture 흐름이 깨지지 않도록)
• 에이전트는 독립 컨텍스트에서 모든 파일을 자유롭게 읽음

호출 시 전달할 정보:

- 미팅 폴더 절대 경로: {abs_path}
- 출력 파일 경로: {abs_path}/analysis.md
- 주의사항: 사진 embed (이미 폴더에 있는 images/slide-*.png 상대 경로로),
  필요시 mermaid 다이어그램 생성, 한국어로 작성, 번역 오류 의심 구간 표시

에이전트에게 명시적으로 요청할 결과물 섹션:

1. 미팅 개요 (날짜, 참가자, 주제)
2. 한 줄 요약
3. 핵심 내용 (토픽별, 시간대 표기, 관련 슬라이드 이미지 embed)
4. 용어 사전 (외국어 → 한국어, 미팅에 나온 모든 전문 용어)
5. 주요 결정 사항
6. 열린 질문 / 미결 과제
7. 번역기가 놓친/오인한 부분
8. 사용자에게 유용한 다음 액션 (Top 3-5)
9. (선택) Mermaid 다이어그램 — 시스템 관계도, 프로세스 흐름, 시간 흐름 등 이해에 도움되면

4. 결과 보고

에이전트가 analysis.md 작성을 마치면 사용자에게:

✅ 분석 완료 → {meeting-folder}/analysis.md

[Executive Summary 3~5줄을 인라인으로]
- 한 줄 요약: ...
- 결정 사항: N개
- 열린 질문: N개
- 새 용어: N개

전체 내용을 인라인으로 다 보여주지 말 것. 사용자가 파일을 직접 열어 읽을 수 있도록 하고, 인라인은 핵심만.

사용자가 후속 질문을 하면

분석 후 사용자가 "그 ~~ 부분 더 자세히", "이 용어 무슨 뜻이야" 같이 물으면:

• review를 다시 돌리지 말 것
• analysis.md와 notes.md를 직접 읽고 답하거나, ask 스킬로 위임

엣지 케이스

| 상황 | 대처 | |---|---| | 활성 미팅도 없고 인자도 없음 | "어떤 미팅을 분석할까요?" + 최근 미팅 3개 목록 | | 인자가 모호 (여러 폴더 매칭) | 후보 목록 제시 | | 기존 analysis.md 이미 존재 | 덮어쓰기 전 확인: "기존 분석을 새로 작성할까요? (y/n)" | | context.md가 비어 있음 | 그대로 진행하되, 분석 끝에 "💡 context.md를 채우면 다음 분석이 더 정확합니다" 한 줄 안내 |

주의

• 에이전트 호출은 무겁다. 사용자가 "그냥 짧게 요약만" 같이 말하면 → recap 스킬로 위임
• 절대 notes.md나 context.md를 수정하지 말 것 (read-only 분석)
• analysis.md만 쓴다