정본 안내 (2026-07-17 갱신
— 엔진 은퇴)
- 재현 규칙 정본은
DESIGN.md: ../assets/mck-style/DESIGN.md.
색·폰트·그리드·금지 목록의 유일한 기준이며, 운영위
하우스스타일(unwi-house-style)과 동일하게 엔진 없이
이 문서만으로 python-pptx를 직접 호출해 제작한다.
- 레이아웃 아이디어 카탈로그:
../assets/LAYOUTS.md —
Mck-ppt-design-skill의 72종 슬라이드 타입을 한국어로 증류한 공용
자산(맥킨지 스타일 전용이 아니라 어느 PPT 스타일에서도 참고). 콘텐츠에
맞는 레이아웃 구조를 여기서 고르고, 색·폰트 등 실제 구현은 DESIGN.md를
따른다.
- 엔진(
~/Projects/mck-ppt-design-skill,
mck_ppt 파이썬 패키지)은 프로덕션에서 더 이상 import하지
않는다 — "참고 자산(레이아웃 아이디어 카탈로그·색 상수
원안)"으로 강등(HC 지시, 2026-07-17). 사유: 엔진에 하드코딩된
중국어(한자) 보일러플레이트가 실제 산출 PPT에 그대로 렌더링되는 결함이
실측 확인됨 — mck_ppt/engine.py:209의
'解决路径' if not unit else '详细说明'(핵심 수치 레이아웃의
상세 박스 라벨), mck_ppt/engine.py:313 부근
table_insight()의 기본값
insight_title='启示:',
mck_ppt/constants.py:83의
FONT_EA = 'KaiTi'(중국어 서체 규정). 모든 텍스트는
한국어 또는 영어만 — 중국어는 절대 쓰지 않는다.
- 아래 "관찰 체크리스트"·"사용 요점"·"가드레일 요약"은 **엔진 자체의
설계 기록(역사적 참고)**으로 남겨둔다. 실제 제작 규칙은 DESIGN.md를
본다.
관찰 체크리스트
(레퍼런스 충실 프로토콜 1단계)
| # |
항목 |
레퍼런스는? (관찰) |
| 1 |
슬라이드 규격 |
13.333×7.5in(16:9) 고정, 좌우 여백 0.8in, 콘텐츠 폭 11.733in — 모든
레이아웃이 이 그리드를 공유 |
| 2 |
제목(Action Title) 규칙 |
22pt bold Georgia, 라벨이 아닌 완전한 통찰 문장(예: '연결조합 제약
AI 모델은 자유 파라미터를 90% 줄여 단일세포 정밀도 예측을 달성' —
'연결조합 제약 AI 모델' 같은 라벨형 제목은 금지) |
| 3 |
색 체계 |
NAVY(#051C2C) 단일 주색 + 그레이 4단(DARK/MED/LINE/BG_GRAY)으로
대부분 표현, 액센트 4색(BLUE/GREEN/ORANGE/RED)은 3개 이상 병렬 항목이
있을 때만 제한적으로 사용 |
| 4 |
타이포 위계 |
44(표지)/28(섹션)/22(Action
Title)/18(서브헤더)/16(강조)/14(본문)/9pt(출처) 고정 7단계, 다른 크기
사용 금지 |
| 5 |
콘텐츠 밀도 |
내용 페이지는 최소 3블록(제목+본문+요약)·본문 영역 사용률 50%
이상·페이지마다 9pt 출처 표기 필수, 하단 요약바는 y=6.1~6.4in 구간에
고정 |
| 6 |
도형·차트 규칙 |
도넛/파이/게이지는 BLOCK_ARC 네이티브 도형(3~5개)만 사용 — add_rect
반복으로 원호를 흉내내는 방식 금지,
커넥터(add_connector)·그림자·3D·그라데이션 전면 금지(파일 손상·시각적
결함 유발) |
| 7 |
표(table) 스타일 |
행 구분선만 LINE_GRAY(#CCCCCC), 인접 슬라이드에 같은 레이아웃 연속
금지(다양성 강제), two_column_text는 전체 1장 이내로 제한 |
| 8 |
가드레일·QA |
오버플로우 방지·범례 색 일치·동적 사이징 등 10개 강제 규칙 + 렌더링
후 gate_check.py 자동 채점(문장형 판단 아닌 JSON passed 필드로만 통과
인정, user_code_errors=0 필수) |
| 9 |
제작 엔진 |
python-pptx 래퍼 MckEngine — 67개 고수준 레이아웃 메서드(eng.cover,
eng.donut, eng.timeline 등), S1브리프→S2구조→S3콘텐츠→S4렌더/QA→S5납품
5단계 고정 플로우로 생성 |
제작 엔진 위치
- 로컬 클론:
~/Projects/mck-ppt-design-skill (원본 https://github.com/likaku/Mck-ppt-design-skill,
Apache 2.0)
- 스타일 정본 파일:
mck_ppt/constants.py(색·크기 상수),
references/color-palette.md,
references/team/brand-guide.md,
references/framework/guard-rails.md(10대 강제 규칙),
references/framework/planning-guide.md(구조·레이아웃 선택
규칙)
사용 요점
SKILL.md의 5단계 하네스 플로우(S1 Brief → S2
Structure(outline.json) → S3 Content(content.json, gate_check_s3.py
게이트) → S4 Render+QA(.pptx, gate_check.py 게이트) → S5 Deliver)를 스킵
없이 따른다 — 게이트는 AI 자기판단이 아니라 스크립트 산출 JSON의
passed 필드로만 통과를 인정한다.
- 코드 진입점:
from mck_ppt import MckEngine →
eng = MckEngine(total_slides=N) →
eng.cover()/eng.table_insight()/eng.donut()/eng.timeline()
등 12개 카테고리 67개 메서드 호출.
라이선스
Apache License 2.0. 재배포(수정 여부 무관) 시 NOTICE
파일 전문을 동봉해야 한다(Apache 2.0 4(d)항). 서드파티 구성요소:
python-pptx(MIT), lxml(BSD), Pillow(HPND), rembg(MIT).
한글 작업 시 폰트 대체 규칙
원본 디자인 시스템의 CJK 서체는 중국어용 KaiTi(楷体)다. 한글 슬라이드
제작 시에는 KaiTi 대신 Noto Sans KR로 전면 대체한다(HC
표준, feedback_noto_sans_default 지시) — 영문 제목
Georgia·영문 본문 Arial 조합은 유지하되, 한글이 섞이는 모든 텍스트 run에
latin/ea/cs 폰트를 각각 명시해야 한글 부분만 렌더가 깨지는 사고를
막는다.
가드레일 요약
(guard-rails.md 10개 중 발췌)
- 하단 요약바와 본문 사이 최소 0.15in 간격 확보
- 우측 여백 12.533in·하단 6.95in 넘는 콘텐츠 배치
금지(오버플로우)
- 수량이 가변인 레이아웃(체크리스트 행·프로세스 노드 등)은 항상 동적
사이징으로 폭/높이 계산 — 고정폭 금지
- add_connector() 사용 금지(문서 손상 유발), 모든 도형은
_clean_shape()로 p:style 제거
스크린샷 출처
GitHub README의 실제 렌더링 샘플 이미지(원격 URL,
user-attachments 첨부)를 다운로드해 사용 — 실제 python-pptx
엔진이 생성한 슬라이드 캡처다(사양 카드 아님). 대표 이미지는
"它是什么/解决什么问题" 2단 본문 슬라이드(Action Title+DARK_GRAY
본문+NAVY Key Takeaway 바), 보조 이미지는 색 체계 표 슬라이드.