---
title: "주간 보고서 자동화"
weight: 50
description: "매주 금요일 자동으로 KPI 대시보드 + 이슈 요약 + 다음 주 액션을 담은 3페이지 DOCX 생성."
geekdocBreadcrumb: true
tags: [cookbook, operations]
---
> **목표** — 매주 금요일 오후 5시에 자동으로 시작해 **KPI 대시보드 + 이슈 요약 + 다음 주 액션**까지 담긴 3페이지 DOCX를 팀 공유 폴더에 저장합니다.

```mermaid
flowchart TD
    subgraph Sources["데이터 소스"]
        S1["KPI CSV"]
        S2["Slack #ops"]
        S3["Notion/Asana"]
    end
    A["status-reporter<br/>주간 리포트 골격"] --> B["data-explorer<br/>KPI 추출"]
    B --> C["xlsx-creator<br/>대시보드"]
    C --> D["docx-generator<br/>3페이지 DOCX"]
    D --> E["ai-slop-reviewer<br/>문장 다듬기"]
    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](../../cowork/connectors-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](../../cowork/patterns/#패턴-4--스케줄-자동화-scheduled-automation))

### 사용자 입력

{{< terminal title="claude — cowork" >}}
> 매주 금요일 오후 5시에 우리 팀 주간보고 자동 발송해줘
{{< /terminal >}}

### 시스템 인터뷰 (AskUserQuestion)

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

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

```mermaid
flowchart TD
    Cron["매주 금 17:00"] --> Fetch["MCP 자동 fetch<br/>Slack·Notion·Linear"]
    Fetch --> SR["status-reporter<br/>4분할 템플릿"]
    SR --> DE["data-explorer<br/>KPI CSV 분석"]
    DE --> XL["xlsx-creator<br/>차트 자동"]
    XL --> DG["docx-generator<br/>본문"]
    DG --> AI["ai-slop-reviewer<br/>임원체·팀체 2 버전"]
    AI --> Send["Slack 발송<br/>+ 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

## 자주 겪는 이슈

{{< hint type="warning" >}}
**이슈 1 — 데이터가 없는 주에 에러.**
연휴·서버 이슈로 CSV가 비면 `data-explorer`가 멈춥니다. 프롬프트에 "CSV가 비면 지난 주 데이터 인용" 분기 지시를 추가하세요.
{{< /hint >}}

{{< hint type="warning" >}}
**이슈 2 — Slack 장기 검색 토큰 부족.**
MCP 기본 검색은 14일. 그 이상은 `slack_search_public` 사용권을 확인하세요.
{{< /hint >}}

{{< hint type="note" >}}
**이슈 3 — 숫자 형식이 제각각.**
매출·유저수 등 단위를 `xlsx-creator` 프롬프트에 "원 → 백만원, 명 → 천명"같이 고정하세요.
{{< /hint >}}

## 응용 변형

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

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

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

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

**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>
```

**관련 링크**:
- [SKILL.md](https://github.com/modu-ai/cowork-plugins/blob/v2.2.0/moai-content/skills/html-report/SKILL.md)
- [Thariq Shihipar "The Unreasonable Effectiveness of HTML"](https://thariq.substack.com/p/the-unreasonable-effectiveness-of)

---

### Sources
- [modu-ai/cowork-plugins › moai-operations](https://github.com/modu-ai/cowork-plugins)
- [docs.claude.com — Scheduled Tasks](https://docs.claude.com)
