happybell80 6099abe989 fix: SKILL.md frontmatter에 endpoints 섹션 추가 (executor HTTP 메서드 SSOT)
- skill-calendar: create_event(POST), list_events(GET), delete_event(DELETE)
- skill-email: send(POST), read(GET), process(POST)

연결: rb8001 PR #188

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-03 20:29:09 +09:00

64 lines
1.5 KiB
Markdown

---
name: skill-email
description: Gmail API를 통한 이메일 읽기·쓰기·요약. 사용자가 "메일 확인해줘", "이메일 보내줘", "메일함 정리해줘" 등 이메일 관련 요청을 할 때 사용.
runtime:
kind: external_http
service_url_env: SKILL_EMAIL_URL
endpoints:
send: { method: POST, path: /send }
read: { method: GET, path: /messages }
process: { method: POST, path: /process }
---
# skill-email
Gmail 통합 스킬. 포트 8501.
## Trigger
- `email_read`: 수신함 확인, 최근 메일 읽기, 안 읽은 메일
- `email_send`: 메일 작성·전송·답장
- `email_summary`: 메일함 요약, 핵심만 정리
## Do
- Gmail OAuth 토큰 기반 인증
- Push 알림 지원 (Google Pub/Sub)
- rb8001에서 HTTP로 호출
## Do Not
- 토큰 없이 호출하지 않음
- 비인증 사용자에게 메일 내용 노출 금지
## API
### 이메일 전송
POST /send
| 파라미터 | 타입 | 필수 | 설명 |
|---------|------|------|------|
| to | string | 필수 | 수신자 이메일 |
| subject | string | 필수 | 제목 |
| body | string | 필수 | 본문 |
### 이메일 조회
GET /messages
| 파라미터 | 타입 | 필수 | 설명 |
|---------|------|------|------|
| user_id | UUID | 필수 | 사용자 ID (쿼리 파라미터) |
| limit | int | 선택 | 최대 결과 수 (기본 10) |
| query | string | 선택 | 검색 쿼리 |
| provider | string | 선택 | "gmail" (기본) |
### 이메일 요약
POST /process
## 환경변수
- `USER_ID`, `TOKEN_BASE`, `TOPIC` (Gmail Push)