notion-cv-update

CV 업데이트

사용자의 요청에 따라 Notion CV 페이지의 특정 섹션을 수정하거나 새 항목을 추가한다.

워크플로우

1. $ARGUMENTS에서 업데이트 요청을 파싱한다.

   • 입력 형태에 따라 유연하게 처리한다:

   간단한 지시형:

   • "Skills 섹션에 Rust 추가" → 대상 섹션과 동작을 식별

   마크다운/텍스트 붙여넣기:

   • 사용자가 마크다운, 문단, 성과 목록 등을 그대로 붙여넣은 경우
   • 내용에서 대상 섹션을 추론한다 (Heading이 포함되어 있으면 해당 섹션, 없으면 사용자에게 확인)
   • 마크다운 서식(Heading, 볼드, 목록 등)을 Notion 블록 타입으로 변환한다:
     • ## 제목 → heading_2 블록
     • ### 소제목 → heading_3 블록
     • - 항목 → bulleted_list_item 블록
     • 1. 항목 → numbered_list_item 블록
     • **볼드** → bold annotation이 적용된 rich_text
     • 일반 문단 → paragraph 블록

   비정형 텍스트 (경력, 성과 등):

   • 구조화되지 않은 텍스트가 입력되면 CV에 적합한 형태로 재구성한다
   • 정량적 성과를 식별하여 강조한다 (예: "40% 단축" → 40% 단축)
   • 기술 스택을 분리하여 정리한다
   • 재구성한 결과를 사용자에게 보여주고 승인을 받은 후 반영한다

2. .env 파일에서 NOTION_CV_PAGE_ID 값을 읽는다.

   • .env 파일이 없거나 NOTION_CV_PAGE_ID가 없는 경우: ".env 파일에 NOTION_CV_PAGE_ID가 설정되지 않았습니다. /notion-cv-setup을 실행하여 초기 설정을 완료하세요." 출력 후 중단한다.

3. Notion MCP를 통해 현재 CV 페이지의 블록을 조회한다.

   • retrieve_block_children를 page_size: 30으로 호출한다.
   • has_more가 true이면 next_cursor로 다음 페이지를 조회한다.
   • MCP 응답에서 type, id, rich_text의 plain_text만 추출한다. 원본 JSON을 반복하지 않는다.
   • 모든 Heading 블록(heading_1, heading_2, heading_3)을 섹션 구분자로 인식한다.
   • 고정된 섹션 목록에 의존하지 않는다 - 페이지에 존재하는 Heading을 그대로 사용한다.
   • 각 섹션의 Block ID를 파악한다.

4. 대상 섹션을 찾고 업데이트 방식을 결정한다.

   기존 블록 수정 시:

   • 해당 블록의 Block ID로 update_block을 호출한다.
   • 블록의 type에 맞는 형식으로 내용을 구성한다.

   새 항목 추가 시:

   • 해당 섹션의 마지막 블록 뒤에 append_block_children으로 삽입한다.
   • 섹션의 기존 형식(글머리 기호, 번호 목록 등)을 따른다.

   블록 삭제 시:

   • delete_block으로 해당 블록을 제거한다.
   • 삭제 전 사용자에게 확인을 요청한다.

5. 변경 결과를 요약하여 출력한다.

   • 어떤 섹션이 변경되었는지
   • 추가/수정/삭제된 내용 요약
   • 변경 후 해당 섹션의 현재 상태

사용 예시

간단한 지시:

/notion-cv-update Skills 섹션에 Rust 추가
/notion-cv-update Summary를 "시니어 백엔드 개발자"로 수정

마크다운 붙여넣기:

/notion-cv-update 경력에 추가:

### Anthropic (2025.01 - 현재)
- **역할**: AI Engineer
- Claude Code 플러그인 시스템 설계 및 구현
- 플러그인 마켓플레이스 활성 사용자 300% 증가

비정형 텍스트 붙여넣기:

/notion-cv-update 경력에 추가해줘

2023년부터 ABC회사에서 백엔드 개발자로 일함.
API 응답시간 40% 단축, MAU 10만명 달성.
Go, PostgreSQL, Redis, Kubernetes 사용.

Block 조작 원칙

1. 절대 페이지 전체를 덮어쓰지 않는다 - 개별 블록 단위로만 조작
2. 수정 대상 블록의 Block ID를 정확히 식별한 후 작업한다
3. 섹션 Heading 블록은 기본적으로 수정하지 않는다 (앵커 역할). 사용자가 명시적으로 요청한 경우에만 수정한다.
4. 기존 포맷팅(볼드, 이탤릭, 링크 등)을 보존한다
5. 변경 전 현재 상태를 확인하고, 변경 후 결과를 검증한다

에러 처리

• 섹션을 찾을 수 없음: 현재 페이지에서 발견된 Heading 목록을 표시하여 사용자가 정확한 섹션명을 선택하도록 안내
• MCP 연결 실패 / Notion API 호출 불가: "claude mcp list로 Notion MCP 서버가 등록되어 있는지 확인하세요. 등록되지 않았다면 /notion-cv-setup을 실행하고, claude --continue로 세션을 재시작하세요." 출력
• Block ID 조회 실패: /notion-cv-read를 먼저 실행하도록 안내
• API 오류: 에러 메시지를 사용자에게 전달하고, 부분 변경이 있었다면 현재 상태를 출력