세법 개정 → 고객사 맞춤 안내문 자동 체인

문제 시나리오

"국세청·기재부가 세법·시행령 개정을 수시로 발표한다. 담당 고객사 200곳 중 관련 개정만 골라 각 고객사에 맞춘 안내문을 메일·문서로 발송해야 한다. 지금은 담당자가 공지를 하나하나 읽고, 고객 DB에서 해당 업종을 수동으로 추리고, 워드 템플릿에 복붙하고, 메일로 첨부한다. 한 건당 30분, 공지가 몰리는 주에는 하루 3~4시간이 증발한다."

세무법인의 고부가가치 업무(자문·세무조사 대응)를 저부가가치 반복 업무가 잡아먹는 전형입니다. 정확도도 사람 피로도에 반비례합니다.

실습 목표

End-to-End 체인을 구축합니다. 매일 정해진 시각에 자동 실행되어:

국세청 공지 수집
개정 요점 요약 + 적용 대상 업종 분류
고객사 DB 대조 → 영향받는 고객사만 선별
고객사별 맞춤 안내문 DOCX 일괄 생성
담당자에게 텔레그램 알림 ("오늘 3개 고객사에 개정 안내 필요")

스킬 이름 세법-개정-체인.

2단계 분할

110분에 전체 체인을 한 번에 구축하기는 빡빡합니다. 다음 2단계로 나눕니다.

Stage 1 — 필수 (45분)

국세청 공지 URL 한 건 크롤링
개정 요점 요약 (3~5개 불릿)
고객사 1개 기준 맞춤 안내문 DOCX 1건 생성

여기까지만 해도 수작업 30분 → 자동 30초의 드라마틱한 단축을 체감할 수 있습니다.

Stage 2 — 도전 (55분)

다중 고객사 매칭 루프 (업종 태그 기반 분기)
텔레그램 봇 API 발송 (환경변수로 토큰 관리)
매칭 로그 생성 + 실패 재시도
스케줄 트리거 등록

입력 데이터

파일	설명
`notice_sources.yaml`	국세청·기재부 공지 페이지 URL 목록
`client_db.xlsx`	고객사 20곳 (사업자번호·업종·관심태그·담당자·담당자 텔레그램ID)
`notice_template.docx`	안내문 DOCX 템플릿 (회사명·담당자·개정요점·적용일 플레이스홀더)
`TELEGRAM_BOT_TOKEN`	Cowork 환경변수
`law_taxonomy.yaml`	법령 키워드 → 영향 업종 매핑 (소득세→개인, 법인세→법인, 부가세→대부분 등)

기대 산출물

output/notices/{고객사명}_개정안내_YYYYMMDD.docx — 영향받는 고객사만
output/matching_log.json — 어떤 개정이 어떤 업종·고객사에 매칭됐는지
담당자별 텔레그램 메시지 — "오늘 3개 고객사 안내문 생성 완료: ACME, BETA, GAMMA"
오류 리포트 (크롤링 실패·매칭 실패 목록)

핵심 스킬 호출 흐름

flowchart TD
  T["매일 07:30 스케줄 트리거"] --> C["국세청 공지 목록 크롤링
  web-reader"]
  C --> N{"신규 공지 있나?"}
  N -->|없음| Z["완료: 오늘 0건"]
  N -->|있음| S["각 공지 요점 추출"]
  S --> K["영향 업종 분류
  law_taxonomy.yaml"]
  K --> M["고객사 DB 대조"]
  M --> B{"업종 태그 매칭"}
  B -->|매칭됨| G["고객사별 안내문 DOCX 생성"]
  B -->|미매칭| X[매칭 로그에 기록 후 제외]
  G --> A[담당자별 결과 집계]
  A --> R[텔레그램 알림 발송]
  A --> L[매칭 로그 + 오류 리포트 저장]

선행 스킬

web-reader — URL 리스트를 받아 본문·제목·대표 이미지를 구조화해 반환. 국세청 공지 페이지 처리에 사용.

이 사례의 나머지 구성 요소(DOCX 생성, 텔레그램 발송, 업종 매칭 로직)는 Part 3 실습에서 직접 만드는 스킬들입니다. 기존 스킬 카탈로그에 있는 name-badge의 DOCX 치환 로직 패턴을 참고하면 빠르게 구축할 수 있습니다.

선행 개념

에이전트 루프 — 크롤링 실패 시 재시도, 매칭 실패 공지를 에러 큐로 돌리고 계속 진행
순차 + 분기 결합 — 공지 여러 건 × 고객사 여러 건의 2차원 매칭, 업종별 분기
Cowork 환경변수 — 텔레그램 토큰·고객 DB 경로 등을 코드·스킬에 직접 넣지 않고 환경으로 주입
출력 형식 약속 — 각 단계의 산출물(요약 JSON, 매칭 로그, 안내문 DOCX)이 다음 단계에 정확히 들어맞도록 스키마를 미리 고정

확장 과제

개정 영향도 스코어링 — 단순 매칭을 넘어 "우리 고객 중 몇 곳이, 얼마나 큰 변화를 겪는가"를 스코어로 표시
고객사 회신 추적 — 안내문 발송 후 고객 반응을 기록해 다음 개정 시 응대 우선순위에 반영
메일 자동 발송 분기 — 텔레그램 대신(또는 병행) 이메일로 고객사에 직접 발송
회계 프로그램 연동 — 고객사 DB를 더존·세무회계 프로그램에서 자동 동기화

변경 이력

v1 (2026-04-11): 최초 작성 — Claude@IGM Cohort 1 Track D (A+B 결합) 교재용