advisory-minutes

SkillDocs & knowledge

Lets your agent turn a Zoom advisory session transcript into Notion meeting minutes, task board entries, and a KakaoTalk client notification.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the advisory-minutes skill

About this capability

Read this after a Getback 1:1 advisory session (CEO A · Director B) ends, when you receive the Zoom recording transcript and need to post the minutes to the Notion coaching dashboard, register tasks on the task board, update dashboard wording, and notify the client via KakaoTalk. Handles requests li

What this skill tells your AI

The instructions your AI receives, as published by bam-bam-2/solo-skills in skills/advisory-minutes/SKILL.md and read by ahel’s review.

이 스킬이 시스템에 하는 일 (설치 전 확인)

  • 전사록을 읽어 노션 페이지를 생성·수정합니다. 노션 API 키가 필요합니다.
  • 클라이언트에게 메신저 통보를 보내는 단계가 있습니다. 기본값은 발송 전 확인입니다.
  • DB ID는 플레이스홀더입니다. 본인 워크스페이스 값으로 바꿔야 합니다.

자문 회의록 파이프라인

밤밤의 1:1 자문 세션은 줌으로 하고, 기록 정본은 노션 클라이언트별 코칭 대시보드다. 세션이 끝나면 이 순서로 처리한다.

0. 먼저 읽을 것

  • ~/Projects/getback/자문/CLAUDE.md — 노션 ID 표, 대시보드 규칙, 톤, 회차 산정 기준(계약 회차 기준이며 로컬 파일명의 "N차미팅"과 다르다)
  • 직전 회차 회의록 페이지 — 형식을 그대로 잇는다

⚠️ 대시보드는 클라이언트에게 공유되는 페이지다. 밤밤이 전달을 지시·승인한 것만 올린다. 밤밤의 내부 판단(수임료, 클라이언트 소속 병원과의 관계, 경쟁자 실명 해부, 협찬 부탁 같은 사담)은 회의록에서 걷어낸다.

1. 줌 전사록 받기

~/Projects/getback/운영/pipeline/.envZOOM_ACCOUNT_ID / ZOOM_CLIENT_ID / ZOOM_CLIENT_SECRET(S2S OAuth).

POST https://zoom.us/oauth/token   grant_type=account_credentials&account_id=...
     Authorization: Basic base64(client_id:client_secret)
GET  https://api.zoom.us/v2/users/me/recordings?from=YYYY-MM-DD&to=YYYY-MM-DD

⚠️ 가장 큰 함정 — 다운로드는 액세스 토큰이 따로다. download_url에 일반 Bearer 토큰을 붙이면 401 {"errorCode":124,"Forbidden"}이 난다. 반드시:

GET https://api.zoom.us/v2/meetings/{URL인코딩된 uuid}/recordings?include_fields=download_access_token&ttl=3600
→ 응답의 download_access_token 을 download_url 뒤에 ?access_token=... 로 붙여서 curl -L
  • 계정 표시명이 **"레코드 나우"**라 회의 제목만으로는 누구와 한 세션인지 알 수 없다. 전사록의 화자 이름으로 확인한다.
  • start_time은 UTC다. 한국 시각은 +9 — 밤 늦게 시작한 세션은 날짜가 하루 넘어간다(밤밤 자문은 자정 넘겨 시작하는 경우가 잦다). 회의록 날짜는 실제 시작 시각 기준으로 적고, 밤밤에게 한 줄로 알린다.
  • VTT는 화자별로 잘게 쪼개져 있으니 같은 화자 연속 발화를 합쳐서 읽는다(96KB → 26KB로 줄어든다).
  • 전사 품질 주의: 고유명사·숫자가 자주 깨진다. 숫자·비율은 회의록에 옮기기 전에 의심하고, 애매하면 밤밤에게 확인한다.
  • 원본은 로컬 ~/Projects/getback/자문/클라이언트/{이름}/YYYY-MM-DD_N차미팅_전사록.txt|.vtt로 저장한다.

2. 회의록 작성

클라이언트/{이름}/에 세션 노트 md를 먼저 쓰고(정본 소스), 그걸 노션에 올린다. 고정 형식:

> 📌 일시 YYYY.MM.DD(요일) HH:MM · 약 N분  |  참석 밤밤(자문) · {클라이언트}  |  주제 ... (N회차)
> 🎯 한 줄 결론 — ...
## 🎯 핵심 결론      (quote 한 문단)
## 🔑 핵심 논의 흐름  (굵은 소제목 + 불릿, 중요한 건 ⭐)
## ✅ 결정사항        (번호 목록)
## 📌 액션 아이템     (체크박스, (예지)/(밤밤) 담당 표기)
## 🗓️ 다음 단계

톤은 프리미엄 존댓말(밤밤 캐주얼 SNS체 아님). 밤밤의 발언을 클라이언트가 읽을 문장으로 다시 쓴다.

3. 노션에 올리기 — MCP 말고 REST

⚠️ 노션 MCP create-pages는 숫자 프로퍼티를 문자열로 보내서 400을 낸다(Invalid number value for property 회차: 4). 회차 같은 number 필드가 있으면 처음부터 REST API로 만든다.

토큰: ~/Projects/getback/운영/discord_bot/.envNOTION_TOKEN(integration "claude", 이 페이지 트리에 공유됨). POST https://api.notion.com/v1/pages + Notion-Version: 2022-06-28, 마크다운을 블록으로 변환해 children에 넣는다(quote / heading_2 / bulleted_list_item / numbered_list_item / to_do / paragraph, **굵게**는 annotations.bold). children은 요청당 100블록 제한.

DB ID는 자문/CLAUDE.md 표 참조. (B 원장: 회의록 <NOTION_DB_ID>, 할 일 <NOTION_DB_ID>, 대시보드 <NOTION_DB_ID>)

4. 이어지는 3가지

  1. 할 일 보드에 액션 아이템 등록 — 담당(고객/밤밤), 기한, 상태=할 일, ✅=false
  2. 대시보드 상단 "🎯 지금 가장 먼저" quote를 이번 회차 기준으로 교체 (노션 MCP update-page + update_content 검색치환이 편하다)
  3. 작업물 DB는 밤밤이 "전달했다"고 확인한 산출물만 등록 — 작업 중인 초안은 올리지 않는다

5. 클라이언트에게 카톡 통보

kmsg로 보낸다(줄바꿈 보존됨). 방 이름은 kmsg chats --json으로 확인 — B 원장님은 B 원장 (겟백 5기 지원).

ssh -o BatchMode=yes localhost 'export PATH=/opt/homebrew/bin:$PATH; kmsg send "<방>" "<본문>"'

본문은 짧은 업무 확인체로. 회의록 링크는 https://www.notion.so/<하이픈 없는 페이지 id>. 끝에 반드시 한 줄: — 이 메시지는 밤밤을 대신해 AI가 정리해서 보냈습니다 보낸 뒤 kmsg read "<방>" --limit 3으로 실제 전송을 확인한다.

Signals

GitHub stars
365
Forks
90
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
advisory-minutes
Source
github.com/bam-bam-2/solo-skills