name: secretary description: > AI 비서 스킬. Gmail, Google Calendar, GitHub를 통합 분석하여 할일을 자동 추출하고 일일 업무 현황을 제공합니다. "오늘 할 일", "이메일 분석", "GitHub 현황" 요청 시 사용합니다. version: 1.0.0

triggers: keywords: - "할 일" - "todo" - "오늘 일정" - "이메일 분석" - "gmail 분석" - "github 현황" - "github 분석" - "업무 현황" - "일일 리포트" - "비서" - "secretary" - "놓친 일" - "미응답" file_patterns: - "/secretary/" - "/*.md" - "/calendar.json" - "**/.env*" context: - "업무 관리" - "일정 확인" - "이메일 정리" - "프로젝트 현황"

capabilities:

• gmail_analysis
• calendar_analysis
• github_activity
• daily_report

model_preference: sonnet auto_trigger: true

Secretary Skill - AI 비서

Gmail, Google Calendar, GitHub를 통합 분석하여 할일을 자동 추출하고 일일 업무 현황을 제공하는 AI 비서 스킬입니다.

핵심 기능

사용 방법

일일 업무 현황 확인

사용자가 "오늘 할 일 정리해줘", "업무 현황 알려줘" 등을 요청하면:

1. scripts/daily_report.py 실행하여 종합 리포트 생성
2. Gmail, Calendar, GitHub 데이터를 순차적으로 수집
3. 우선순위별로 정리된 할일 목록 출력

python scripts/daily_report.py

이메일 분석

사용자가 "이메일 분석해줘", "미읽은 메일 확인" 등을 요청하면:

1. scripts/gmail_analyzer.py 실행
2. 미읽은 이메일 목록 조회
3. 각 이메일에서 액션 아이템 추출
4. 긴급도 분류 (High/Medium/Low)

python scripts/gmail_analyzer.py --unread --days 3

GitHub 활동 분석

사용자가 "GitHub 현황", "프로젝트 상태" 등을 요청하면:

1. scripts/github_analyzer.py 실행
2. 최근 5일 활동 레포지토리 감지
3. 커밋/이슈/PR 분석
4. 주의 필요 항목 감지

python scripts/github_analyzer.py --days 5

캘린더 분석

사용자가 "오늘 일정", "이번주 회의" 등을 요청하면:

1. scripts/calendar_analyzer.py 실행
2. 오늘/이번주 일정 조회
3. 회의 준비 필요 항목 표시

python scripts/calendar_analyzer.py --today
python scripts/calendar_analyzer.py --week

출력 형식

일일 리포트

📊 일일 업무 현황 (2026-01-09)

📧 이메일 할일 (3건)
├── [긴급] 계약서 검토 요청 - 마감 1/10 (발신: 김대표)
├── [보통] 회의록 확인 요청 (발신: 이팀장)
└── [낮음] 뉴스레터 구독 확인

⚠️ 미응답 이메일 (2건)
├── RE: 프로젝트 일정 문의 - 48시간 경과
└── RE: 예산 승인 요청 - 72시간 경과

📅 오늘 일정 (2건)
├── 10:00 팀 스탠드업 (Google Meet)
└── 14:00 클라이언트 미팅 (회의실 A)

💻 GitHub 주의 필요 (2건)
├── PR #42 (secretary): 리뷰 대기 3일
└── Issue #15 (youtuber): 응답 없음 4일

🔥 활발한 프로젝트 (최근 5일)
├── claude/secretary: 12 commits, 3 issues
├── youtuber_chatbot: 8 commits, 5 issues
└── wsoptv: 3 commits, 1 issue

인증 설정

Google OAuth (Gmail, Calendar)

기존 google-workspace Skill의 인증 재사용:

C:\claude\json\
├── desktop_credentials.json   # OAuth 클라이언트 ID
└── token.json                 # OAuth 토큰 (자동 생성)

필요한 OAuth Scopes:

SCOPES = [
    'https://www.googleapis.com/auth/gmail.readonly',
    'https://www.googleapis.com/auth/calendar.readonly',
]

GitHub Token

# 환경 변수 설정
set GITHUB_TOKEN=ghp_xxxxxxxxxxxx

# 또는 파일로 설정
C:\claude\json\github_token.txt

필요한 권한:

• repo - Private 레포지토리 접근
• read:user - 사용자 정보 읽기

주의 필요 항목 기준

이메일

GitHub

트러블슈팅

인증 오류

# Google 토큰 갱신
rm C:\claude\json\token.json
python scripts/gmail_analyzer.py  # 재인증

GitHub API Rate Limit

# 인증 없이 60 req/hour
# 인증 시 5000 req/hour
# Rate limit 초과 시 1시간 대기 필요

이메일 분석 실패

• 이메일 본문이 HTML인 경우 텍스트 추출 후 분석
• 첨부파일은 분석 대상에서 제외
• 스레드 이메일은 가장 최근 메시지만 분석

연동 스킬

참조 문서

• references/gmail_api_guide.md - Gmail API 상세 가이드
• references/github_api_guide.md - GitHub API 상세 가이드

변경 로그

v1.0.0 (2026-01-09)

• 초기 릴리스
• Gmail 분석 기능
• Calendar 분석 기능
• GitHub 활동 분석 기능 (최근 5일)
• 일일 종합 리포트 생성