스킬.잇다
Part 3 · Ch 4 패턴 약 7분 분량 v1 · 2026-04-11

폴더 감시 자동화 패턴 — 드롭만 하면 처리된다

inbox 폴더에 파일이 떨어지면 자동으로 감지·처리하는 Cowork 폴더 감시 패턴의 구조와 실무 주의사항

한 줄 요약

폴더 감시 패턴은 "사람이 스킬을 실행"에서 "환경이 파일을 감지해 스킬을 실행" 으로 자동화 무게중심을 옮깁니다. inbox → 감지 → 분기 → 처리 → archive 다섯 단계입니다.

왜 이 패턴인가

기존 방식:

  1. 사람이 파일을 저장
  2. Claude 를 열고
  3. "이거 처리해줘" 라고 입력
  4. 결과 확인

이 중 (2)(3)이 반복 업무입니다. 폴더 감시는 (2)(3)을 생략합니다. 파일을 inbox 폴더에 드롭하면 몇 초 안에 결과가 archive 폴더에 나타납니다.

같은 Skill 의 가치가 바뀝니다: "편리한 기능" → "매일 자동으로 일하는 동료".

5단계 기본 구조

flowchart TD
  I["inbox/ 폴더"] --> W["감지: 새 파일 이벤트"]
  W --> F{"파일 포맷"}
  F -->|PDF| P["PDF 스킬"]
  F -->|eml| E["이메일 스킬"]
  F -->|xlsx| X["엑셀 스킬"]
  F -->|기타| K["fallback 처리"]
  P --> M["archive/카테고리/YYYY-MM-DD/"]
  E --> M
  X --> M
  K --> M
  M --> L["processed.log 기록"]

1단계 — inbox 폴더

파일이 들어오는 "입구". Cowork 공유 폴더의 하위 디렉토리로 두는 것이 일반적.

cowork/team-x/
├── inbox/          ← 감시 대상
├── archive/        ← 처리 완료
├── failed/         ← 처리 실패
└── processed.log   ← 누가 언제 무엇을 처리

2단계 — 감지 이벤트

Cowork 는 inbox/ 하위에 새 파일이 생기거나 수정될 때 이벤트를 발생시킵니다. 이 이벤트가 연결된 스킬을 자동 호출합니다.

주의: 대용량 파일은 복사 중에 여러 이벤트가 발생할 수 있습니다. 파일 크기가 일정 시간 안정화된 뒤 처리하도록 디바운스(debounce) 설정을 해야 중복 처리가 방지됩니다.

3단계 — 분기

파일 확장자 / MIME 타입 / 파일명 패턴으로 어느 서브 스킬에 보낼지 결정합니다.

# watch.yaml
route:
  "*.pdf": pdf-digest
  "*.eml": email-triage
  "*.xlsx": excel-classify
  "*.txt": text-triage
  "*": fallback-log  # 어느 것에도 해당하지 않으면

4단계 — 처리

각 서브 스킬이 파일을 받아 자기 방식대로 처리하고, 결과를 표준화된 위치에 저장합니다. 표준화가 중요합니다. 스킬마다 다른 위치에 저장하면 나중에 2차 집계가 불가능합니다.

5단계 — 아카이브 + 로그

처리 완료된 파일은 inbox 에서 제거하고 archive 로 이동. 원본을 남겨야 할 때는 복사만. 로그에는 "언제 · 누가 · 어떤 파일 · 어떤 스킬 · 성공/실패"를 기록.

2026-04-11T09:12:05  user=auto  file=inquiry_001.eml  skill=email-triage  status=ok  category=납부
2026-04-11T09:12:07  user=auto  file=report_q1.pdf    skill=pdf-digest    status=ok
2026-04-11T09:13:15  user=auto  file=broken.xlsx      skill=excel-classify status=fail  err=missing-columns

실무 주의사항

1. 파일 복사 중 처리 방지

큰 파일을 드래그하면 복사가 0바이트부터 시작합니다. 이 시점에 이벤트가 발생하면 빈 파일을 처리할 수 있습니다.

해결: inbox/.tmp/ 같은 임시 폴더로 먼저 복사하고 완료되면 inbox/ 로 이동. 또는 파일 크기가 N초 안정화된 뒤 처리.

2. 실패 파일 격리

처리 실패한 파일을 inbox 에 그대로 두면 다음 트리거에서 또 실패합니다. 무한 루프 가능.

해결: 실패하면 즉시 failed/ 폴더로 이동 + 담당자 알림.

3. 동시 처리 제한

10건이 동시에 드롭되면 10개 스킬이 동시 실행될 수 있습니다. 외부 API 를 쓰는 스킬이면 rate limit 에 걸립니다.

해결: watch.yaml 에 max_concurrent: 3 설정.

4. 감시 폴더에 결과 저장 금지

감시 대상 폴더 안에 결과를 쓰면 결과 파일이 또 트리거를 발생시켜 무한 루프. archive 는 반드시 감시 대상 밖에 두세요.

5. 권한 분리

inbox 에 쓰기 권한이 있는 사람 ≠ archive 에 접근 가능한 사람 으로 설정 가능. 예를 들어 영업부는 inbox 에 파일을 넣을 수 있지만 archive 는 기획팀만 조회 같은 거버넌스.

적용 가능한 업무

업무적합도이유
민원·문의 인박스 분류 (Track E)⭐⭐⭐⭐⭐정형 파일 + 정형 분류
행사 참가자 명단 처리 (Track A 확장)⭐⭐⭐⭐엑셀 → 자동 패키지 생성
계약서 자동 요약⭐⭐⭐⭐PDF → 요약 + 리스크 표시
세법 공문 처리 (Track D 일부)⭐⭐⭐⭐HWPX → 핵심 조항 추출
이메일 자동 응답⭐⭐⭐오탐 시 영향 큼. 초안까지만 자동
긴급 의료 문서⭐자동화 적합 아님. 사람 개입 필수

자주 묻는 질문

Q. 폴더 감시 없이 정기 실행(매 5분마다 스캔)으로 대체할 수 있나요?

A. 네, 가능합니다. 이벤트 기반이 아닌 폴링 방식. 5분 지연이 허용되고 파일 복사 중 문제가 없는 환경이면 더 단순합니다. 실제로 많은 업무에서 폴링이 충분합니다.

Q. inbox 에 직접 파일을 드래그하는 게 번거로워요.

A. Cowork 커넥터를 쓰면 이메일 첨부, Drive 공유 폴더, Slack 채널 업로드도 inbox 이벤트로 연결할 수 있습니다. "받은 메일의 첨부가 자동으로 inbox 에 들어간다" 같은 플로우가 가능.

Q. 실수로 잘못된 파일을 드롭했어요.

A. inbox 에서 30초 이내에 꺼내면 감시 이벤트가 발동하기 전에 취소 가능. 이미 처리됐다면 archive 에서 복구 + processed.log 에서 해당 기록을 수동 무효화 표시. 사람 개입이 필요한 사고이므로 undo 스킬을 별도로 만들어 두는 것을 추천합니다.

Q. 어떤 플랜에서 쓸 수 있나요?

A. Pro 이상 플랜에서 Cowork 자동 실행이 가능합니다. 팀 공유 Skill 과 커넥터를 함께 쓰려면 Team 이상이 필요합니다.

다음 읽을거리

변경 이력

  • v1 (2026-04-11): 최초 작성 — Claude@IGM Cohort 1 교재용