Notion Summary - 세션 결과 Notion 업로드

Overview

Claude Code 세션의 작업 내용을 Notion 문서로 정리하여 업로드하는 스킬입니다.

핵심 기능:

• 대화 내용 요약 및 업로드
• 작업 결과물 (코드 변경, 생성 파일 등) 정리
• 지정된 Notion 페이지 하위에 자동 생성
• 날짜/프로젝트별 체계적 문서화

When to Use

이 스킬은 다음 상황에서 활성화됩니다:

명시적 요청:

• "노션에 업로드해줘"
• "결과 노션에 정리해줘"
• "오늘 작업 내용 저장해줘"
• "notion summary"

자동 활성화:

• 긴 작업 세션 완료 후
• 사용자가 세션 정리 요청 시

Prerequisites

환경 변수 (필수)

# ~/.bashrc, ~/.zshrc, 또는 ~/.profile에 추가
export NOTION_TOKEN="secret_xxxxxxxxxxxxxxxxxxxx"

토큰 발급 방법:

1. https://www.notion.so/my-integrations 접속
2. "New integration" 클릭
3. 이름 지정 후 생성
4. "Internal Integration Token" 복사

Static 파일 설정 (필수)

~/.agents/NOTION.md 파일에 페이지 설정:

# Notion 설정

## 기본 페이지
- **페이지 ID**: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
- **페이지 이름**: Claude 작업 기록

## 업로드 설정
- **날짜별 하위 페이지**: true
- **프로젝트별 분류**: true

의존성 설치

pip install notion-client

Notion 페이지 권한 설정

1. 업로드할 Notion 페이지 열기
2. 우측 상단 ... → "Connections" 클릭
3. 생성한 Integration 선택하여 연결

Workflow

Step 1: 설정 확인

스킬 실행 시 다음을 확인합니다:

1. NOTION_TOKEN 환경 변수 존재 확인
2. ~/.agents/NOTION.md에서 페이지 ID 읽기 (static-index 활용)

# 환경 변수 확인
echo $NOTION_TOKEN

# static 파일 확인
./scripts/notion-upload.py --check-config

Step 2: 세션 내용 수집

현재 세션에서 다음 정보를 수집합니다:

대화 요약:

• 사용자 요청 사항
• 주요 논의 내용
• 결정된 사항

작업 결과물:

• 생성/수정된 파일 목록
• 코드 변경 요약
• 실행된 명령어

Step 3: Notion 페이지 생성

지정된 부모 페이지 하위에 새 페이지를 생성합니다:

Claude 작업 기록/
├── 2025-01-15 - project-name/
│   ├── 요약
│   ├── 작업 내용
│   └── 파일 변경 사항
└── 2025-01-14 - other-project/

Step 4: 콘텐츠 업로드

# 스크립트 실행
./scripts/notion-upload.py \
  --summary "대화 요약 내용" \
  --changes "파일 변경 사항" \
  --project "프로젝트명"

Examples

예시 1: 기본 업로드

사용자: 오늘 작업한 내용 노션에 정리해줘

Claude: 노션에 업로드를 준비합니다.

## 업로드 내용 미리보기

### 세션 요약
- 노션 업로드 스킬 개발
- SKILL.md 및 업로드 스크립트 작성

### 작업 결과
- 생성 파일: integrations/notion-summary/SKILL.md
- 생성 파일: integrations/notion-summary/scripts/notion-upload.py

이대로 업로드할까요? (Y/n)

예시 2: 프로젝트 지정 업로드

사용자: 이 작업 결과를 agent-skills 프로젝트로 노션에 저장해

Claude: 노션에 업로드합니다.

✅ 업로드 완료
- 페이지: Claude 작업 기록 / 2025-01-15 - agent-skills
- URL: https://notion.so/xxxxx

예시 3: 설정 없을 때

사용자: 노션 업로드해줘

Claude: ⚠️ 노션 설정이 필요합니다.

1. NOTION_TOKEN 환경 변수를 설정해주세요:
   export NOTION_TOKEN="secret_xxx"

2. ~/.agents/NOTION.md 파일을 생성해주세요:
   페이지 ID와 업로드 설정을 포함해야 합니다.

자세한 설정 방법을 안내해드릴까요?

Configuration

~/.agents/NOTION.md 구조

# Notion 설정

## 기본 페이지
- **페이지 ID**: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
- **페이지 이름**: Claude 작업 기록

## 업로드 설정
- **날짜별 하위 페이지**: true
- **프로젝트별 분류**: true
- **기본 프로젝트명**: general

## 콘텐츠 템플릿
### 포함 항목
- 세션 요약: true
- 작업 결과물: true
- 파일 변경 사항: true
- 실행 명령어: false

환경 변수 옵션

변수	필수	설명
NOTION_TOKEN	필수	Notion Integration 토큰
NOTION_PAGE_ID	선택	기본 페이지 ID (static 파일보다 우선)

Best Practices

DO:

• 토큰은 반드시 환경 변수로 관리
• 업로드 전 미리보기로 내용 확인
• 프로젝트별로 체계적으로 분류
• 민감 정보 제외 확인

DON'T:

• 토큰을 코드나 설정 파일에 하드코딩하지 않기
• API 키나 비밀번호가 포함된 내용 업로드하지 않기
• 너무 자주 업로드하여 API 한도 초과하지 않기

Troubleshooting

문제 1: 인증 실패

Error: Invalid token

해결:

1. 토큰 유효성 확인: echo $NOTION_TOKEN
2. Integration이 페이지에 연결되었는지 확인
3. 토큰 재발급 필요 시 my-integrations에서 재생성

문제 2: 페이지 없음

Error: Page not found

해결:

1. 페이지 ID가 올바른지 확인
2. Integration이 해당 페이지에 접근 권한이 있는지 확인
3. Notion 페이지 → Connections에서 Integration 연결

문제 3: Static 파일 없음

Warning: NOTION.md not found

해결:

# 템플릿 생성
cat > ~/.agents/NOTION.md << 'EOF'
# Notion 설정

## 기본 페이지
- **페이지 ID**: [여기에 페이지 ID 입력]
- **페이지 이름**: Claude 작업 기록

## 업로드 설정
- **날짜별 하위 페이지**: true
- **프로젝트별 분류**: true
EOF

Security

이 스킬은 다음 보안 규칙을 따릅니다:

1. 토큰 보호: NOTION_TOKEN은 환경 변수로만 관리
2. 민감 정보 필터링: 업로드 전 API 키, 비밀번호 패턴 검사
3. static-index 연동: ~/.agents/SECURITY.md 규칙 적용
4. 업로드 확인: 사용자 확인 후 업로드 (기본 동작)

Resources

파일	설명
scripts/notion-upload.py	Notion API 업로드 스크립트
~/.agents/NOTION.md	사용자 노션 설정 (static-index 참조)

Integration with Other Skills

스킬	연동 방식
static-index	NOTION.md 파일 경로 조회
security-auditor	업로드 전 민감 정보 검사
git-commit-pr	커밋 후 자동 문서화 연동 가능