mcpbeat

Weekly Report

modu-ai/weekly-report

| 한국 팀의 주간 비즈니스 리뷰(WBR) 보고서 자동 생성 스킬입니다. 일일 노트·완료 태스크·KPI 데이터를 입력받아 임원/팀 두 버전(격식체/구어체)으로 작성합니다. Notion·Linear·Asana·Slack MCP가 가용하면 자동 데이터 fetch, 없어도 자유 텍스트 입력 fallback.

4k tokens
context cost
the whole folder, loaded on every use
2
files
instructions only
0
copies elsewhere
how many repositories repackaged it
265
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/modu-ai/cowork-plugins --skill weekly-report

The instruction itself

8 sections, as written by the author

Weekly Report — 한국 팀 주간보고(WBR) 자동 생성

> moai-pm | 한국 주간보고 문화 + 글로벌 베스트 프랙티스

개요

월요 오전 WBR(Weekly Business Review) 또는 금요 마무리 보고용 주간 리포트를 자동 작성합니다. 한국 직장 문화에서 정착된 6섹션 표준(KPI / Done / In Progress / Plan / Risks / Decisions)을 기본으로 하며, 임원용 1pager와 팀 내부 상세 두 버전을 동시 생성합니다.

트리거 키워드

주간보고 WBR 위클리 리포트 주간 회의자료 주간 업무보고 weekly report 임원 주간보고 팀 주간보고

실전 주간보고·회의·회고 패턴 (한국 팀)

주간보고는 단독 산출물이 아니라 WBR 미팅 + 회고 + 다음 주 우선순위 결정의 종합 보조 자료입니다. 한국 조직 문화에 최적화된 노하우입니다.

6개 핵심 패턴

① 한국 WBR 표준 6섹션 (이미 적용 + vault 검증)

| # | 섹션 | 한국 실무 함정 |

|---|---|---|

| 1 | 이번 주 핵심 (KPI) | 목표 대비 % 표시 필수 — 절대값만 보고 ❌ |

| 2 | 완료 (Done) | "노력함" X, 임팩트 정량 (-30% 비용, +15% 유저) |

| 3 | 진행 중 (In Progress) | 진행률 % + 다음 주 완료 예정 여부 명시 |

| 4 | 차주 계획 (Plan) | P0/P1/P2 우선순위 — 시간 단위 추정 금지 |

| 5 | 이슈·리스크 | 단순 나열 X — 영향도 + 대응안 동반 |

| 6 | 의사결정 요청 | 옵션 2-3개 제시 — 단순 질문 X |

② 회고 프레임워크 KPT·4Ls (한국 기획자 검증)

주간보고에 회고 섹션 통합 권장. 2종 프레임워크 중 선택:

KPT (가장 흔함):

  • Keep: 지속할 것
  • Problem: 개선 필요한 것
  • Try: 새로 시도할 것

4Ls (감정 포함):

  • Likes: 좋았던 점·성과
  • Learned: 배운 점 (성공·실패에서)
  • Lacked: 부족했던 점
  • Longed for: 바랐던 점

> 회고는 머릿속 추상을 '읽을 수 있는 언어' 로 표현 → 기획자의 필수 역량 "소통 능력" 훈련.

③ 의사결정 요청 표준 포맷 (한국 임원 보고)

## 의사결정 요청 — [주제]

### 배경
[1~2줄 맥락]

### 옵션
| 옵션 | 장점 | 단점 | 비용·일정 |
|---|---|---|---|
| A (권장) | ... | ... | ... |
| B | ... | ... | ... |
| C | ... | ... | ... |

### 권장 사유
[1~2줄 핵심]

### 결정 마감일
[명시]

"고민됩니다, 어떻게 할까요"식 질문 X — 임원은 옵션 + 권장을 함께 보길 원함.

④ 스크럼 주기 결정 매트릭스 (주간보고 입력)

| 프로젝트 단계 | 권장 스크럼 주기 | 주간보고 입력 |

|---|---|---|

| 빠른 실행·MVP | 데일리 스크럼 | 매일 노트 → 주간 요약 |

| 일반 개발·기획 | 주 2-3회 | 스크럼 메모 직접 통합 |

| 검토·승인 중심 | 주 1회 | 주 1회 + 비동기 업데이트 |

| 장기 R&D | 격주 | 격주 + 마일스톤 보고 |

스크럼 = 주간보고의 raw input. 데일리 스크럼 메모를 미리 정리해두면 주간보고는 30분 안에 작성 가능.

⑤ 톤 자동 매핑 (한국 조직 위계 반영)

| 보고 대상 | 톤 | 어조 예시 |

|---|---|---|

| C-Level (CEO/CFO/COO) | 격식체 + 결론 우선 | "-합니다", "-로 판단됩니다" |

| 부서장·팀장 | 격식체 | "-합니다", 정중한 보고체 |

| 팀 내부 (Slack) | 해요체 | "-했어요", "-할 예정이에요" |

| 외부 클라이언트 | 격식체 + 존경어 | "-하셨습니다", "-해 주시면 감사하겠습니다" |

| 회고 (팀 내) | 자기 성찰체 | "-했더라고요", "-를 배웠어요" |

혼합 보고 시 두 버전 동시 출력 — 1pager (임원) + 풀 버전 (팀).

⑥ 회의 진행법 3종 통합 (주간보고 산출물의 활용)

| 회의 | 주간보고 활용 |

|---|---|

| 기획 리뷰 | 진행 중 섹션 + 의사결정 요청 항목 — 큰 골자 vs 실행안 분기 |

| 스크럼 | KPI·진행률 섹션 — 현재 이슈·블로커 빠른 공유 |

| 회고 | KPT·4Ls 섹션 — 이번 주 회고 + 다음 주 Try |

기획 리뷰 핵심 4단:

  • 컨셉안 vs 실행안 구분 — 누구에게 무엇을 리뷰할지 사전 결정
  • 문서 미리 첨부 + 피드백 받고 싶은 부분 명시
  • 즉시 반박 회피 — "충분히 고려한 뒤 추가 검토하겠습니다" 식으로 감정 충돌 방지
  • 회의록 당일 공유 — 청자 기억 휘발 방지

한국 주간보고 안티 패턴

  • 일주일 행동 일기처럼 시간순 나열 (임팩트 X)
  • KPI 목표값 없이 절대값만 ("MAU 12,000" — 목표 대비 모름)
  • 우선순위 없이 "다음 주 할 일 10개" 나열
  • 의사결정 요청을 단순 질문으로 ("어떻게 하면 될까요?")
  • 이슈·리스크 섹션 비워두기 (위장 평화 신호)
  • 회고·인사이트 없이 데이터만

노션·Linear·Asana 입력 시 데이터 자동 동기화 팁

  • Notion: 데이터베이스 view를 Done this week / In progress / Planned 3 필터로 분리
  • Linear: Cycle 단위로 이슈 자동 그룹화 → MCP 가용 시 직접 fetch
  • Asana: Section별 정렬 + Status 필드로 진행률 계산

가용 도구 없을 때는 자유 텍스트 메모 + LLM 정리로 fallback.

> 💡 한국 주간보고 1년 효과 누적: (1) 본인 업무 시각화 (2) 임원 의사결정 속도 향상 (3) 회고 습관화로 소통 능력 향상. 잘 쓴 주간보고 1년이면 발화·문서 작성 능력 모두 변화.

워크플로우

1단계: 데이터 소스 자동 감지 (3-tier fallback)

| Tier | 소스 | 동작 |

|---|---|---|

| 1 | Notion·Linear·Asana MCP 가용 | 데이터베이스/이슈 자동 fetch |

| 2 | CSV/JSON 업로드 | 외부 도구 export 파싱 |

| 3 | 자유 텍스트 메모 | 사용자가 정리한 내용 그대로 활용 |

MCP 가용 시 자동 우선 활용. 사용자가 명시적으로 텍스트 입력 시 그대로 처리.

2단계: 6섹션 본문 생성 (한국 WBR 표준)

| # | 섹션 | 내용 |

|---|---|---|

| 1 | 이번 주 핵심 (KPI) | 사전 정의된 지표 달성치·목표 대비 % |

| 2 | 완료 (Done) | PR·티켓·기능 단위, 임팩트 정량 |

| 3 | 진행 중 (In Progress) | 다음 주 완료 예정 항목·진행률 |

| 4 | 차주 계획 (Plan) | priority labels (P0/P1/P2) — 시간 단위 추정 금지 |

| 5 | 이슈·리스크 | 외부 의존성, 일정 압박, 기술 부채 |

| 6 | 의사결정 요청 | 임원/PM 결정 필요 항목 + 옵션 |

3단계: 톤 자동 적용

사용자가 톤을 지정하지 않으면 대상별 자동 매핑:

  • 임원 보고: 격식체 ("-합니다", "-로 판단됩니다")
  • 팀 내부 (Slack 등): 해요체 ("-했어요", "-할 예정이에요")
  • 혼합: 두 버전 동시 출력

4단계: 임원 1pager 별도 생성 (선택)

≤ 250 단어로 압축:

  • KPI 헤드라인 1줄
  • 완료 핵심 3개 (각 1줄, 정량)
  • 리스크 1개
  • 의사결정 요청 1-2개

5단계: 후처리 가이드

  • moai-core:ai-slop-reviewer: AI 패턴·격식체 톤 검수 (텍스트 산출물 필수)
  • moai-content:humanize-korean: 한국어 자연스러움 보정 (ai-slop-reviewer 다음 단계)
  • moai-bi:executive-summary: 1pager를 더 압축된 C-level 보고로 변환
  • moai-office:pptx-designer: 슬라이드 발표 자료로 출력

출력 형식

# 주간보고 — [팀명] (2026년 W18, 5/1~5/7)

## 1. 이번 주 핵심 (KPI)
- MAU: 12,450 (목표 12,000 대비 +3.8%)
- 신규 가입: 320 (목표 300 대비 +6.7%)

## 2. 완료 (Done)
- [Feature] 결제 페이지 v2 — PR #234 머지, 결제 성공률 +2.1pp
- [Bug] 로그인 500 에러 — 영향 사용자 ~30명, 핫픽스 배포

## 3. 진행 중 (In Progress)
- 알림 시스템 리팩토링 — 70% 완료, 차주 머지 목표

## 4. 차주 계획 (Plan)
- [P0] 결제 모듈 보안 감사 대응
- [P1] 마케팅 캠페인 페이지 제작
- [P2] 백엔드 의존성 업데이트

## 5. 이슈·리스크
- 외부 SMS API 응답 지연 → backup 채널 검토 필요
- 디자인팀 리소스 부족으로 차주 일부 작업 후순위

## 6. 의사결정 요청
- 보안 감사 대응 인력 추가 (옵션 A: 외주, B: 내부 재배치)

임원 1pager (≤ 250 단어):

# Executive Brief — W18

**KPI**: MAU 12.4K (+3.8% vs 목표), 가입 320 (+6.7%)
**완료**: 결제 v2 머지(전환 +2.1pp) / 로그인 500 핫픽스 / 알림 70%
**리스크**: SMS API 지연 — 백업 채널 검토 중
**결정 요청**: 보안 감사 대응 — 외주 vs 내부 재배치

사용 예시

예시 1 — Notion MCP 자동 fetch

사용자: "이번 주 주간보고 만들어줘. 우리 팀 Notion DB 'Weekly Tasks' 참고."
→ Notion MCP로 W18 완료 태스크·진행 중 자동 수집
→ 6섹션 격식체 보고 + 임원 1pager 두 버전 출력

예시 2 — 자유 텍스트 fallback (해요체)

사용자: "이번 주 한 일 정리해줘. 결제 v2 머지했고, 로그인 버그 잡았고, 알림 리팩토링 70% 됐어."
→ 자유 텍스트 파싱 후 해요체 팀 내부 보고로 변환

주의사항

  • 시간 추정 금지: "다음 주 화요일까지 완료" 같은 직접 날짜·시간 추정은 priority labels로 변환
  • 개인 평가 금지: 팀원 개인 비난·칭찬은 본문에 자동 포함되지 않음 (필요 시 별도 1:1)
  • 확인되지 않은 수치 금지: KPI 데이터 출처(BI 도구·내부 DB) 명시 또는 [추정] 태그
  • NDA 정보 주의: 외부 공유용 보고서 작성 시 회사 비밀 정보 자동 검사 (moai-legal:nda-triage 권고)

내장 모드 — 스탠드업 요약 / 회고

별도 스킬 호출 없이 이 스킬 안에서 두 가지 보조 모드를 함께 처리합니다.

스탠드업 요약 모드 (주간보고의 입력 정리)

  • 매일 남긴 데일리 스탠드업 메모(완료·진행 중·블로커)를 한 주 단위로 누적·압축
  • "이번 주 스탠드업 정리", "데일리 노트 모아줘" 같은 요청 시 이 모드로 진입
  • 정리된 결과를 그대로 6섹션 주간보고의 raw input(완료·진행 중·이슈)으로 연결

회고 모드 (KPT·4Ls)

  • 위 "② 회고 프레임워크 KPT·4Ls" 표를 사용해 분기/스프린트 회고 섹션을 생성
  • "이번 분기 회고", "스프린트 회고 정리" 요청 시 이 모드로 진입
  • 주간보고 본문에 회고 섹션으로 통합하거나, 단독 회고 문서로 출력

관련 스킬

Before:

  • (Notion·Linear·Asana MCP) — 자동 데이터 fetch (스탠드업 메모는 위 "스탠드업 요약 모드"로 직접 정리)

After (텍스트 산출물 후처리 — 표준 체인):

  • moai-core:ai-slop-reviewer — AI 패턴 검수
  • moai-content:humanize-korean — 한국어 자연스러움 보정 (ai-slop-reviewer 다음)
  • moai-bi:executive-summary — C-level 1pager로 더 압축
  • moai-office:pptx-designer — 발표 슬라이드 출력

Alternative:

  • moai-business:daily-briefing — 일간 보고 (주간이 아닌 일일)

관련 커맨드

  • 등록된 스킬 체인:
  • 주간보고 본문 후처리(표준): weekly-report → moai-core:ai-slop-reviewer → moai-content:humanize-korean
  • 주간보고 → 임원 1pager: weekly-report → moai-core:ai-slop-reviewer → moai-content:humanize-korean → moai-bi:executive-summary
  • 발표 슬라이드: weekly-report → moai-core:ai-slop-reviewer → moai-content:humanize-korean → moai-office:pptx-designer

출처

  • 글로벌 베스트 프랙티스: Notion AI WBR 템플릿 (KPI/Done/Plan/Risk 4섹션), Linear Cycles 1-2주 단위, Asana Status Updates (Green/Yellow/Red)
  • 한국 직장 문화: 월요 오전 WBR, 금요 마무리 보고
  • McKinsey Pyramid Principle (결론 → 근거 → 데이터)

How to use it

Copy the folder

Take modu-ai/weekly-report from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.