weekly-report

name	weekly-report
description	한국 팀의 주간 비즈니스 리뷰(WBR) 보고서 자동 생성 스킬입니다. 일일 노트·완료 태스크·KPI 데이터를 입력받아 임원/팀 두 버전(격식체/구어체)으로 작성합니다. Notion·Linear·Asana·Slack MCP가 가용하면 자동 데이터 fetch, 없어도 자유 텍스트 입력 fallback. 다음과 같은 요청 시 반드시 이 스킬을 사용하세요: - "주간보고 작성", "WBR 준비", "이번 주 한 일 정리" - "주간 회의 자료", "위클리 리포트", "주간 업무 보고" - "임원 주간보고", "팀 주간보고" [책임 경계] 제품 발견·로드맵/마일스톤 기획은 moai-product:roadmap-manager, 본 스킬은 운영 케이던스(주간보고)
user-invocable	true
version	2.27.0

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단:

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

한국 주간보고 안티 패턴

• 일주일 행동 일기처럼 시간순 나열 (임팩트 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 (결론 → 근거 → 데이터)