outlook-client-maillisted
Install: claude install-skill procpalee/kr-accounting-skills
# outlook-client-mail - 거래처별 메일 자동 분류 · 저장 · 메일 히스토리
도구 폴더: 이 스킬의 `scripts/`(실행은 항상 `python -X utf8 scripts/<도구>.py …`).
## 역할 나누기
| 층 | 누가 · 언제 | 하는 일 | 방식 |
|---|---|---|---|
| ① 분류 | Outlook VBA `ClientSort` - 메일이 들어오는 즉시 | 받은 · 보낸 · 감시 폴더의 메일을 거래처 Outlook 폴더로(받음 이동 · 보냄 사본). 못 정하면 그대로 - 사용자가 끌어다 넣거나 [거래처로 분류] | 결정론 |
| ② 저장 | VBA → `mail_sync.py` - 거래처 Outlook 폴더에 메일이 들어오는 즉시 | 원본 `.msg` → `<거래처>\메일\YYMM\`, 색인 `_mail\mail_index.jsonl`, 받은 첨부 → `<거래처>\첨부\` | 결정론 |
| ③ 연결 | VBA → `mail_sync_all.py` - Outlook 을 켤 때 · [폴더 연결 맞추기] | 거래처 폴더 ↔ Outlook 폴더 연결(`mail.json` 의 `outlook.entry_id`), 새 Outlook 폴더 만들기, 거래처 목록(`Client_Map.tsv`) | 결정론 |
| ④ 정리 | 이 스킬(Claude) - 요청할 때 | 메일 히스토리 갱신, 찾기 · 열기, 역할 모르는 주소 확인 | AI |
Claude 는 ①~③의 결과를 읽기만 한다. 분류 규칙을 바꾸고 싶으면 VBA 가 아니라 `mail.json`(주소 · 도메인 · 키워드)과 `mail_sort.json` 을 고친다.
## 폴더
```
<거래처 루트>\
_메일분류\ mail_sort.json(사용자 설정) · Client_Map.tsv(생성물, 직접 고치지 않음) · Client_Map_추가.tsv(VBA 가 기억한 주소)
Client_Sort_log.tsv(분류 기록, UTF-16) · last_run.txt · last_sync.txt · vba\ · 사용법.html
[그룹\]<거래처>\ 메일\YYMM\*.msg · 첨부\<메일 단위>\ · 메일 히스토리.md · _mail\(mail.json · mail_index.jsonl · mail_state.json, 숨김)
Outlook 기본 사서함 최상위\<outlook_root(기본 '거래처')>\[그룹\]<거래처>
```
루트 위치는 `%APPDATA%\outlook-client-mail\config.json`(setup.py 가 씀) 또는 환경변수 `OCM_ROOT`.
## 도구
| 도구 | 하는 일 |
|---|---|
| `setup.py --root <폴더> [--outlook-root 거래처] [--groups "a,b"]` | 처음 한 번 - 설정 · VBA 파일 · 사용법 · 자동 시작 스크립트 만들기. 스킬 업데이트 뒤에는 인자 없이 다시(VBA 다시 만들기) |
| `mail_sync_all.