Skip to main content
  1. Claude Cowork 한국어 문서
  2. /
  3. 쿡북 홈
  4. /
  5. 주간 보고서 자동화

주간 보고서 자동화

목표 — 매주 금요일 오후 5시에 자동으로 시작해 KPI 대시보드 + 이슈 요약 + 다음 주 액션까지 담긴 3페이지 DOCX를 팀 공유 폴더에 저장합니다.

flowchart TD
    subgraph Sources["데이터 소스"]
        S1["KPI CSV"]
        S2["Slack #ops"]
        S3["Notion/Asana"]
    end
    A["status-reporter
주간 리포트 골격"] --> B["data-explorer
KPI 추출"]
    B --> C["xlsx-creator
대시보드"]
    C --> D["docx-generator
3페이지 DOCX"]
    D --> E["ai-slop-reviewer
문장 다듬기"]
    Sources --> A

    style Sources fill:#dceee9,stroke:#2a8a8c,color:#09110f
    style E fill:#e6f0ef,stroke:#144a46,color:#09110f

대상 독자

운영팀·기획팀의 정기 보고를 담당하는 실무자.

사전 준비

  • 플러그인: moai-operations, moai-data, moai-office, moai-core:ai-slop-reviewer
  • MCP 커넥터: Slack(이슈 수집) + Notion/Asana(할 일) — 커넥터·MCP 참고
  • (선택) GA4·광고 채널 데이터
  • schedule 스킬 — 스케줄링

스킬 체인

status-reporter → data-explorer → xlsx-creator → docx-generator → ai-slop-reviewer
  • status-reporter — 주간 리포트 골격, OKR 진행률
  • data-explorer — 로우 데이터(CSV·Slack·Notion)에서 KPI 추출
  • xlsx-creator — KPI 대시보드 시트
  • docx-generator — 최종 3페이지 보고서
  • ai-slop-reviewer — 임원이 바로 읽을 수 있게 문장 다듬기

사용 방식 — 한 줄 요청 (패턴 4: 스케줄 자동화)

핵심: 사용자가 “수동 실행 → 스케줄 등록” 2 단계로 분리하지 않습니다. 한 줄로 “매주 N요일 X시 주간보고 자동화” 요청 → 시스템이 인터뷰 후 1회 시범 실행 + 스케줄 등록까지 자동. (4가지 사용 패턴 - 패턴 4)

사용자 입력

claude — cowork
> 매주 금요일 오후 5시에 우리 팀 주간보고 자동 발송해줘

시스템 인터뷰 (AskUserQuestion)

  1. 데이터 소스: KPI CSV 폴더 / Slack 채널 / Notion DB / Linear / Asana / 자유 텍스트
  2. 수신자: 임원 (격식체) / 팀 (구어체) / 둘 다
  3. 발송 채널: Slack 채널 / 이메일 / 노션 페이지 / 파일만
  4. 포함 섹션: 이번 주 / 다음 주 / 이슈·블로커 / 도움 요청 (4분할 표준)
  5. 검증 단계: 첫 2주 검토 후 자동 발송 (기본) / 매번 검토 후 발송 / 즉시 자동

자동 체인 (매주 자동 반복)

flowchart TD
    Cron["매주 금 17:00"] --> Fetch["MCP 자동 fetch
Slack·Notion·Linear"]
    Fetch --> SR["status-reporter
4분할 템플릿"]
    SR --> DE["data-explorer
KPI CSV 분석"]
    DE --> XL["xlsx-creator
차트 자동"]
    XL --> DG["docx-generator
본문"]
    DG --> AI["ai-slop-reviewer
임원체·팀체 2 버전"]
    AI --> Send["Slack 발송
+ 90_Output/weekly/"]
    style Cron fill:#fbf0dc,stroke:#c47b2a

산출물

  • 매주 금 17:00 자동 발송:
    • 90_Output/weekly/주간보고-YYYYMMDD-임원.docx (격식체)
    • 90_Output/weekly/주간보고-YYYYMMDD-팀.docx (구어체)
    • Slack #weekly 채널 알림 (썸네일 + KPI 3개)

검증 흐름 (자동)

  • W1·W2: 사용자에게 사전 검토 요청 (Slack DM)
  • W3+: 자동 발송 (이상 감지 시 알림만)
  • 데이터 소스 누락: “지난 주 데이터 인용” 자동 fallback

자주 겪는 이슈

Warning
이슈 1 — 데이터가 없는 주에 에러. 연휴·서버 이슈로 CSV가 비면 data-explorer가 멈춥니다. 프롬프트에 “CSV가 비면 지난 주 데이터 인용” 분기 지시를 추가하세요.
Warning
이슈 2 — Slack 장기 검색 토큰 부족. MCP 기본 검색은 14일. 그 이상은 slack_search_public 사용권을 확인하세요.
Note
이슈 3 — 숫자 형식이 제각각. 매출·유저수 등 단위를 xlsx-creator 프롬프트에 “원 → 백만원, 명 → 천명"같이 고정하세요.

응용 변형

  • 월간 보고서 — 같은 파이프라인을 “4주치 CSV” 입력으로 돌려 월간판 생성.
  • 대시보드 HTML — data-visualizer로 사내 공유용 단일 HTML 대시보드 추가 발행 → 이메일 링크.
  • 마크다운 → HTML 변환 (v2.2.0 신규) — moai-content:html-report 스킬로 마크다운 보고서를 단일 파일 HTML로 변환. 외부 의존성 0, 12-25KB 초경량 산출물.

마크다운 보고서 → HTML 변환 (v2.2.0)

claude — cowork
> 이번 주 주간 현황 보고서 HTML로 변환해줘.
  - 모드: status
  - 입력: /weekly/주간보고-20260510.md

체인: (기존 보고서 생성) → html-report mode=status
출력: /weekly/주간보고-20260510.html

html-report 스킬 특징:

  • 6개 보고서 모드: status, incident, plan, explainer, financial, pr
  • 인라인 SVG + vanilla JS: 외부 의존성 0, 12-25KB 초경량
  • 한글 폰트 6종: Pretendard(기본), Noto Serif KR, Noto Sans KR, 조선일보명조, KoPubWorld 명조, JetBrains Mono
  • 인쇄 친화: @media print 자동 적용, 페이지 나누기 최적화

권장 체인:

{텍스트 생성 스킬} → ai-slop-reviewer → humanize-korean → html-report mode=<X>

관련 링크:

Sources