# secretary

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

- Author: Aiden Kim
- Repository: garimto81/claude
- Version: 20260122191729
- Stars: 1
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/garimto81/claude
- Web: https://mule.run/skillshub/@@garimto81/claude~secretary:20260122191729

---

---
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 비서 스킬입니다.

## 핵심 기능

| 기능 | 스크립트 | 설명 |
|------|----------|------|
| **이메일 분석** | `scripts/gmail_analyzer.py` | 미읽은 이메일에서 할일/마감일 추출 |
| **캘린더 분석** | `scripts/calendar_analyzer.py` | 오늘/이번주 일정 분석, 회의 준비 항목 |
| **GitHub 분석** | `scripts/github_analyzer.py` | 최근 5일 이슈/커밋/PR 활동 분석 |
| **일일 리포트** | `scripts/daily_report.py` | 종합 업무 현황 리포트 생성 |

---

## 사용 방법

### 일일 업무 현황 확인

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

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

```bash
python scripts/daily_report.py
```

### 이메일 분석

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

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

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

### GitHub 활동 분석

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

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

```bash
python scripts/github_analyzer.py --days 5
```

### 캘린더 분석

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

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

```bash
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:

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

### GitHub Token

```bash
# 환경 변수 설정
set GITHUB_TOKEN=ghp_xxxxxxxxxxxx

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

필요한 권한:
- `repo` - Private 레포지토리 접근
- `read:user` - 사용자 정보 읽기

---

## 주의 필요 항목 기준

### 이메일

| 조건 | 긴급도 | 알림 |
|------|--------|------|
| 마감일 D-1 | High | 즉시 |
| 마감일 D-3 | Medium | 일일 리포트 |
| 미응답 48시간+ | Medium | 일일 리포트 |
| 미응답 72시간+ | High | 즉시 |

### GitHub

| 조건 | 표시 |
|------|------|
| PR 리뷰 대기 3일+ | ⚠️ 주의 필요 |
| 이슈 응답 없음 4일+ | ⚠️ 주의 필요 |
| 마감일 초과 이슈 | 🚨 긴급 |
| 최근 5일 활동 없음 | 비활성 표시 안함 |

---

## 트러블슈팅

### 인증 오류

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

### GitHub API Rate Limit

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

### 이메일 분석 실패

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

---

## 연동 스킬

| 스킬 | 연동 용도 |
|------|----------|
| `google-workspace` | Gmail/Calendar OAuth 인증 |
| `github-engineer` | GitHub API 패턴 참조 |
| `issue-resolution` | GitHub 이슈 처리 연동 |

---

## 참조 문서

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

---

## 변경 로그

### v1.0.0 (2026-01-09)

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