Cap

예: /cap new mitsui-q2-review

1. ~/meetings/{YYYY-MM-DD}-{slug}/ 디렉토리 생성
   • slug = meeting-name을 소문자/하이픈으로 정규화 (한글은 그대로)
   • 같은 날 같은 이름이 이미 있으면 -2, -3 접미사
2. 그 안에 images/ 서브디렉토리 생성
3. notes.md 초기화:

   # 미팅 — {meeting-name}
   
   - 날짜: {YYYY-MM-DD}
   - 시작: {HH:MM}
   

4. context.md를 템플릿 기반으로 초기화 (비어 있는 상태로 생성하여 사용자가 채울 수 있도록):

   # Context — {meeting-name}
   
   > 이 파일은 선택사항이지만, 채워두면 분석(meeting-review) 품질이 크게 향상됩니다.
   > 언제든 `/cap context ...` 로 추가하거나 직접 편집 가능합니다.
   
   ## 미팅 목적
   
   ## 참가자 (이름 / 역할)
   
   ## 프로젝트 배경
   
   ## 본인 역할 / 알고 싶은 것
   
   ## 관련 자료 (링크, 파일)
   

5. ~/meetings/.current에 새 미팅 폴더의 절대 경로를 한 줄로 기록 (활성 미팅 추적)
6. 한 줄로 확인 + context 안내 한 줄:

   📁 새 미팅 시작 — {경로}
   💡 배경 정보 있으면 `/cap context ...` 또는 자연어로 알려주세요 (선택)
   

모드 2: 새 슬라이드 캡처 — 메시지에 이미지가 있을 때

이미지 유무로만 판별. 텍스트가 같이 있어도 OK, 없어도 OK.

저장 단계

1. ~/meetings/.current 읽어 활성 미팅 폴더 찾기
   • 없으면: ⚠️ 활성 미팅 없음. /cap new {이름}으로 먼저 시작하세요. 하고 중단
2. 활성 미팅의 images/를 스캔해서 다음 슬라이드 번호 결정 (slide-01, slide-02, …)
   • 항상 디렉토리 스캔 기반. notes.md 파싱 의존 금지
3. 첨부 이미지를 images/slide-{NN}.png로 저장
   • Claude Code가 이미지 경로를 노출하는 방식: a) 임시 파일 경로(예: /var/folders/.../clipboard-*.png)가 보이면 → cp로 복사 b) 경로가 불분명하면 → 추측 가능한 가장 합리적인 경로로 시도 후 실패 시 보고
4. notes.md 끝에 새 섹션 append:

   
   ## 슬라이드 {NN} ({HH:MM})
   ![](images/slide-{NN}.png)
   
   

5. 메시지에 텍스트가 같이 있다면 → 그 텍스트를 모드 3 저장 로직으로 첫 발화로 즉시 추가

분석 단계 (중요 — 모드 2에서 항상 수행)

저장 후 즉시 짧은 분석을 출력한다 (실시간 분석 형식 참고).

이미지 캡처는 시각 정보가 새로 들어왔으므로 분석에 다음을 포함:

• 📊 슬라이드 요약: 새 화면이 무엇을 보여주는지 한 줄 (Read 도구로 이미지를 빠르게 분석)
• 💭 요지 (텍스트 있을 시): 발화의 핵심
• 🆕 새 용어: 처음 등장한 일본어/약어
• ⚠️ 번역 의심: 번역기가 오인한 듯한 부분

모드 3: 기존 슬라이드에 텍스트 추가 — 이미지 없이 텍스트만

저장 단계

1. ~/meetings/.current 읽어 활성 미팅 찾기 (없으면 모드 2와 동일하게 안내)
2. notes.md를 읽어 가장 마지막 ## 슬라이드 섹션 위치 찾기
3. 그 섹션 끝에 발화 블록 append:

   
   ### [{HH:MM}] 발화
   
   > {사용자가 보낸 텍스트 — 원문 그대로 preserve}
   

   • 사용자 텍스트가 여러 문단이면 각 줄 앞에 > 를 붙여 blockquote로 보존
4. 만약 아직 슬라이드가 하나도 없다면 (## 슬라이드 섹션 없음): notes.md에 ## 메모 (슬라이드 없음) 섹션을 만들고 거기에 추가

분석 단계 (중요 — 모드 3에서 항상 수행)

저장 후 즉시 짧은 분석을 출력한다.

텍스트만 캡처는 발화 내용에 집중:

• 💭 요지: 방금 발화의 핵심 (한 줄)
• 🆕 새 용어: 처음 등장한 용어 (있으면)
• ⚠️ 번역 의심: 번역기 오인 의심 (있으면)
• 🔗 맥락 연결: 같은 슬라이드 내 이전 발화와 어떻게 이어지는지 (필요 시)

모드 4: 배경 정보 저장 — /cap context {내용} 또는 자연어 감지

명시적 형태: /cap context 이 미팅은 일본 Payroll 팀 기술 리뷰고, 나는 한국 쪽 PM이야

자연어 감지: 사용자가 "이 미팅은 ~에 대한 거야", "참가자는 A, B, C야", "배경: ~" 같은 문장을 보내면 현재 활성 미팅의 context로 판단.

• 판단이 애매하면 물어본다: "이걸 context.md에 저장할까요?"

동작:

1. ~/meetings/.current 읽어 활성 미팅 찾기
2. 활성 미팅의 context.md 읽기
3. 적절한 섹션에 사용자 내용 통합:
   • 내용이 "참가자"에 대한 것 → ## 참가자 섹션 아래 추가
   • 내용이 "목적/배경"에 대한 것 → ## 미팅 목적 또는 ## 프로젝트 배경
   • 섹션 판별이 어려우면 ## 기타 메모 섹션에 append
4. 한 줄 확인: 📋 context 저장됨

시간/날짜 표기

• 시각: date "+%H:%M" (24시간제, 로컬 시간)
• 날짜: date "+%Y-%m-%d"
• 모든 타임스탬프는 사용자의 macOS 로컬 시간 기준

활성 미팅 상태 추적

~/meetings/.current 파일이 단일 진실 공급원:

• 내용: 활성 미팅 폴더의 절대 경로 한 줄
• 새 미팅을 만들 때마다 덮어쓴다
• 사용자가 명시적으로 "미팅 끝" 같은 말을 하면 비워도 좋지만, 강제는 아님

실시간 분석 형식

저장 직후 짧은 분석을 출력한다. 가독성이 최우선. 사용자는 미팅 중에 이 출력을 힐끗 보고 이해할 수 있어야 한다.

표준 출력 형식 (수직 레이아웃, 불릿 사용)

📸 슬라이드 {NN} + 발화 ({HH:MM})

📊 슬라이드
   • {한 줄 요약}
   • {보조 정보 — 선택}

💭 요지
   • {핵심 1}
   • {핵심 2}
   • {핵심 3 — 선택}

🆕 새 용어 (top 3)
   • {용어1} — {짧은 정의}
   • {용어2} — {짧은 정의}
   • {용어3} — {짧은 정의}

⚠️ 번역 오인 (top 3)
   • "{이상한 번역}" → {보정}
   • "{이상한 번역}" → {보정}
   • "{이상한 번역}" → {보정}

🔗 맥락
   • {이전 흐름과의 연결 한 줄}
   • {미결/후속 액션 — 선택}

항목별 규칙 (엄격)

공통 규칙:

• 각 섹션은 이모지+라벨 한 줄 다음 들여쓰기 불릿으로 내용
• 각 불릿은 한 줄 — 최대 ~30자. 길면 짜르거나 쪼갬
• 섹션 간 빈 줄 1개로 시각 구분
• 해당 사항 없는 섹션은 통째로 생략 (라벨도 출력 안 함)

📊 슬라이드 (이미지 캡처 시만)

• 1~2개 불릿. 이미지가 보여주는 것 핵심만.
• ❌ 긴 나열 ("컬럼: A/B/C/D/E/F/G") 금지 — 핵심 패턴만 ("종별 × 정기권 매트릭스")

💭 요지

• 최대 3개 불릿
• 각 불릿은 한 생각만 담음
• 발화자 인용 시: • [발화자]: "짧은 인용" 형식

🆕 새 용어

• 최대 3개 (그 이상 보이면 가장 중요한 3개만)
• 포맷: • {원어} — {10~15자 정의}
• 이미 글로서리에 있는 용어는 표시 안 함 (grep으로 확인)
• 한 줄에 여러 용어 나열 금지 (반드시 불릿 분리)

⚠️ 번역 오인

• 최대 3개
• 포맷: • "{이상한}" → {보정} — 화살표 정렬
• 가장 가치 있는 섹션이므로 발견하면 우선 노출
• 원문(일본어/중국어) 명시는 선택 — 너무 길면 생략

🔗 맥락

• 최대 2개 불릿
• 이전 발화/슬라이드와의 연결 + 미결 후속 액션
• 너무 평범한 이어짐 ("앞 내용 부연")은 생략

분석 길이 원칙

• 전체 약 15~25줄 (섹션 라벨 + 빈 줄 + 불릿 포함)
• 짧은 불릿 × 많은 줄이 긴 문장 × 적은 줄보다 훨씬 읽기 쉬움
• 해당 항목 없으면 생략 — 빈 라인이나 "없음" 라벨 금지
• 분석할 게 진짜 없으면 (모드 1, 모드 4) 저장 확인만 1~2줄

❌ 절대 피할 것

❌ 나쁜 예 (벽):
📊 슬라이드: P3 화면 "継続支給の確認" 테스트 환경(2025년 6월 급여). 행: 종별별(TM101~TM104) "공공교통_2km미만 / マイカー2km미만..." 컬럼: PV판정일수(15.0)/지급제 개시일·종료일·금액/算定額/出力額...
💭 요지: 단체 테스트 시연 — Csion으로 더미 유저 만들어 P3 화면에서 신청 → 결과 확인. Kenta가 핵심 질문 던짐: "화면 없이 백엔드만으로..."
🆕 새 용어: 継続支給(케이조쿠시큐) = 계속지급 확인 / 算定額/出力額 = 산정액/출력액 / 中間テーブル(추칸 테이블) = 지시 테이블...

문제점:

• 한 섹션에 한 줄이 수십 자 → 화면 wrap으로 여러 줄 됨
• / 와 , 로 여러 항목을 한 줄에 밀어넣음
• 들여쓰기/불릿 없음 → 계층 안 보임

✅ 좋은 예 (같은 내용, 불릿 분리):
📊 슬라이드
   • P3 "継続支給の確認" 테스트 환경
   • 종별(TM101~TM104) × 정기권 매트릭스

💭 요지
   • 단체 테스트 시연 — 더미 유저로 P3 신청
   • 핵심 질문(Kenta): "백엔드만으로 테스트 가능?"
   • 답(平手): 중간 테이블로 화면 우회 가능

🆕 새 용어 (top 3)
   • 継続支給 — 계속 지급 확인
   • 中間テーブル — Trans 진입점
   • 算定額/出力額 — 산정액 / 출력액

같은 정보량, 훨씬 빨리 읽힘.

효율 원칙

• 메인 세션에서 직접 처리 — 서브에이전트 호출 X (응답 속도 우선)
• 글로서리는 grep 수준으로만 참조 (전체 read X)
• 이전 발화 맥락은 마지막 100~200줄만 (notes.md 전체 read X)
• 분석에 필요 없는 호출은 하지 말 것

예시

좋은 예 1 (이미지 + 텍스트, 정보 풍부):

📸 슬라이드 03 + 발화 (13:45)

📊 슬라이드
   • Calcu 9단계 급여 계산 흐름도
   • 사회보험료 계산은 3번째 단계

💭 요지
   • 발표자가 사회보험료 계산 위치를 설명
   • 앞 단계(지급액)의 결과가 입력으로 들어감

🆕 새 용어 (top 2)
   • 사회보험 Calculation — 사회보험료 계산 모듈
   • 過課税額 — 과세 금액

좋은 예 2 (텍스트만, 번역 오류 집중):

📝 추가 → 슬라이드 03 (13:48)

💭 요지
   • Varit이 변동 데이터 입구임을 재차 강조

⚠️ 번역 오인
   • "발리섬" → Varit (バリット)
   • "예능 단계" → 계산 단계 (芸能↔計算 동음)

좋은 예 3 (최소 — 새 정보 없음):

📝 추가 → 슬라이드 03 (13:50)

💭 요지
   • 앞 발화 부연, 새 정보 없음

좋은 예 4 (이미지만, 텍스트 없음):

📸 슬라이드 04 (13:52)

📊 슬라이드
   • 조직도 — HR / Payroll / Dev 3부서
   • Dev팀이 Varit 담당

나쁜 예 (긴 분석):

📸 슬라이드 03 저장

분석 결과를 자세히 말씀드리면 이 슬라이드는 ... [장문] ...
앞 슬라이드와 비교했을 때 ... [장문] ...

→ 절대 이렇게 하지 말 것. 자세한 건 사용자가 /meeting-review로 명시 요청 시에만.

모드 1, 4 응답 길이

모드 1(새 미팅), 모드 4(context 저장)는 분석할 내용이 없으므로 1~2줄만:

• ✅ 📁 새 미팅 시작 — {경로}
• ✅ 📋 context 저장됨

엣지 케이스

주의

• 슬라이드 번호는 반드시 디렉토리 스캔 기반으로 매긴다
• ~/meetings/.current는 단일 라인 파일
• macOS 한정: BSD date, 경로 구분자 /
• 이 스킬의 본질: 저장 + 짧은 실시간 분석. 두 가지 모두 매번 수행한다.
• 무거운 작업은 위임: 종합 분석(meeting-review), 누적 요약(recap), 명시적 질문(ask)은 다른 스킬의 책임. cap의 분석은 항상 짧고 빠르게.