---

name: managing-mails description: IMAP 프로토콜로 메일함 목록 조회, 본문 읽기, UID 기반 삭제를 수행합니다. 메일 검색, RFC 2047 헤더 디코딩, 파일 기반 설정(MANAGING_MAIL_CONFIG_PATH 또는 --config)으로 메일을 관리해야 할 때 사용하세요. allowed-tools: Bash(python3:*), Read, Write

IMAP 메일 관리 스킬

IMAP 계정 정보를 파일로 로드하여 메일 목록 조회, 본문 읽기, 삭제를 처리합니다.

빠른 시작

1. 설정 파일 준비

mkdir -p ~/.config/managing-mails
cp mails.example.toml ~/.config/managing-mails/mails.toml
chmod 700 ~/.config/managing-mails
chmod 600 ~/.config/managing-mails/mails.toml
export MANAGING_MAIL_CONFIG_PATH=~/.config/managing-mails/mails.toml

2. 메일 목록 확인

python3 scripts/imap_read.py --mode list

3. 특정 UID 본문 읽기

python3 scripts/imap_read.py --mode read --uid 12345

4. 특정 UID 메일 삭제

python3 scripts/imap_read.py --mode delete --uid 12345

CLI 인터페이스

• --mode list|read|delete (필수)
• --account <name> (선택, 미지정 시 default_account)
• --mailbox <name> (선택, 미지정 시 계정 기본값)
• --since YYYY-MM-DD (선택, 미지정 시 계정별 default_since_days)
• --limit N (기본 20)
• --uid <uid> (mode=read|delete 필수)
• --query "<search expr>" (선택)
• --config <path> (선택, 지정 시 최우선)
• MANAGING_MAIL_CONFIG_PATH (--config 미지정 시 필수 환경변수)
• --include-html (mode=read에서 HTML 본문 포함)
• --no-expunge (mode=delete에서 즉시 영구삭제 없이 \Deleted 플래그만 설정)

출력 형식

• list: [{uid, date, from, subject, flags}]
• read: {uid, headers, text_body, parsed_body, html_body?, attachments[]}
• delete: {uid, deleted_flag_set, expunged, remaining_matches[]}

parsed_body는 사람이 읽기 쉬운 본문 파싱 결과를 제공합니다.

• source: 파싱 원본(text/plain 또는 text/html)
• summary: 주요 본문 요약(줄바꿈 유지)
• incident_fields: 장애 문서에서 추출한 핵심 필드(작성자/서비스명/장애 원인/티켓 등)
• urls: 본문에서 추출한 링크 목록

에러 코드

• CONFIG_NOT_FOUND
• CONFIG_PARSE_ERROR
• CONFIG_SCHEMA_ERROR
• CONFIG_PERMISSION_DENIED
• ACCOUNT_NOT_FOUND
• IMAP_CONNECT_ERROR
• AUTH_FAILED
• MAILBOX_NOT_FOUND
• MESSAGE_NOT_FOUND
• DELETE_FAILED

세부 동작은 아래 참조 문서를 따릅니다.

• 제공자 특이사항: references/provider-quirks.md
• 검색 레시피: references/search-recipes.md