Communitygithub.com

RB 개인 비서

Gmail 받은편지함 분류, 초안 작성, 관심사에 맞춘 뉴스레터 스캔, 여행 보고서 준비를 위한 개인 비서 스킬입니다. 예약된 Gmail 받은편지함 분류 절차(Obsidian "Email Action Items" Base 포함)를 관리합니다. 이메일 관리 또는 여행/개발 워크플로 자동화 시 사용하세요.

RB 개인 비서란 무엇인가요?

이 스킬은 Gmail 받은편지함 분류, 초안 작성, 뉴스레터 스캔, 여행 보고서 준비를 위해 설계된 개인 비서 스킬입니다. Claude 또는 Gemini 어시스턴트가 Rick의 Gmail 받은편지함과 전문 워크플로를 사전 예방적으로 관리할 수 있게 해줍니다. 받은편지함 분류 절차의 유일한 진실 공급원 역할을 하며, 'gws' CLI를 사용하여 단계별로 실행됩니다. Obsidian의 "Email Action Items" Base와 통합되어 추적된 작업을 관리하고, 노후 항목을 자동으로 정리하며, 분류 요약을 작성합니다. 주요 기능으로는 루틴 노이즈 보관, 관심사 기반 뉴스레터 하이라이트 추출, 우선순위 작업 플래그 지정, 여행 이메일 처리 등이 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/richardbowman/agent-skills/tree/HEAD/rb-personal-assistant

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

RB 개인 비서은(는) 무엇을 하나요?

포터블 활용

활성 하네스의 Gmail 커넥터, 보안-비밀 요청, 볼트/파일 도구, 스케줄러 대체 기능을 사용하세요. 필요한 커넥터를 사용할 수 없는 경우, 초안/보고서를 준비하고 누락된 기능을 식별하세요. 이메일 전송이나 외부 상태 변경에 대한 확인 규칙을 절대 우회하지 마세요. 기존 Claude Sessions 볼트 헤딩은 저장 스키마로 유지되며, 하네스 요구사항이 아닙니다.

이 스킬은 AI 어시스턴트(Claude 또는 Gemini)가 Rick의 Gmail 받은편지함과 전문 워크플로를 사전 예방적으로 관리할 수 있게 해줍니다. 받은편지함 분류 절차의 유일한 진실 공급원입니다. 예약된 cron 작업은 단순히 이 스킬을 호출하므로, cron 프롬프트에 중복하지 말고 전체 로직을 여기에 유지하세요.


Gmail 받은편지함 분류 — 전체 절차

받은편지함 분류를 요청받을 때마다(예약/무인 실행 포함) 이 절차를 실행하세요. gws CLI(PATH에 이미 있음)를 사용하세요. 단계를 순서대로 진행하세요.

주요 상수

  • 볼트 경로: 아래의 모든 볼트 경로는 볼트 기준 상대 경로입니다. 런타임이 볼트 루트를 제공합니다. 절대 하드코딩하지 마세요.
  • Jarvis 보관 레이블: Label_9220311120338883160 — 보관하려면, 동일한 modify 호출에서 이 레이블을 추가하고 INBOX를 제거하세요.
  • 받은편지함 검색 쿼리: gws gmail +triage --query 'is:unread label:INBOX' --max 60
  • 컨텍스트 노트: Jarvis Summaries/triage-context.md
  • 작업 항목 폴더: Jarvis Summaries/Action Items/
  • Action Items Base (이미 존재함 — 절대 다시 생성하지 마세요): Jarvis Summaries/Email Action Items.base
  • 요약 폴더: Jarvis Summaries/
  • 일일 노트: Daily/<YYYY-MM-DD>.md
  • gws 주의사항: 레이블 파라미터는 일반 문자열이어야 하며, 배열이 아닙니다. 예: addLabelIds: "Label_9220311120338883160", removeLabelIds: "INBOX".
  • zsh 주의사항: 이 환경의 셸은 zsh이며, bash가 아닙니다. for x in $VAR; do는 zsh에서 bash와 달리 따옴표 없는 변수를 단어 분할하지 않습니다(멀티 ID 루프를 그렇게 구성하면 전체 문자열이 $x로 한 번만 실행됩니다). 대신 zsh 배열을 사용하세요: IDS=(id1 id2 id3); for id in "${IDS[@]}"; do .... 또한, status는 zsh의 읽기 전용 내장 변수입니다 — 셸 변수 이름을 status로 절대 지정하지 마세요(st 등 사용). 그렇지 않으면 할당이 실패합니다.

STEP 0 — 컨텍스트 노트 읽기

컨텍스트 노트 파일을 읽으세요. 이 파일은 Rick이 이미 처리했거나 이번 실행에서 다르게 처리하고 싶은 사항에 대한 노트입니다. 아래의 모든 결정에 이를 반영하세요. 실행 후, 처리한 노트를 제거하세요(대기 노트 섹션 편집). 노트가 영구 규칙이 되어야 한다면, 컨텍스트 파일에 남기지 말고 references/preferences.md에 추가하세요.

STEP 0b — 이전 실행 및 Action Items Base에 대한 중복 제거

  1. ls "Jarvis Summaries/Triage-$(date +%Y-%m-%d)"*.md 2>/dev/null (볼트 루트 기준 상대 경로) — 파일이 있으면 읽고, Action Required 아래에 이미 있는 모든 제목/발신자와 Newsletter Highlights 아래에 이미 있는 모든 뉴스레터를 추출하세요.
  2. ls "Jarvis Summaries/Action Items/"를 실행하고, 플래그 지정하려는 각 이메일에 대해 기존 추적 노트가 있는지 Gmail ID로 확인하세요: grep -rl "gmail_id: <ID>" "Jarvis Summaries/Action Items/".

오늘 이미 보고되었거나 열린 작업 항목 노트가 있는 경우, 요약에 반복하지 말고 중복 노트를 생성하지 마세요. 대신 진정으로 새로운 정보(회신, 업데이트, 동일 주제의 다른 이메일)가 없는 한 기존 노트만 업데이트하세요(STEP 5b).

STEP 0c — Base의 대기 중인 작업 처리

Action Items Base에는 Rick이 Obsidian에서 체크하는 archive 체크박스 열이 있습니다. 받은편지함을 스캔하기 전에 대기 중인 작업을 확인하세요:

  1. grep -l "^archive: true" "Jarvis Summaries/Action Items/"*.md (들여쓰기 차이를 위해 캐럿 없이 archive: true도 일치).
  2. 각 일치 항목에 대해 노트의 프론트매터를 읽으세요. status가 이미 Done 또는 Dismissed이면 건너뛰세요(이전 실행에서 이미 처리됨 — 할 일 없음).
  3. 그렇지 않으면 기본 이메일을 보관하세요: gws gmail users messages modify --params '{"userId": "me", "id": "<gmail_id>", "addLabelIds": "Label_9220311120338883160", "removeLabelIds": "INBOX"}'.
  4. 성공하면 노트의 프론트매터를 업데이트하세요: status: Dismissed로 설정하고 last_run을 현재 시간으로 설정하세요. archive: true는 작업 기록으로 그대로 두세요 — 선택 해제하지 마세요.
  5. 실패 시(예: 메시지가 이미 삭제됨), status를 그대로 두고 무한 재시도하지 말고, 이번 실행의 분류 요약(STEP 7)에 Errors 줄 아래에 실패를 기록하여 Rick이 볼 수 있게 하세요.

이 단계는 체크박스에 대한 루프를 닫는 유일한 방법입니다. Obsidian에서 체크해도 실제 Gmail 메시지에는 다음 예약 분류 실행(6시간마다, 07:00-22:00)까지 아무런 효과가 없습니다.

STEP 0d — 오래된 추적 항목 정리

Action Items Base는 누군가가 적극적으로 노트를 닫지 않는 한 계속 커질 뿐입니다. STEP 0c는 Rick이 체크박스를 알아차리고 체크해야 하므로 확장성이 없습니다(2026-09-18 기준 274개 노트, 253개가 여전히 Open, 일부는 6주 전). 이 단계는 모든 분류 실행마다 실행되며, 항목이 더 이상 유효하지 않다고 추론해도 안전한 경우 자동으로 노트를 닫아 Base가 Rick의 주의가 실제로 필요한 항목의 신뢰할 수 있는 목록으로 유지되도록 합니다.

  1. Jarvis Summaries/Action Items/에서 모든 Open 노트의 gmail_id를 나열하세요.
  2. 현재 전체 받은편지함 ID 세트를 가져오세요(읽지 않음만 아님): gws gmail users messages list --params '{"userId": "me", "q": "in:inbox", "maxResults": 500}'. 응답에 nextPageToken이 포함되면 pageToken을 설정하여 더 이상 없을 때까지 반복하세요. 받은편지함 전체를 커버해야 합니다(일반적으로 500개 초과).
  3. 해당 gmail_id가 더 이상 받은편지함 세트에 없는 Open 노트를 닫으세요. 기본 이메일이 더 이상 받은편지함에 전혀 없다면, Rick(또는 다른 것)이 이 흐름 외부에서 이미 처리한 것입니다 — 노트는 고아입니다. status: Dismissed로 설정하고, archive: false로 두고(보관할 것이 없음), 노트 본문에 한 줄을 추가하세요: **Auto-closed <오늘 날짜>:** 기본 이메일이 더 이상 받은편지함에 없음 — 분류 흐름 외부에서 해결됨. 여전히 받은편지함에 있는 이메일의 노트는 건드리지 마세요. 여전히 사람의 확인이 필요합니다.
  4. 여전히 받은편지함에 있는 노트에 대한 카테고리별 노이즈 정리:
    • CI/CD: first_seen이 5일 이상 지났고 Rick이 In Progress/Done으로 업데이트한 적이 없으면, 오래된 것으로 간주합니다(CI 실패는 항상 다음 실행이나 리포지토리 직접 확인으로 대체됨 — 일주일 된 추적 노트는 정보 가치가 없음). 이메일을 보관하고(Jarvis 레이블) status: Dismissed로 설정하며, **Auto-closed <날짜>:** CI/CD 알림이 5일 이상 해결되지 않음, 오래된 것으로 간주 — 여전히 관련이 있으면 리포지토리 직접 확인하세요.라고 기록합니다.
    • Appointment: due_date(또는 due_date가 없으면 email_date)가 과거인 경우, 약속이 이미 발생했거나 지났습니다 — 이메일을 보관하고 **Auto-closed <날짜>:** 약속 날짜가 지남.과 함께 해제합니다.
    • Other로 분류된 배송/배달 알림(제목이 "package"/"delivery"/"shipped"/"on the way"와 일치): 10일 이상 지난 경우, 보관 및 해제하며 **Auto-closed <날짜>:** 배송 기간이 경과함. (더 나은 방법: STEP 5b에 따라 생성 시 이미 닫힌 것으로 분류하여 이 단계가 잡을 필요가 없도록 하세요 — 해당 노트 참조.)
    • Billing, Security, Compliance, Invoice, Benefits, Opportunity, Solar, SEO 및 Account는 여기서 그대로 두세요. 이러한 카테고리는 실제 금전, 마감일 또는 판단이 필요한 결정을 수반할 수 있으므로, 3단계의 받은편지함 존재 확인만 적용됩니다. 타이머로 오래된 항목을 정리하지 마세요.
  5. 분류 요약(STEP 7)에 항목별 목록이 아닌 개수를 보고하세요. 예: Housekeeping: 14개의 오래된 노트를 닫음 (9개는 받은편지함에 없음, 4개는 노후화된 CI/CD, 1개는 기한이 지난 약속). 전체 항목별 목록은 유용한 신호가 아닙니다. 개수는 정리 실행을 확인해줍니다.

STEP 1 — 읽지 않은 메시지 스캔

위의 받은편지함 검색 쿼리를 실행하세요. (참고: 쿼리 없이 일반 gws gmail +triage는 전체 사서함에서 is:unread를 기본값으로 하며 최대 20개로 제한됩니다. 이미 보관되었지만 여전히 읽지 않은 메일이 실제 받은편지함 항목을 밀어내므로 실제 받은편지함 백로그를 놓칩니다. 항상 명시적 label:INBOX 쿼리를 전달하여 실제 받은편지함을 스캔하세요.)

STEP 2 — 일상적인 노이즈 보관

보관(jarvis 레이블 + INBOX 제거): TestFlight / GitHub / Vercel 성공, Experian 프로모션, TaxSlayer, 알려진 계정에 대한 Google 보안 알림. 또한 뉴스레터 하이라이트를 요약한 후(STEP 4) 보관하세요 — 받은편지함에 남겨두지 마세요.

STEP 3 — 건물/콘도 공지

콘도미니엄 협회 / 건물 이메일을 Home 레이블로 이동하세요.

STEP 4 — 뉴스레터

Rick의 관심사(훈제 육류, 빵, 사이클링, 홈 오토메이션, Linux, SW Michigan 지역, 코스타리카/포르투갈 여행 — 전체 관심 지도는 references/preferences.md에 있음)와 일치하는 스니펫이 있는지 뉴스레터(WBEZ, Block Club, City Cast 등)를 스캔하세요. 일치하는 항목을 요약한 후, 뉴스레터를 보관하세요(jarvis 레이블). 오늘 이미 요약된 뉴스레터(STEP 0b)는 건너뛰고 조용히 보관만 하세요.

STEP 5 — 작업 필요 플래그 지정

우선 연락처의 인보이스, 프로덕션/빌링/보안 알림, 규정 준수/증명 마감일, 약속 준비, 유료 기회에 플래그를 지정하세요. 컨텍스트 노트에서 Rick이 이미 처리했다고 말한 것은 건너뛰세요. 오늘 이미 보고되었거나 열린 작업 항목 노트로 추적 중인 것(STEP 0b)은 진정으로 새로운 정보가 없는 한 건너뛰세요. 순수 배송/추적 알림("주문이 발송되었습니다")은 한 번 보고된 후 보관됩니다. STEP 5b에서 해당 추적 노트를 Open이 아닌 이미 닫힌 상태(status: Dismissed, archive: true)로 생성하여 배송 알림에 대한 후속 조치가 필요하지 않도록 하세요. 이 노트를 Open으로 두는 것은 정확히 STEP 0d가 이유 없이 정리해야 하는 종류의 노트입니다.

STEP 5b — Action Items Base 유지 관리

STEP 5에서 플래그 지정된 각 항목에 대해, Action Items 폴더에 노트로 추적되어 Email Action Items Base에 나타나도록 하세요. Base 파일은 이미 존재합니다. 다시 생성하지 마세요.

  • gmail_id로 중복 제거(STEP 0b). 해당 ID를 가진 노트가 있으면: last_run(및 last_seen)만 현재 실행으로 업데이트하세요. status를 덮어쓰지 말고(Rick이 수동으로 관리) 중복하지 마세요. 기존 노트의 상태가 Done 또는 Dismissed이면 닫힌 상태로 두세요. 다시 열거나 다시 플래그 지정하지 마세요.
  • 노트가 없으면 생성하세요. 파일 이름: <발신자> - <짧은 제목>.md (파일 이름에 유효하지 않은 문자 제거: / \ : 등). 프론트매터 스키마:
---
type: email-action
status: Open            # Open | In Progress | Done | Dismissed  (Rick이 Obsidian에서 편집)
archive: false          # Rick이 Base에서 이 상자를 체크하여 이메일을 보관하고 항목을 닫음 (STEP 0c)
priority: High          # High | Medium | Low
priority_rank: 1        # 1=높음, 2=중간, 3=낮음 (정렬 순서 결정)
category: Billing       # Billing | Invoice | Security | Compliance | CI/CD | Account | Benefits | Appointment | Opportunity | Solar | SEO | Other
sender: "Vercel"
subject: "..."
email_date: YYYY-MM-DD  # 이메일 수신 날짜
due_date:               # 선택 사항, 이메일에 기한이 명시된 경우만
gmail_id: <gws의 16진수 ID>
gmail_link: https://mail.google.com/mail/u/0/#all/<16진수 ID>
first_seen: YYYY-MM-DD  # 오늘
last_run: YYYY-MM-DD-HH-MM
---

본문: H1 # <발신자> — <제목>, 필요한 작업에 대한 1-2 문장 설명, 그리고 **[Gmail에서 열기](<gmail_link>)** 줄. gmail_link의 16진수 ID는 gws가 반환하는 동일한 16진수 메시지/스레드 ID입니다 — Gmail의 웹 영구 링크입니다.

  • 우선순위를 합리적으로 할당하세요: 높음 = 금전 위험/프로덕션 다운/엄격한 마감일(결제 실패, 연체, 보안 위반, 규정 준수 증명); 중간 = 곧 결정이나 회신 필요(인보이스, CI 실패, 계정 설정, 약속, 유료 기회); 낮음 = 정보 제공용이지만 실행 가능(명세서, SEO 감사, 마케팅 알림).

STEP 6 — 여행 보류

여행 이메일(Marriott, AC Hotels, UPS, 항공사)은 여행이 확실히 종료될 때까지 보관하지 마세요. 아래 여행 및 여행 보고서를 참조하세요.

STEP 7 — 분류 요약 작성

Jarvis Summaries/Triage-<YYYY-MM-DD-HH-MM>.md에 다음 섹션으로 작성하세요: Action Required, Newsletter Highlights, Archived, Housekeeping. Action Required 아래에 항목이 [[Jarvis Summaries/Email Action Items.base|Email Action Items]] Base에서도 추적되고 있음을 명시하세요. STEP 0c가 체크박스 작업을 처리한 경우, Archived via Base 줄과 실패한 항목에 대한 Errors 줄을 추가하세요. Housekeeping 아래에 STEP 0d의 정리 완료 개수를 보고하세요. 새로 발견된 항목이 없으면 "이전 실행 이후 새 항목 없음" 메모를 작성하고(STEP 0d 하우스키핑은 여전히 실행되고 보고됨), 중단하세요.

STEP 8 — 일일 노트에 링크

Daily/<YYYY-MM-DD>.md의 ## Claude Sessions 섹션 아래에 요약 파일에 대한 위키링크를 추가하세요(섹션이 없으면 생성).

예약/무인 실행: STEP 0-8을 완료하고 중단하세요. 요약을 다른 곳에 게시할 필요는 없습니다.


여행 및 여행 보고서

  • 식별: 호텔(Marriott, AC Hotels), 항공편 및 배송(UPS) 이메일을 추적하세요.
  • 워크플로: (향후) 캘린더를 확인하여 이를 단일 "여행 보고서"로 연관시킵니다.
  • 조치: 여행이 종료될 때까지 여행 영수증/정보를 보관하지 마세요.

응답 프로토콜

  • 우선 연락처: (예: HVAC 계약자) 인보이스 또는 문의에 대한 짧고 정중한 답변 초안을 작성합니다.
  • 안전: Rick의 명시적 확인 없이 결제를 승인하거나 금융 링크를 클릭하지 마세요.

Gmail 초안 작성(첨부 파일 유무에 관계없이)

gws CLI는 큰 페이로드를 명령줄 인수로 처리할 수 없습니다. 대신 아래의 Python 레시피를 사용하세요. 이 레시피는 gws 자격 증명을 직접 해독하고 Gmail API를 호출합니다.

텍스트 전용 초안:

import base64, json, subprocess
from email.mime.text import MIMEText

# 새 액세스 토큰 가져오기
from cryptography.hazmat.primitives.ciphers.aead import AESGCM
key = base64.b64decode(subprocess.run(['security', 'find-generic-password', '-s', 'gws-cli', '-w'], capture_output=True, text=True).stdout.

…

[번역을 위해 잘렸습니다]

첨부 파일이 있는 초안:

# 첨부 파일이 있는 초안
from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email import encoders

message = MIMEMultipart()
message['to'] = '[email protected]'
message['from'] = 'me'
message['subject'] = '첨부 파일 포함'

msg_text = MIMEText('본문 내용')
message.attach(msg_text)

with open('/path/to/file.pdf', 'rb') as f:
    attachment = MIMEBase('application', 'octet-stream')
    attachment.set_payload(f.read())
    encoders.encode_base64(attachment)
    attachment.add_header('Content-Disposition', 'attachment', filename='file.pdf')
    message.attach(attachment)

raw = base64.urlsafe_b64encode(message.as_bytes()).decode()
# Gmail API draft.create 호출

관련 스킬