사무 문서 전담 AI 코워커 — 한국형 오피스 문서(HWPX·DOCX·XLSX·PPTX·PDF)·HTML 리포트/슬라이드 생성, 공문서 파싱, 노션 템플릿·생산성 루틴 스킬. kordoc MCP 연동. 공공데이터 조회·데이터 분석은 moai-analyst로, 라이프스타일은 moai-coworker로 분리. 자연어 요청 시 매칭 스킬이 자동 호출됩니다. 이런 분께 추천: 사무직·기획자·자영업 운영자.

version
1.3.9
GitHub stars
316

Install

/plugin install moai-officer@moai-cowork

Run it inside Claude Code after adding the marketplace with /plugin marketplace add modu-ai/moai-cowork.

Contents

Discovered from source

Skills 15

문서·수치 검수

원본을 수정하지 않고 산출물과 제공된 자료를 대조한다.

  • 통계마다 식별 가능한 출처와 기준 시점을 확인한다. 공공데이터의 원천 진위까지 필요한 경우 moai-analyst:data-provenance-audit 기준으로 별도 확인한다.
  • 차트·SVG 라벨·표·요약문의 값, 단위, 축 범위와 날짜가 원자료와 일치하는지 확인한다. 합계·증감률·평균·단위 변환을 다시 계산한다.
  • 파일 확장자와 실제 형식, 공문서의 수신·본문·붙임, 번호와 날짜 표기가 목적에 맞는지 확인한다.
  • 주민등록번호·연락처·개인 주소·계좌번호가 불필요하게 노출됐는지 확인한다. 자료 조회·파싱 실패를 추정값으로 채우지 않았는지 본다.

보고서는 판정(PASS/FAIL/미확인), 확인 자료, 수치별 재계산, 심각도·위치·근거가 있는 발견, 미검증 항목으로 작성한다. 원자료가 없으면 정합성을 PASS로 판정하지 않는다. 독립된 검수자를 실행하지 않았다면 독립 감사라고 부르지 않는다.

Claude의 data-auditor 에이전트와 목적이 겹친다. ChatGPT 플러그인에서는 이 스킬이 발견 가능한 진입점이다.

doc-design-library — moai-designer 정본 포인터

본 스킬(moai-officer:doc-design-library)은 moai-designer 플러그인의 정본을 가리키는 포인터입니다.

왜 포인터인가

디자인 시스템의 정의는 moai-designer:design-system-library가 관리합니다. 이 스킬은 문서 제작 요청을 해당 라이브러리로 연결합니다. 설치된 플러그인과 사용 가능한 시스템은 현재 호스트에서 확인합니다.

사용 방법

design_system 토큰이 필요하면 moai-designer:design-system-library 스킬을 직접 호출하세요. 토큰의 색·타이포·radius·spacing·컴포넌트 정의와 Tailwind Play CDN config 매핑, getdesign.md 상세 페이지 링크 모두 그곳에 있습니다.

연결

  • 정본: moai-designer:design-system-library (현재 사용 가능한 시스템 확인)
  • 적용처: moai-officer:doc-html-report · moai-officer:doc-html-slide (design_system 파라미터로 토큰 로드)
  • Claude Design 핸드오프: DESIGN.md 지침 소스는 정본에서 제공

워드 문서 생성기 (DOCX Generator)

개요

현재 호스트의 문서 생성 기능으로 DOCX를 만듭니다. 실행 환경에 python-docx가 이미 있으면 아래 코드 패턴을 사용할 수 있습니다. 한국 공문서·기업 보고서·계약서·제안서를 지원하며, 결과물이 "AI가 만든 듯한 진부한 디자인"이 아닌 요청한 브랜드와 문서 목적에 맞춰 색·타이포·간격을 정합니다.

트리거 키워드

워드, docx, Word 문서, 계약서, 공문서, 보고서 생성, 문서 편집, 기안문, 제안서, 공문, 협조문, 기획서

디자인 시스템 — 사용자 브랜드 우선

사용자가 제공한 브랜드 지침과 제출처 양식이 우선입니다. 없으면 읽기 쉬운 중립 서식을 고릅니다. Claude 톤을 요청한 경우에만 references/modern-design-system.md의 예시 색·타이포·간격을 참고합니다.

색 팔레트 (Claude 톤을 요청한 경우의 예시)

역할색hex사용처
PrimaryAnthropic Orange#d97757강조 헤딩·차트 highlight·구분선
SecondaryAnthropic Blue#6a9bcc보조 강조·인용·표 헤더
BackgroundLight Beige#faf9f5본문 배경 (대신 #ffffff도 가능)
SurfaceWhite#ffffff표·코드 블록 배경
Text PrimaryDark#141413본문 텍스트 (#000 대체)
Text SecondaryMid Gray#b0aea5캡션·메타 정보
BorderLight Gray#e8e6dc표 보더·구분선

타이포그래피 — 한국·영문 페어링

위계한국 폰트영문 폰트사이즈weight
본문 표지PretendardInter28ptBold
H1PretendardInter22ptBold
H2PretendardInter18ptSemiBold
H3PretendardInter14ptSemiBold
본문PretendardInter / Lora*11ptRegular
캡션PretendardInter9ptRegular
코드/모노구름 산스 코드구름 산스 코드 (Goorm Sans Code)10ptRegular

* Lora는 영문 인용문에 선택할 수 있는 서체 예시입니다. 실제 설치·대체 서체를 확인합니다.

간격·여백

  • 페이지: A4 (210×297 mm)
  • 여백: 상하 30mm · 좌우 25mm (공문서 표준) / 상하 25mm · 좌우 22mm (모던 보고서)
  • 줄 간격: 본문 1.5배 · 캡션 1.2배
  • 헤딩 상하: H1 상 24pt 하 12pt · H2 상 18pt 하 9pt · H3 상 12pt 하 6pt
  • 단락 간 여백: 6pt
  • 표 셀 패딩: 좌우 6pt 상하 4pt

워크플로우

1단계: 문서 유형 결정

유형디자인 톤권장 팔레트 변형
한국 공문서제출처 서식·문서 목적기관 양식 또는 중립색
기업 보고서사용자 브랜드·가독성중립색, 요청 시 Claude Classic 예시
계약서조항 구분·가독성중립색
제안서사용자 브랜드·독자브랜드색, 요청 시 Claude Coral 예시
기획서사용자 브랜드·독자브랜드색, 요청 시 Claude Blue 예시
사업계획서실제 제출 요건·브랜드브랜드색, 요청 시 Claude Bold 예시

2단계: 내용 수집 및 구조화

문서 유형별 표준 구조 (references/modern-templates.md 참고):

공문서: 실제 제출처 양식을 먼저 확인하고, 수신처·제목·본문·발신자·붙임 등 필요한 항목을 채웁니다. 일반 서식 참고는 doc-hwp의 references/kr-official-forms.md와 이 스킬의 한국형 레이아웃 예시를 사용합니다. 기관 양식이 없는데 모든 공문서에 동일한 결재란·번호 체계를 강제하지 않습니다. 계약서: 갑·을 표시·계약 목적·범위·기간·대금·지적재산권·비밀유지·해지·분쟁 해결·서명란 제안서: 표지·요약(Executive Summary)·현황·제안·기대효과·일정·예산·팀 보고서: 요약·배경·분석·결론·권고·부록 기획서: 배경·목표·전략·실행안·KPI·리스크

3단계: 사용 가능한 문서 도구로 생성

현재 호스트의 문서 생성 도구가 있으면 그 도구를 사용하고, 실제 DOCX 저장·열기 가능 여부를 확인합니다. python-docx가 이미 설치된 실행 환경에서는 아래 예시를 사용할 수 있습니다. 도구가 없으면 설치를 사용자에게 요구하지 않고 문서 내용과 구조를 제공하며 DOCX 파일을 만들었다고 표시하지 않습니다.

from docx import Document
from docx.shared import Pt, Cm, RGBColor
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.oxml.ns import qn
from docx.oxml import OxmlElement

doc = Document()

# 페이지 설정 — A4 + 모던 여백
section = doc.sections[0]
section.page_height = Cm(29.7)
section.page_width = Cm(21.0)
section.top_margin = Cm(2.5)
section.bottom_margin = Cm(2.5)
section.left_margin = Cm(2.2)
section.right_margin = Cm(2.2)

# 중립 예시. 사용자 브랜드·제출처 지정값이 있으면 그것을 적용한다.
INK = RGBColor(0x14, 0x14, 0x13)

# H1 스타일
h1 = doc.styles['Heading 1']
h1.font.size = Pt(22)
h1.font.bold = True
h1.font.color.rgb = INK

# 제목 내용은 실제 자료로 채우고, 색은 브랜드 지정값을 우선한다.
title = doc.add_heading('{문서 제목}', level=0)
for run in title.runs:
    run.font.color.rgb = INK
    run.font.size = Pt(28)

전체 코드 패턴은 references/modern-templates.md 참고.

4단계: 서식 적용 및 파일 출력

  • 단락 스타일 (제목 1-3·본문·인용·캡션)
  • 표 (헤더 음영 Light Beige, 보더 Light Gray, 줄 변경 시 zebra striping)
  • 이미지 (로고·차트·서명) + 캡션 자동 배치
  • 머리글/바닥글 (페이지 번호 우측 하단, 발행처 좌측 하단)
  • 플레이스홀더 일괄 치환 ({변수명} → 실제 값)

5단계: 검수 (10단계 체크리스트)

references/qa-checklist.md의 10단계를 자동/반자동 점검:

  1. 빈 플레이스홀더 없음 ({변수명} 패턴 잔존 확인)
  2. 페이지 번호 모든 페이지에 표기
  3. 헤딩 위계 연속 (H1 → H3 건너뛰기 없음)
  4. 표 경계선 일관 (보더 색·두께 통일)
  5. 폰트 깨짐 없음 (Pretendard·맑은 고딕 시스템 폰트 확인)
  6. 실제 적용한 본문색과 배경색의 대비를 계산해 4.5:1 이상인지 확인
  7. 이미지 캡션 일관 (위치·형식)
  8. 단락 간 여백 일관 (수동 빈 줄 사용 금지)
  9. 표 셀 텍스트 줄바꿈 정상 (overflow 없음)
  10. AI 슬롭 표현 없음 (혁신적인·차세대·재정의하는 등 — moai-designer:design-slop-check 체이닝 권장)

모던 디자인 패턴 6종

Pattern 1 — Executive Summary Box

보고서·제안서 첫 페이지에 1-page 요약 박스.

┌────────────────────────────────────────┐
│ Executive Summary                      │  ← Orange 강조선
│ ──────────────────────────────────     │
│ [4-5줄 핵심 요약 — 본문보다 약간 큰   ]│
│ [폰트, 좌측 Orange 강조선 4pt]         │
└────────────────────────────────────────┘

Pattern 2 — Pull Quote

본문 중간의 인용 강조.

        ┃ "[인용문 — Lora 세리프 16pt 이탤릭]"
        ┃   — 출처 (Mid Gray, 11pt)

Anthropic Blue #6a9bcc 좌측 보더 4pt + Lora 이탤릭.

Pattern 3 — Stat Callout

숫자 강조 영역.

   [{증감률}]      [{효율}]         [{절감액}]
   매출 증가      ROI 개선         예상 절감

숫자: Orange 36pt Bold · 라벨: Mid Gray 11pt.

Pattern 4 — Comparison Table

좋은/나쁜·기존/제안 비교.

| 기준        | 기존        | 제안         |
| ---        | ---        | ---         |
| Beige 헤더 | White cell | Orange tint |

Pattern 5 — Sidebar Note

본문 옆 메모·주석 박스 (Light Beige 배경).

Pattern 6 — Section Divider

섹션 사이 시각 구분.

─── ⬢ ────────────────────────────────
      Section 2 — 시장 분석

Orange 작은 도형 + Mid Gray 가로선 + 섹션 번호.

사용 예시

  • "용역 계약서 DOCX를 작성해 줘 (갑: A사, 을: B사, 계약금 1,000만 원)" → Mono Strict 팔레트
  • "Q1 분기 보고서를 모던 톤으로 만들어 줘" → 브랜드 지침을 확인하고 필요한 요약·수치 블록만 구성
  • "스타트업 사업계획서 30페이지" → 제출 목적·자료에 맞춰 분량과 구조를 정함
  • "행정기관 협조 공문" → Classic Mono 팔레트 + 공문서 표준 양식
  • "내부 기획서를 발표용으로도 쓸 수 있게" → 발표용 화면과 문서용 페이지 배치를 각각 검토

출력 형식

  • 파일 형식: .docx (Microsoft Word 2007+ 호환)
  • 페이지 설정: A4 (210mm × 297mm)
  • 여백: 상하 25-30mm, 좌우 22-25mm (문서 유형별)
  • 폰트: 사용자 브랜드·제출처 서체를 우선하고, 실제 열람 환경의 설치·대체 상태를 확인
  • 색 인코딩: sRGB
  • 인코딩: UTF-8

주의사항

Claude 톤 색 사용 규칙

  • Primary Orange는 강조에만 — 본문 전체에 도배 금지
  • 한 문서에 Primary + Secondary + Background = 3색 + Dark/Light 무채색만
  • 색 사용은 의미가 있을 때만 (장식 X)

HWPX 대안 사용

한컴오피스 없는 환경에서 공문서가 필요한 경우 DOCX로 대체 가능합니다. 한컴 변환이 필요한 경우 moai-officer:doc-hwp 스킬 참조.

공문서 규정 준수

제출처의 현재 양식과 관련 지침을 확인합니다. 격식 공문서에는 사용자·기관 서식에서 허용하지 않은 브랜드 강조색을 임의로 넣지 않습니다.

폰트 및 배포

서체 이름을 DOCX에 지정하는 것과 글꼴 파일을 문서에 내장하는 것은 다릅니다. 내장을 요청받았다면 현재 도구가 이를 지원하는지와 결과 파일을 확인한 경우에만 완료로 표시합니다. 공유용 PDF도 실제 변환·열람한 경우에만 제공하고, 대체 글꼴과 줄바꿈을 확인합니다.

전자서명

전자서명이 필요하면 현재 사용 가능한 도구가 실제 서명 필드를 만들 수 있는지, 제출처가 어떤 형식을 받는지 확인합니다. 서명 필드나 법적 효력을 생성했다고 확인 없이 보고하지 않습니다.

보안

계약서 등 민감 문서는 전달 대상과 보관 방식을 확인합니다. 암호 보호를 요청받으면 현재 도구에서 실제로 설정·재열람할 수 있을 때만 완료로 표시합니다.

문제 해결

상황해결 방법
파일 생성 실패현재 호스트의 문서 도구와 파일 쓰기 권한을 확인하고, 생성할 수 없으면 초안만 제공
색이 안 나옴RGBColor 사용 여부 확인 (docx.shared.RGBColor)
폰트 깨짐시스템에 Pretendard 설치 또는 PDF 변환
Heading 스타일 안 먹힘doc.styles['Heading 1'] 직접 수정
한글 호환굴림·맑은 고딕 fallback 권장
표 셀 색 안 바뀜_tc.get_or_add_tcPr() + OxmlElement('w:shd') 사용
페이지 번호 안 들어감머리글·바닥글 영역에 field 객체 삽입

자세한 트러블슈팅·코드 예시는 references/modern-templates.md 참고.

관련 스킬 / 자체 검수

문서 생성이 끝나면 .docx를 다시 열어 플레이스홀더·문구·수치·표 내용을 확인합니다. 페이지 배치·글꼴 대체·표 넘침은 실제 렌더링 또는 문서 미리보기로 따로 확인합니다. 확인하지 못한 항목은 미검증으로 남기고 최종 PASS에 포함하지 않습니다(references/qa-checklist.md 참고).

스킬사용 시점
moai-officer:doc-pptx발표용 슬라이드 생성 (사용자 브랜드를 별도로 확인)
moai-officer:doc-hwp한컴 한글 문서 생성 (HWPX)
moai-officer:doc-xlsx엑셀 데이터 시트
moai-officer:doc-pdfPDF 변환·다국어 PDF
moai-writer:korean-humanize카피 AI 슬롭 자연화
moai-coworker:ai-slop-reviewer텍스트 산출물 슬롭 검수
moai-designer:design-slop-checkClaude Design 톤과 일관성 검수

기술 참조

  • python-docx 공식: https://python-docx.readthedocs.io/
  • 행정안전부 공문서 작성 규정: https://www.mois.go.kr/
  • Claude 톤 예시: references/modern-design-system.md의 색·타이포는 선택형 예시이며 현재 공식 브랜드 규격으로 검증되지 않음
  • Microsoft Word 파일 형식: ECMA-376 Office Open XML

상세 레퍼런스

파일로드 조건
references/modern-design-system.md색·타이포·간격 디자인 토큰 전문이 필요할 때
references/modern-templates.md6대 문서 유형별 모던 템플릿 구조·코드 패턴이 필요할 때
references/qa-checklist.md5단계 검수 시 (10단계 체크리스트)
references/document-generator.md한국 비즈니스 문서 생성 가이드가 필요할 때 (기존 자료, 유지)
references/templates/korean-report.md한국형 보고서 DOCX 레이아웃(여백·폰트·구조)이 필요할 때
references/templates/korean-proposal.md한국형 제안서 DOCX 레이아웃이 필요할 때

doc-html-report: 단일 파일 HTML 보고서 렌더러

목적과 범위

moai-officer:doc-html-report는 보고서용 HTML 서식과 작성 절차를 제공합니다. moai-coworker:collab-exec-summary, moai-accountant:finance-financial-statements, moai-consultant:consult-sbiz365 등이 생성한 마크다운 보고서를 참고해 단일 HTML 파일을 작성합니다. 이 스킬에는 자동 변환 실행기가 포함되어 있지 않습니다.

핵심 원칙:

  • 외부 JS 라이브러리(Chart.js, D3, htmx) 0 의존
  • 외부 CSS 프레임워크(Tailwind, Bootstrap) 0 의존
  • 인라인 SVG로 차트 직접 렌더링
  • 한국어 폰트 CDN은 선택 사항으로 두고, 연결되지 않을 때 시스템 서체로 읽을 수 있게 한다

이 스킬은 마크다운 출력을 대체하지 않습니다. 마크다운은 단일 진실(source of truth)로 유지되며, HTML 렌더링은 추가 분기로만 작동합니다.


입력

인자필수기본값설명
markdown✓—변환할 마크다운 본문
mode✓—status | incident | plan | explainer | financial | pr
design_system—기본 템플릿moai-designer:design-system-library에서 현재 확인한 브랜드 시스템. 외부 CDN을 쓰는 구현은 인터넷 연결 필요
slug—제목에서 정함출력 파일명 prefix
output_path—<cwd>/reports/<slug>-<YYYYMMDD>.html출력 경로
font_stack—모드별 기본값폰트 매핑 오버라이드

템플릿의 {{변수}}는 작성용 슬롯 표기다. 렌더러가 제공되지 않으므로 슬롯을 채운 뒤 {{...}} 잔류 여부를 확인한다. 사용자가 제공한 문구는 HTML로 이스케이프하고, 링크는 허용한 https: URL인지 확인한다. *_html처럼 이름에 HTML이 있어도 일반 텍스트 슬롯이다. SVG·HTML 구조가 필요하면 검증된 데이터로 직접 작성하고 스크립트·이벤트 속성·외부 참조가 없는지 확인한다. 확인할 수 없으면 텍스트나 표로 표현한다.

차트와 지표는 원본에 있는 값만 사용한다. 시계열 중간값, 증감률, 원인 설명이 원본에 없으면 그려 넣지 않고 해당 칸을 비우거나 차트를 생략한다. 전체 보고서 변환 요청에서는 템플릿에 없는 원본 섹션도 별도 표·섹션으로 보존한다. 사용자가 요약본을 요청해 생략할 때만 빠진 범위를 산출물에 밝힌다. 저장된 references/samples/와 references/integration-tests/는 가상 서식 자료이며 새 문서의 사실 출처나 현재 호스트의 품질 판정으로 쓰지 않는다.


출력

단일 .html 파일 (<cwd>/reports/<slug>-<YYYYMMDD>.html):

  • 크기: 본문과 포함된 이미지·스타일에 따라 달라짐
  • 외부 의존성: 선택한 폰트·디자인 시스템에 따라 달라짐. 외부 리소스가 있다면 자체 완결형이라고 표시하지 않음
  • 오프라인 사용: 파일을 네트워크 없이 열어 내용과 스타일을 확인한 경우에만 표시

6개 모드

제공하는 템플릿 모드

모드구조 섹션대상 스킬
status메트릭 카드 4개 · 하이라이트 · 완료 테이블 · Velocity SVG 막대 차트 · Carryovermoai-coworker:collab-exec-summary, moai-officer:productivity-briefing
incidentTL;DR 다크 배너 · 타임라인 · 로그 발췌 <details> · 코드 diff 패널 · 영향 테이블 · 액션 체크리스트moai-lawyer:legal-compliance-check
plan요약 KPI 스트립 · 마일스톤 수직 타임라인 · 데이터 플로우 SVG · 슬라이스 테이블 · 리스크 그리드 · 성공 지표moai-consultant:consult-sbiz365
explainer사이드 네비 · <details> 접이식 단계 · 탭 코드 블록(vanilla JS) · FAQ 아코디언 · 콜아웃 박스설명형 문서
financialKPI 카드 4개 · 손익계산서 테이블(항목/당기/전기/증감/증감률) · Variance SVG 수평 막대 차트 · 주석 패널moai-accountant:finance-financial-statements
prTL;DR · PR 메타 행(파일수·+/−·브랜치) · Before/After 2단 카드 · 파일 투어 <details> · 핵심 포인트 · 테스트 체크리스트 · 롤아웃 단계moai-accountant:finance-investor-relations
모드별 입력 항목 요약

각 서식이 채우는 주요 항목입니다(템플릿 내부 변수명 기준).

모드주요 입력 항목
status{{title}}, {{#metrics}}, {{#highlights}}, {{#completed_rows}}, {{#chart_bars}}
incident{{inc_id}}, {{severity}}, {{title}}, {{#tl_entries}}, {{#impact_rows}}, {{#actions}}
plan{{title}}, {{#kpis}}, {{#milestones}}, {{diagram_svg}}, {{#slices}}, {{#risks}}, {{#metrics}}
explainer{{title}}, {{lead}}, {{#steps}}, {{#config_tabs}}, {{#faq_items}}
financial{{title}}, {{period}}, {{#kpis}}, {{#statement_rows}}, {{chart_height}}, {{#variance_bars}}
pr{{pr_ref}}, {{title}}, {{author}}, {{branch}}, {{files_changed}}, {{additions}}, {{deletions}}, {{#focus_items}}, {{#test_items}}, {{#rollout_steps}}

한국어 폰트 정책

한국어 폰트 CDN은 선택 사항입니다. 외부 폰트를 쓰면 연결 없이 서체가 달라질 수 있습니다.

시스템 서체는 OS마다 다를 수 있습니다. CDN을 선택했다면 연결 실패 시에도 읽을 수 있는 폴백을 지정하고, 오프라인 품질은 실제 파일을 열어 확인합니다.

모드별 폰트 매핑

모드sans (본문)serif (제목)mono (코드)
status / financial / prPretendardPretendard 700JetBrains Mono
incidentPretendardPretendard 700JetBrains Mono
planPretendardNoto Serif KRJetBrains Mono
explainerNoto Sans KRNoto Serif KRJetBrains Mono

상세 CDN URL 및 preconnect 패턴: references/fonts.md


디자인 토큰 (CSS 변수 계약)

템플릿은 :root의 CSS 변수를 참고합니다. 실제로 사용한 변수와 대비는 산출 파일에서 확인합니다.

:root {
  /* 팔레트 */
  --ivory: #FAF9F5;   /* 배경 warm off-white */
  --paper: #FFFFFF;   /* 카드·패널 배경 */
  --slate: #141413;   /* 본문 텍스트 warm black */
  --clay:  #D97757;   /* 강조·링크 terracotta */
  --clay-d:#B85C3E;   /* clay hover 상태 */
  --oat:   #E3DACC;   /* 보조 배경·구분선 light tan */
  --olive: #788C5D;   /* 보조 강조 sage green */

  /* 폰트 */
  --sans:  "Pretendard", system-ui, -apple-system, sans-serif;
  --serif: "Pretendard", ui-serif, Georgia, serif;
  --mono:  "JetBrains Mono", ui-monospace, "SF Mono", monospace;

  /* 레이아웃 */
  --max-width:    860px;
  --radius-panel: 12px;
  --radius-row:   8px;
  --border:       1.5px solid var(--g300);
}

그레이 스케일: --g100: #F0EEE6, --g300: #D1CFC5, --g500: #87867F, --g700: #3D3D3A

상세 명도 대비 검증표 및 인쇄 토큰: references/design-tokens.md


디자인 시스템 적용 (design_system 파라미터)

design_system 입력을 지정하면 현재 설치된 moai-designer:design-system-library에서 사용할 수 있는 토큰을 확인합니다. Tailwind Play CDN을 쓰는 예시 템플릿은 인터넷 연결이 필요합니다.

작성 방식:

design_system방식외부 의존산출물 특성
미지정기본 템플릿사용한 폰트 링크에 따라 다름브라우저에서 오프라인 결과 확인
지정한 브랜드실제 사용 가능한 템플릿 확인CDN 사용 여부 확인브라우저에서 온라인·오프라인 결과 구분

브랜드 시스템은 사용자 지침에 지정된 경우에 적용한다. 모드 이름만으로 Claude·ClickHouse 등 다른 회사의 브랜드를 선택하지 않는다.

적용 절차

  1. 실제 설치된 디자인 시스템에서 지정한 브랜드의 토큰을 읽는다.
  2. 사용할 색과 서체를 HTML의 CSS 변수에 적용한다.
  3. 필요한 경우에만 외부 CDN을 추가하고, 최종 HTML에서 해당 URL을 확인한다.
  4. 온라인 및 오프라인에서 실제 파일을 열어 결과를 확인한다.

주의: 브랜드 예시에 Tailwind Play CDN이 포함되었다면 오프라인에서 스타일이 달라질 수 있습니다. 오프라인·인쇄·이메일 첨부 용도에는 필요한 CSS를 문서 안에 포함하고 실제 파일을 확인하세요.


체인 통합 권장

[텍스트 스킬] → moai-coworker:ai-slop-reviewer → moai-writer:korean-humanize → moai-officer:doc-html-report (서식 선택)

최소 체인 (빠른 렌더링):

[텍스트 스킬] → moai-officer:doc-html-report (서식 선택)

브랜드 디자인 시스템 적용 체인:

[텍스트 스킬] → ai-slop-reviewer → doc-html-report (design_system: clickhouse)

디자인 시스템을 지정했으면 해당 플러그인과 토큰이 현재 호스트에 있는지 확인합니다. 없다면 사용자 지정 색·서체를 일반 CSS에 적용합니다.


사용 예시

예시 1: 주간 현황 보고서

경영 요약 결과를 받아서 한울 엔지니어링 11주차 현황 보고서 HTML로 만들어줘.

예시 2: 재무제표 HTML 보고서

재무제표 결과를 HTML 보고서로 변환해줘.

예시 3: 인시던트 리포트

결제 게이트웨이 502 장애 내용을 정리해서 인시던트 리포트 HTML로 만들어줘. 심각도는 SEV-2.

예시 4: PR 설명 문서

PR #312 실시간 알림 채널 통합 내용을 HTML 리뷰 문서로 만들어줘.

시각 품질 게이트 (필수)

[HARD] 렌더가 끝나면 산출 HTML을 브라우저에서 열어 아래 4축을 실측하고 PASS/FAIL을 보고한다. 과거 샘플은 이 기준의 통과 증거가 아니다. 실제 열람·실측이 불가능하면 미검증으로 기록하고 PASS라고 쓰지 않는다.

인쇄용 또는 PDF 변환용 요청이면 인쇄 미리보기나 실제 PDF를 열어 페이지 잘림·표 누락·차트 가독성을 별도로 확인한다. 이 결과가 없으면 화면 검사가 통과해도 인쇄/PDF 품질은 미검증으로 남긴다.

공통 4축 — 렌더 후 DOM 실측으로 판정한다. 눈으로 훑는 것으로 갈음하지 않는다.

축측정기준등급
본문 크기본문 노드 computed font-size≥16px (화면 읽기 기준). 부연·캡션 ≥14pxhard
명도대비상대 휘도 기반 WCAG 대비비본문 ≥4.5:1 · 큰 텍스트 ≥3:1hard
텍스트 오버플로scrollHeight > clientHeight0건hard
산출물 밖 요소본문 컨테이너 바깥의 렌더되는 텍스트 노드0개 — 장수·해상도·사용 폰트 같은 제작 메타는 화면에 찍지 않는다(HTML 주석으로)hard

아이콘을 쓸 때 — 아이콘은 레이아웃상 빈 자리로 보여서, 근거를 요구하지 않으면 손에 잡히는 몇 개를 돌려쓰게 된다.

  • 문구의 동사에서 고른다 (적는다 → 메모, 멈춘다 → 정지). 명사가 아니라 그 자리가 시키는 행동에 맞춘다.
  • 한 문서에서 같은 아이콘을 3회 넘게 쓰지 않는다.
  • 마땅한 것이 없으면 비운다. 빈 자리가 틀린 아이콘보다 낫다.
  • [HARD] 아이콘을 썼으면 PASS/FAIL 증거표에 넣는다. 슬롯 문구·아이콘·고른 이유를 나란히 적어 보고한다. "아이콘이 필요해서" 같은 동어반복은 근거가 아니며, 근거를 한 줄로 못 쓰면 비운다.

이 4축은 doc-html-slide/references/deck-quality-rubric.md의 hard-fail에서 문서형(연속 스크롤)에 해당하는 것만 옮겨온 것이다. 프로젝터 투사 기준인 pt 하한(24pt)은 문서형에 적용하지 않고 화면 읽기 기준(16px)으로 대체한다.


하지 않는 것

  • 마크다운 기본 출력을 대체하지 않습니다 — HTML은 추가 렌더링 분기입니다.
  • 기본 템플릿은 React / Vue / Chart.js / D3를 요구하지 않습니다. 브랜드 예시에서 Tailwind CDN을 썼다면 외부 의존성을 명시합니다.
  • 빌드 단계(webpack, vite, esbuild)를 도입하지 않습니다.
  • 슬라이드는 moai-officer:doc-pptx, 독립 차트는 moai-analyst:data-visualizer가 맡습니다.
  • 여러 파일로 나누지 않습니다 — 모든 산출물은 단일 .html 파일입니다.

참고 문서

설계 문서

템플릿

샘플 출력

설계 참고: Thariq Shihipar, "The Unreasonable Effectiveness of HTML" — 외부 라이브러리 없이 HTML 한 파일로 끝내는 접근의 출처.


P1 컨슈머 통합

다음 파일은 과거에 저장한 입력·출력 예시입니다. 현재 호스트의 통합 테스트 결과로 간주하지 않고, 새 산출물은 별도로 렌더링해 확인합니다.

컨슈머 스킬적합 모드입력 파일렌더링 출력호환성
moai-coworker:collab-exec-summarystatusreferences/integration-tests/executive-summary-input.mdreferences/integration-tests/executive-summary-rendered.html과거 예시
moai-accountant:finance-financial-statementsfinancialreferences/integration-tests/financial-statements-input.mdreferences/integration-tests/financial-statements-rendered.html과거 예시
moai-consultant:consult-sbiz365planreferences/integration-tests/sbiz365-analyst-input.mdreferences/integration-tests/sbiz365-analyst-rendered.html과거 예시
moai-officer:productivity-briefingstatus (daily variant)references/integration-tests/daily-briefing-input.mdreferences/integration-tests/daily-briefing-rendered.html과거 예시

상세 호환성 분석: references/integration-tests/COMPATIBILITY.md

doc-html-slide — 단일 파일 HTML 슬라이드 덱 생성기

목적과 범위

moai-officer:doc-html-slide는 발표용 슬라이드 덱을 단일 HTML 파일로 만듭니다. 이웃 스킬 doc-html-report의 "인라인 SVG·design-system-library 토큰 계약" 아키텍처를 계승하되, 연속 스크롤 문서가 아닌 16:9 슬라이드 시퀀스 + 자체 vanilla JS 덱 런타임(키보드 내비게이션·풀스크린·?print-pdf 인쇄 모드·speaker notes 토글)을 제공합니다.

핵심 원칙:

  • 단일 .html 파일 — 외부 빌드 단계·런타임 SPA 의존 없이 file://로 즉시 오픈
  • 인포그래픽은 인라인 SVG로 직접 작성 — 숫자·라벨은 원자료와 대조하고 확대 렌더를 확인
  • 실사·일러스트 이미지는 앱 기본 이미지 도구 또는 사용자가 지정한 Higgsfield 연결로 생성 (references/image-backend-policy.md)
  • 설치된 design-system-library 브랜드 토큰 적용 — getdesign.md 참고 링크 제공
  • 편집 가능 PPTX 산출은 이 플러그인의 doc-pptx 지침과 현재 사용 가능한 생성 도구로 수행

원고 SSOT: 모든 덱은 구조화 원고 deck.json(title/bullets/chart-data/image-path/layout-key/notes)을 단일 진실 원천으로 둡니다. PPTX도 요청받았다면 같은 원고를 참고해 각 요소를 편집 가능한 객체로 만들고 실제 파일에서 확인합니다. 원고를 공유한다는 사실만으로 PPTX 편집 가능성이 보장되지는 않습니다.


입력

인자필수기본값설명
topic / 자연어 주제✓—덱 주제·대상 청중·발표 목적
design_system—미지정사용자 브랜드 또는 현재 설치된 design-system-library의 시스템. 실제 토큰과 외부 CDN 사용 여부를 확인. 참고 링크는 references/design-system-links.md
slide_count / 발표 시간—주제에서 추천3분=5-7장 · 10분=10-15장 · 30분=20-30장
aspect_ratio—16:916:9(프로젝터 표준) | 1:1(소셜/카드뉴스)
locale—koko | en — 헤드라인·카피 언어
image_backend—nativenative(앱 기본 이미지 생성) | higgsfield(사용자가 지정한 Higgsfield 연결) | svg-only(이미지 없이 SVG 장식만). 기존 codex 값은 native로 해석
export_pptx—falsetrue 시 doc-pptx 체이닝으로 편집 가능 .pptx 병행 산출
output_path—<cwd>/reports/<slug>-slides-<YYYYMMDD>.html출력 경로

출력

  • 주 산출물: 단일 .html 파일 (<cwd>/reports/<slug>-slides-<YYYYMMDD>.html)
    • 브라우저에서 열 수 있는 단일 파일. 외부 리소스를 썼다면 자체 완결형·오프라인 사용 가능이라고 표시하지 않음
    • 외부 의존: 최종 HTML의 폰트·이미지·CSS·JS URL을 확인하고 오프라인 파일을 직접 검사
  • 병행 산출물 (export_pptx: true 시): 편집 가능 .pptx (doc-pptx 체이닝)
  • 원고: deck.json (HTML·PPTX 양쪽 공통 소스, 산출 디렉토리에 보존)

핵심 워크플로우 (9단계)

1. 컨텍스트 수집

현재 런타임에서 가능한 질문 경로로 사용할 브랜드·발표 시간(슬라이드 수)·이미지 필요 여부·PPTX 산출 여부를 확인합니다. design_system 선택 시 references/design-system-links.md의 getdesign.md 링크로 각 토큰 상세 페이지를 안내해 사용자가 미리보기로 확인할 수 있게 합니다. 강연/발표 맥락 — 비개발자 청중 다수·주간·프로젝터 환경에서는 라이트 테마(claude·notion·apple·stripe·mintlify)가 안전합니다. 다크는 발표 공간을 어둡게 조절할 수 있을 때만 권장.

2. 원고 SSOT 구축 (핵심)

deck.json 원고를 먼저 작성합니다 — title/bullets/chart-data/image-path/layout-key/notes. 이 원고가 HTML 렌더와 doc-pptx PPTX 렌더 양쪽의 공통 소스입니다. 스키마: references/deck-manuscript-schema.md. layout-key는 doc-pptx 9 아키타입(Title/Agenda/Problem/Solution/Features/Stats/Team/CTA/Closing)에 정합시킵니다.

3. 인포그래픽 = 인라인 SVG 직접 생성

차트·다이어그램·KPI 카드·타임라인은 LLM이 인라인 SVG로 직접 작성합니다. 한국어 숫자·라벨 100% 정확을 위해 비트맵 이미지로 우회하지 않습니다. 패턴 라이브러리: references/inline-svg-infographics.md.

4. 비트맵 이미지 생성 (필요 시) — 이미지 백엔드 정책

포토 히어로·일러스트 컨셉 등 SVG로 표현 불가능한 비트맵이 필요한 슬라이드만 이미지 백엔드로 생성합니다. 정책: references/image-backend-policy.md.

백엔드모델인증권장 용도
native (기본)앱이 제공하는 이미지 모델앱 로그인일반 이미지 생성
higgsfield연결에서 조회한 Higgsfield 모델Higgsfield 공식 플러그인 또는 MCP의 계정 인증사용자가 Higgsfield를 지정한 경우
svg-only(이미지 없음)—오프라인·비용 민감·빠른 폴백

생성 전에 현재 앱에서 해당 도구가 실제로 노출됐는지 확인합니다 — references/image-backend-policy.md.

한국어 텍스트가 이미지에 들어가면 따옴표·등장 횟수·추가 텍스트 금지를 프롬프트에 명시합니다. moai-media:media-gpt-image-prompt가 설치돼 있으면 이를 참고할 수 있습니다. 정확해야 하는 문구는 HTML/SVG 텍스트로 올립니다.

5. design-system-library 토큰 적용

design_system을 지정했다면 현재 설치된 systems/<name>.md의 토큰을 확인해 CSS에 적용합니다. Tailwind Play CDN을 쓰면 연결이 필요하므로 사용 여부를 산출물에 명시합니다. 미지정이어도 폰트·이미지 URL이 남아 있을 수 있어 오프라인 파일을 별도로 확인합니다.

6. 단일 파일 HTML 덱 조립

16:9 슬라이드 컨테이너 + 자체 vanilla JS 덱 런타임(키보드 내비·풀스크린·?print-pdf 인쇄 모드·speaker notes 토글·progress bar)을 단일 .html로 산출. 런타임 구현: references/html-runtime.md.

  • [HARD] 슬라이드 바깥에 제작 메타를 렌더하지 않는다. 장수·해상도·도식 개수·사용 폰트 같은 제작 메타는 산출물이 아니라 작업 메모다. (카운터·진행바·발표자 노트 같은 덱 조작 UI는 여기 해당하지 않는다 — 루브릭 §제작 메타 판정.) 필요하면 HTML 주석(<!-- -->)이나 deck.json에 남기고, 화면에 찍히는 자리에는 두지 않는다 — 수강생·고객에게 그대로 보인다. 루브릭 #34가 이를 hard-fail로 검사한다.
  • 아이콘은 deck.json의 icon + icon_reason 쌍을 그대로 따른다(스키마 §아이콘 슬롯 계약). 렌더 단계에서 임의로 대체하지 않는다.

7. 슬라이드 카피 검수

모든 슬라이드 카피·speaker notes를 원자료와 대조해 숫자·인용·고유명사·주장의 강도가 유지되는지 직접 확인합니다. moai-coworker:ai-slop-reviewer와 moai-writer:korean-humanize가 설치돼 있으면 문장 검수에 추가로 사용할 수 있습니다. 두 스킬이 없어도 원문 대조를 생략하지 않습니다.

슬라이드 카피 QA 체크리스트 — 구조적 슬롭 S1 패턴 3종: 헤드라인·카피를 직접 읽으며 아래 표현을 검토합니다. 문맥상 필요한 표현까지 기계적으로 삭제하지 않습니다.

#패턴탐지 신호[나쁜 예]수정
1대시 대비 헤드라인대시(—)로 문장 분할 "X — Y" (대시 대비 헤드라인)[나쁜 예] "복붙에서 위임으로 — 목표만 주면"대시 제거, 한 문장 통합 또는 두 문장 분리
2조사·체언 종결 조각문조사·체언 종결 조각문 (조사/체언으로 끝남)[나쁜 예] "성공의 열쇠 — 자동화" (조사·체언 종결)서술어 포함 완전문으로 재작성
3"A에서 B로" 전환 공식"X에서 Y로" 전환 공식 도입[나쁜 예] "엑셀에서 노션으로, 바뀐 것" (전환 공식)전환 공식 대신 구체적 사례로 시작

8. PPTX 산출 (선택, export_pptx: true 시)

deck.json 원고를 이 플러그인의 doc-pptx 작업에 전달합니다. 현재 호스트에서 실제 PPTX 생성 도구가 없으면 요청한 PPTX는 미완료로 표시합니다. 생성했다면 텍스트·차트·도형이 편집 가능한 객체인지 파일을 열어 확인합니다. 체이닝 규약: references/pptx-chaining.md.

9. 정량 QA 채점 (의무)

[HARD] 산출된 HTML을 브라우저에서 렌더해 references/deck-quality-rubric.md의 기준을 확인한다. 이 단계는 §7의 원자료 대조와 함께 수행하며, 눈으로 훑어보는 것으로 갈음하지 않는다 — 루브릭은 DOM 실측(getBoundingClientRect·computed font-size·명도대비 계산)을 요구하고, 그 수치가 곧 증거다.

정량 검수는 실제 렌더링과 측정값이 있어야 수행했다고 보고할 수 있습니다. 브라우저 도구가 없어 측정하지 못한 항목은 미실행으로 남깁니다.

hard 기준 9개(실패군 8종) — 한 건이라도 걸리면 반려하고 고쳐서 다시 렌더한다. (#32와 #33은 둘 다 아이콘 문제라 하나의 실패군으로 보고하되 각각 확인한다.) 이 플러그인에는 자동 채점기나 qa-config.json이 포함되어 있지 않다. 현재 사용 가능한 브라우저 도구로 측정하고, 측정하지 못한 항목은 PASS로 표시하지 않는다.

#기준DOM 측정기본 임계값
9본문 폰트 하한본문 노드 computed font-size. 슬라이드 폭 → pt 환산 후 판정 (1280px 슬라이드 = 960pt, 즉 1px = 0.75pt)≥24pt (온라인 전용 덱 18pt로 하향 설정 가능)
16명도대비상대 휘도 기반 WCAG 대비비본문 ≥4.5:1 · 큰 텍스트 ≥3:1
173D 차트 효과SVG/CSS 원근·rotateX/Y·입체 그림자검출 시 반려
20그리드 정렬 편차동일 역할 요소(제목/푸터) 좌표 표준편차슬라이드 너비 1% 이내
24수치 슬라이드 출처라인숫자·차트·표 있는 슬라이드에 출처:/자료:/Source: 노드부재 시 반려
28텍스트 오버플로scrollHeight > clientHeight 또는 축소 후 하한 미만발생 시 반려
32아이콘 어휘 다양성정규화된 icon ID별 최대 사용 횟수(max_count_per_normalized_icon)같은 아이콘 ≤3회 (역할 반복 예외는 루브릭 §아이콘 근거 판정)
33아이콘 의미 근거icon_reason이 그 문구의 동사·행동과 실제로 대응하는가 — 필드 존재만으로 통과시키지 않는다대응 불명이면 반려
34제작 메타 노출슬라이드 바깥에 렌더되는 제작 메타·디버그 텍스트0개 (런타임 UI는 허용 — §아래)
  • [HARD] pt 환산을 생략하지 않는다. #9는 px 값이 아니라 투사 시 실제 크기를 판정한다. 1280px 덱의 본문 18px는 13.5pt이며, 프로젝터 기준 하한(24pt)의 절반을 조금 넘는 수준이다. px로만 보면 "충분히 커 보이는" 값이 여기서 걸린다.
  • [HARD] 강의장·회의실 투사 덱은 온라인 완화(18pt)를 적용하지 않는다. 완화는 화면으로만 볼 아카이브 덱에 한한다. 어느 쪽인지 불분명하면 §1에서 사용자에게 확인한다.
  • soft 25개 기준도 측정 가능한 항목의 수치와 판정을 보고한다. 가중치와 합격선을 실제로 정하고 계산한 경우에만 종합 점수를 보고한다.

렌더 검사 실무 주의: 슬라이드가 많은 덱은 문서 전체 높이가 수만 px에 달해 브라우저 스크린샷이 빈 이미지를 반환하는 일이 있다. 측정은 스크린샷이 아니라 DOM API(getBoundingClientRect·getComputedStyle·elementFromPoint)로 하고, 시각 확인이 필요하면 대상 슬라이드만 남기고 나머지를 display:none으로 접은 뒤 촬영한다.

그 밖의 기능 검수: 단일 HTML 열기·?print-pdf 인쇄 미리보기·speaker notes 표시·이미지 broken link·한국어 폰트 렌더·이미지 백엔드 정책 준수(허용 백엔드만 사용)를 함께 확인한 뒤 PASS/FAIL 보고. PPTX 체이닝 시 doc-pptx QA 결과 통합 보고.


승인 요청 계약 (런타임 중립)

[HARD] 이 스킬의 게이트는 특정 도구 이름에 묶이지 않는다. AskUserQuestion은 Claude 런타임의 수단일 뿐이고, Codex를 비롯한 다른 런타임에는 그 도구가 없다. 도구 이름으로 계약을 쓰면 그 도구가 없는 런타임에서 게이트가 영구 blocker가 되어, 승인이 필요한 모든 작업이 그냥 멈춘다. 그건 안전이 아니라 고장이다.

승인은 아래 순서로 구한다. 위에서부터 실제로 가능한 첫 번째를 쓴다.

승인의 정의는 수단이 아니라 결과다: 승인서를 사용자에게 그대로 보여주고, 그에 대한 명시적 응답을 받는 것. 아래는 그 결과를 만드는 경로들이며, 위에서부터 가능한 첫 번째를 쓴다.

순위경로조건
1런타임의 구조화 질문 도구 (AskUserQuestion 등)그 도구가 현재 세션에 노출돼 있을 때
2일반 대화로 승인서를 제시하고 다음 턴에서 응답을 받는다사용자와 직접 대화 중일 때. 도구가 없어도 이 경로는 언제나 열려 있다
3구조화 blocker 반환 → 상위 오케스트레이터가 물어봄서브에이전트로 실행 중일 때

[HARD] 런타임의 도구 실행 권한 프롬프트는 승인이 아니다. 그 프롬프트는 "이 도구를 호출해도 되는가"를 물을 뿐, 게이트가 보여주기로 한 인자·견적·동의 문항을 표시하지 않는다. 승인서 전체와 선택지를 실제로 표시하는 경우에만 2번 경로로 인정한다.

[HARD] 2번 경로가 있으므로 "물을 수단이 없다"는 상황은 사실상 없다. 대화가 가능한 곳에서는 언제나 승인서를 글로 제시할 수 있다. fail-closed는 대화도 blocker 반환도 불가능한 완전 무인 실행에만 해당한다 — 그 경우에만 실행하지 않고 멈춘다.

[HARD] 3번을 쓸 때 blocker는 그 자체로 승인 요청서여야 한다. 상위가 무엇을 물어야 할지 모르면 되물을 수 없고, 그러면 교착된다. 다음을 모두 담는다:

  • 승인받을 행위 한 줄 (무엇이 되돌릴 수 없는지 / 얼마가 나가는지)
  • 게이트가 요구하는 인자 전부 (요약하지 않은 값)
  • 선택지 목록 — 상위가 그대로 사용자에게 제시할 수 있는 형태
  • 재개 방법 — 어떤 답을 받으면 무엇을 이어서 실행하는지

[HARD] 세 경로가 모두 불가능한 무인 실행에서는 실행하지 않는다(fail-closed). 물을 수단이 없다는 것은 승인을 받았다는 뜻이 아니다. 이때는 "승인 수단이 없어 진행하지 못했다"고 기록하고 멈춘다 — 조용히 진행하지 않는다. 반대로 대화가 가능한데 도구가 없다는 이유로 멈추는 것도 잘못이다. 2번 경로를 쓴다.

이 계약은 CLAUDE.local.md §범용성 원칙(OS 2종 × 런타임 2종에서 동일 동작)의 게이트 쪽 적용이다. 한 런타임에서만 도는 게이트는 미완성으로 본다.


디자인 시스템 적용 (design_system 파라미터)

design_system 입력으로 현재 설치된 moai-designer:design-system-library의 브랜드 토큰을 확인해 적용합니다. 이 스킬에는 자동 테마 변환 실행기가 포함돼 있지 않습니다.

design_system엔진외부 의존산출물 특성
미지정기본 서식최종 HTML의 폰트·이미지 URL 확인오프라인·인쇄 결과 직접 확인
지정한 브랜드실제 토큰을 CSS에 적용CDN·이미지 사용 여부 확인네트워크 필요 여부를 산출물에 기록

테마별 적합 슬라이드 (자동 추천)

발표 성격추천 design_system
사업계획서·보고서·편집성claude (warm editorial, 크림+코랄)
기술·데이터·엔지니어링·다크 프로젝터clickhouse (dark tech)
제품 소개·SaaS·스타트업notion·apple·stripe·mintlify (light, 깔끔)
마케팅·키노트·임팩트spotify·nike·airbnb (bold)
비개발자 청중·주간·프로젝터 (라이트 안전)claude(예시) · notion · apple · stripe · mintlify
다크 (방을 어둡게 조절 가능할 때)clickhouse · vercel · linear.app · supabase · binance

발표 공간·화면 밝기와 사용자 브랜드를 확인해 라이트·다크를 선택합니다. 외부 갤러리의 구성이나 현재 토큰 수를 고정된 값으로 전제하지 않습니다.

getdesign.md 미리보기 링크

각 design_system 값에 대해 references/design-system-links.md의 https://getdesign.md/<slug> 목록 페이지를 참고할 수 있습니다. 사이트는 브랜드의 공식 규격이 아닌 독립 분석이며, 상세 분석은 목록에서 한 번 더 선택합니다. 시스템 링크 매핑표(저장소 시스템명 → getdesign.md slug)를 해당 파일에서 관리합니다.


체인 통합

[원고와 근거 확인] → 원문 대조·문장 검수 → moai-officer:doc-html-slide
                                                                            ↓ (export_pptx: true)
                                                                moai-officer:doc-pptx

이미지 필요 시 분기:

doc-html-slide → 현재 앱의 이미지 생성 도구 (기본)
           → 공식 Higgsfield 연결 (명시 요청 시)
           → 설치된 moai-media 스킬은 모델·프롬프트 세부 지침에 활용

design_system 적용은 design-system-library에서 자동 로드 — 별도 선행 스킬 호출 불필요.


사용 예시

예시 1: 사업계획서 슬라이드 (기본 claude 테마)

AI 슬라이드 스킬 스타트업 사업계획서 10장 슬라이드로 만들어줘. claude 테마로.

예시 2: 데이터 인포그래픽 슬라이드 + PPTX

3분기 매출 분석 슬라이드 HTML로 만들고, 편집 가능한 PPTX로도 저장해줘.

예시 3: 다크 테마 기술 발표

신규 API 아키텍처 기술 발표 15장, clickhouse 다크 테마로 슬라이드 HTML 만들어줘.

예시 4: 앱 기본 이미지 생성

제품 출시 슬라이드 만들어줘. 히어로 이미지는 기본 이미지 도구로 생성하고, notion 테마 적용.

예시 5: 테마 미리보기 후 선택

슬라이드 만들 건데, 디자인 토큰 후보들 getdesign.md 링크로 보여주고 내가 고를게.

하지 않는 것

  • 연속 스크롤 문서는 moai-officer:doc-html-report가 맡습니다 — 본 스킬은 슬라이드 시퀀스(16:9 페이지) 전용입니다.
  • 편집 가능 .pptx 생성 지침은 이 플러그인의 doc-pptx가 맡습니다.
  • NotebookLM 입력용 프롬프트는 moai-media:media-notebooklm-slide-prompt가 맡습니다.
  • React/Vue/webpack/vite 같은 빌드 단계·런타임 SPA 의존을 도입하지 않습니다 — file:// 즉시 오픈이 원칙입니다.
  • references/image-backend-policy.md의 이미지 생성 경로를 따릅니다.
  • 여러 파일로 나누지 않습니다 — HTML 산출물은 단일 .html 파일입니다.

참고 문서

설계 문서

샘플

이웃 스킬 (체이닝)

  • moai-officer:doc-design-library — 브랜드 토큰 참고
  • moai-officer:doc-pptx — 편집 가능 .pptx 생성 (체이닝)
  • moai-media:media-codex-image — 설치돼 있으면 정확한 OpenAI 이미지 모델 선택 지침
  • moai-media:media-higgsfield-image — 설치돼 있으면 Higgsfield 생성 지침
  • moai-media:media-gpt-image-prompt — 설치돼 있으면 이미지 프롬프트 지침
  • moai-coworker:ai-slop-reviewer · moai-writer:korean-humanize — 설치돼 있으면 보조 문장 검수

자체 검수

슬라이드 생성이 끝나면 산출된 단일 .html을 브라우저에서 열어 슬라이드 수·16:9 비율·네비게이션·?print-pdf 인쇄 모드·speaker notes·한국어 폰트 렌더·인포그래픽 SVG 정확도를 자체 검수하고, 이미지 백엔드 정책 준수(허용 백엔드만 사용)를 확인한 뒤 PASS/FAIL 결과를 보고합니다. PPTX 체이닝 시 doc-pptx QA(빈 플레이스홀더·overflow·색 대비 4.5:1) 결과를 통합 보고합니다. 문제가 있으면 자동 수정 후 재생성합니다.

한글 문서 작성자 (HWPX Writer)

개요

HWPX 문서의 작성·편집을 돕습니다. HWPX는 OWPML XML을 담은 ZIP 형식이지만, ZIP 안에 XML 조각 몇 개만 넣는 것으로 한컴에서 열리는 문서가 되지는 않습니다. 문서를 실제로 저장할 수 있는 호스트 기능이나 현재 설치된 HWPX 도구를 확인한 뒤 사용합니다. 기존 바이너리 .hwp 파일의 변환은 별도 변환 기능이 있어야 합니다.

트리거 키워드

한글, hwpx, 아래한글, 한컴, 공문서, 기안서, HWP 변환, 한글 문서 생성, HWPX 편집

워크플로우

1단계: 작업과 입력 확인

  • 새 HWPX, 기존 HWPX 수정, HWP→HWPX 변환, 텍스트 추출 중 작업 유형을 정합니다.
  • 원본 파일·사용자 서식·출력 경로를 확인하고 원본은 보존합니다.
  • 공문·기안문·품의서에는 실제 제출처 양식과 references/kr-official-forms.md를 대조합니다. 기관별 서식이 있으면 그 서식을 우선합니다.

2단계: 현재 호스트의 생성 경로 확인

  1. 이 플러그인의 kordoc MCP가 연결돼 있으면 새 문서는 generate_document, 기존 양식 채우기는 fill_form, 원본 수정은 patch_document의 실제 도구 설명을 확인하고 사용합니다. 생성 결과는 parse_document로 읽고 render_document로 화면 배치를 점검합니다. 렌더링은 한컴오피스의 실제 열림 검증을 대신하지 않습니다.
  2. MCP가 없으면 호스트가 HWPX 생성·편집·내보내기를 실제로 제공하는지 확인합니다.
  3. 실행 환경에 python-hwpx가 이미 있으면 현재 버전의 공식 API를 확인한 뒤 사용합니다. 이 스킬이 사용자의 앱에 라이브러리 설치를 요구하지 않습니다.
  4. 경로가 모두 없으면 유효한 HWPX 파일을 만들었다고 주장하지 않습니다. DOCX 대안은 사용자가 형식 변경을 선택한 경우에만 제공합니다.

바이너리 HWP를 HWPX로 바꾸는 작업은 현재 호스트의 변환 기능 또는 한컴의 변환 도구가 실제로 있을 때만 진행합니다. python-hwpx의 HWPX 읽기 기능을 HWP 변환 기능으로 간주하거나 확장자만 바꾸지 않습니다.

3단계: 파일 작성

kordoc MCP가 없는 상태에서 python-hwpx가 이미 설치된 경우, 공식 README의 새 문서 예시는 다음과 같습니다. 표·각주·기존 양식 편집은 현재 설치 버전의 API를 확인합니다.

from hwpx import HwpxDocument

doc = HwpxDocument.new()
doc.add_heading("문서 제목", level=1)
doc.add_paragraph("본문")
doc.save_to_path("output.hwpx")

직접 ZIP을 조립할 때는 mimetype 외에도 매니페스트(Contents/content.hpf), 헤더(Contents/header.xml), 본문과 서식 참조 등 OWPML 패키지 전체가 필요합니다. 이 스킬은 완전한 생성기를 포함하지 않으므로 부분 ZIP 예시로 .hwpx를 만들지 않습니다.

4단계: 출력 검증

  • 파일이 생겼는지 확인하고, ZIP 무결성·필수 항목·XML 파싱을 검사합니다.
  • 사용한 라이브러리나 호스트 기능으로 다시 열어 제목·본문·표·플레이스홀더를 원본과 대조합니다.
  • 가능하면 한컴오피스에서 열림·페이지·서체·표 배치를 확인합니다. 앱을 사용할 수 없으면 그 검증은 미실행이라고 보고합니다. ZIP 검사나 XML 파싱만으로 한컴 호환성을 PASS 처리하지 않습니다.
  • 변환 작업에서는 원본과 결과의 텍스트·표 개수·주요 서식을 비교합니다.

사용 예시

  • "공문서 양식으로 협조 요청 한글 파일을 만들어줘"
  • "기존 HWP 파일을 HWPX로 변환해줘"
  • "아래한글 기안서 형식으로 품의서를 작성해줘"
  • "HWPX 파일에서 텍스트를 추출해줘"
  • "한글 문서 내용이 올바른 OWPML 구조인지 검증해줘"

출력 형식과 한계

  • 생성 경로가 확인되고 검증된 경우에만 .hwpx를 제공합니다.
  • HWPX는 OWPML 기반 ZIP 문서입니다. 한컴의 형식 설명과 공개 문서 형식 안내를 참고합니다.
  • 한컴오피스 버전별 실제 열림·레이아웃은 테스트한 버전에 대해서만 보고합니다.
  • 사용자 환경에 한컴오피스가 없어도 python-hwpx가 있는 실행 환경에서는 HWPX 생성이 가능하지만, 화면 배치 검증은 별개입니다.
  • 사용한 서체가 수신자의 OS에 없을 수 있으므로 전달 전에 폰트·인쇄 결과를 확인합니다.

관련 스킬 / 자체 검수

한글 문서를 생성했다면 산출된 .hwpx 파일을 사용한 도구로 다시 열어 플레이스홀더 잔존·OWPML 구조·한글 인코딩 깨짐·표 깨짐을 검수합니다. 발견한 문제를 수정하고 다시 검사합니다. 한컴오피스의 실제 열림이나 화면 배치를 확인하지 못했다면 그 항목은 미실행으로 보고합니다.

  • moai-officer:doc-docx - DOCX(Word) 문서 생성
  • moai-officer:doc-pptx - 발표용 PPT 슬라이드 생성
  • moai-officer:doc-xlsx - 엑셀 데이터 시트 생성

기술 참조

한국어 문구 검수

배포 전 원본 자료와 대조해 이름·숫자·날짜·권리·의무·결재 문구를 확인합니다. 아래 스킬이 설치돼 있으면 문장 검수에 추가로 사용할 수 있습니다:

  1. moai-coworker:ai-slop-reviewer — 1차 일반 AI 슬롭 검수 (금지어, 구조 패턴, 리듬)
  2. moai-writer:korean-humanize — 2차 한국어 정밀 윤문 (40+ 패턴 SSOT, 의미 불변)

스킬 검수 결과만으로 공문서의 의미나 제출처 서식이 맞는다고 단정하지 않습니다. 두 스킬이 없더라도 직접 대조와 문서 검수는 수행합니다.

정형 서식 보호 — 이 스킬의 산출물은 정형 문서다. 슬롭 검수는 금지어 치환만 수행하고, 구조(개조식·항목 번호 체계·두문/본문/결문)는 재작성하지 않는다.

상세 레퍼런스

파일로드 조건
references/kr-official-forms.md공문·기안문·품의서 등 정형 문서 작성 시 참고. 현재 법령과 제출처 양식을 우선 확인
references/guide.mdHWPX 생성 전반의 상세 가이드가 필요할 때 (라이브러리 활용·문서 조립 절차)
references/owpml-spec.mdHWPX 편집 시 OWPML XML 네임스페이스·섹션 파일 구조 등 스펙 참조가 필요할 때
references/format-converter.md문서 형식 간 변환 경로와 검증 조건을 확인할 때
references/templates/base.mdHWPX 문서의 공통 서식 확인 항목이 필요할 때
references/templates/gonmun.md공문서(시행문) 생성 시 참고. 제출처 양식·현행 별지 서식 확인
references/templates/report.md보고서 HWPX 생성 시
references/templates/minutes.md회의록 HWPX 생성 시
references/templates/proposal.md제안서 HWPX 생성 시

노션 템플릿 키트 (Notion Template Kit)

개요

노션을 깔았지만 어떻게 구조를 짜야 할지 막막한 사람을 위해, 올인원 업무관리·목표·회고 대시보드의 데이터베이스 구조와 뷰를 설계한다. 화려한 디자인이 아니라 "매일 열어서 쓰게 되는" 최소 구조를 우선한다. 실제 페이지 생성이 필요하면 Notion 커넥터로 연결한다.

트리거 키워드

노션 템플릿, 올인원 업무관리, 노션 대시보드, 노션 목표 관리, 노션 회고 템플릿, 노션 구조, 업무 데이터베이스, 노션 세팅, 노션 할 일

워크플로우

1단계: 용도 정하기

먼저 이 노션이 무엇을 담을지 정한다. 한 페이지에 다 넣지 않는다.

용도핵심 데이터베이스
업무관리할 일·프로젝트·노트
목표관리목표·주간 행동·진척
회고·기록회고·업무일지·배운 점
올인원위를 한 대시보드에 링크로 묶기

→ 용도가 분명할수록 구조가 단순해진다. 처음엔 1~2개 DB로 시작한다.

2단계: 데이터베이스 속성 설계

각 DB에 들어갈 속성(필드)을 최소로 정한다.

  • 할 일 DB: 제목 · 상태(할 일/진행/완료) · 우선순위 · 마감일 · 프로젝트(관계형)
  • 목표 DB: 목표 · 기간(분기) · 핵심 결과 · 진척률
  • 회고 DB: 날짜 · 주기(주/월) · Keep/Problem/Try · 다음 행동
  • → 속성이 많을수록 안 쓰게 된다. "정렬·필터에 꼭 필요한 것"만 남긴다

3단계: 뷰(View) 구성

같은 데이터를 상황별로 다르게 보는 뷰를 만든다.

  • 오늘 뷰: 마감일=오늘 또는 상태=진행 필터
  • 이번 주 뷰: 주 단위 필터·정렬
  • 보드 뷰: 상태별 칸반(할 일→진행→완료)
  • 캘린더 뷰: 마감일 기준
  • → 입력은 한 번, 보기는 여러 방식. 뷰가 노션 활용의 핵심이다

4단계: 대시보드 묶기

자주 쓰는 뷰·링크를 첫 화면(홈)에 모은다.

  • 상단: 오늘 할 일·이번 주 목표(연결된 DB 뷰)
  • 중단: 진행 중 프로젝트, 최근 회고
  • 하단: 자주 쓰는 링크·메모
  • → 매일 여는 "홈"을 만들어 흩어짐을 막는다. productivity-goal·productivity-retro 산출물을 여기에 연결

5단계: 운영 규칙·실제 생성

  • 입력 루틴: 아침에 오늘 할 일 추가, 저녁에 회고 한 줄 → productivity-habit 연계
  • 주간 정리: 완료 항목 아카이브, 다음 주 준비
  • 실제 생성: 사용 중인 호스트에 Notion 커넥터가 연결되고 필요한 페이지·데이터베이스·뷰 작업을 지원하는지 확인한 뒤 실행한다. 지원하지 않는 작업은 생성 완료로 표시하지 않는다.
  • → 단, 설계가 먼저다. 빈 템플릿부터 만들지 말고 용도→속성→뷰 순으로 정한다

사용 예시

예시 1: "노션으로 올인원 업무관리 대시보드 만들고 싶어" → 할 일·프로젝트 DB 설계 → 오늘/이번 주/보드 뷰 → 홈 대시보드 구성안

예시 2: "목표랑 회고를 노션에서 같이 관리하고 싶어" → 목표 DB + 회고 DB 속성 설계 → 분기 목표↔주간 회고 연결 → 진척 뷰

예시 3: "노션 깔았는데 뭐부터 만들어야 할지 모르겠어" → 용도 1개로 좁히기 → 최소 DB 1개 + 뷰 2개 → 매일 여는 홈 한 페이지

산출물

  • 용도별 데이터베이스 구조
  • DB 속성(필드) 설계
  • 상황별 뷰 구성(오늘·주간·보드·캘린더)
  • 홈 대시보드 레이아웃
  • 입력·정리 운영 규칙

주의사항

  • 처음부터 화려하게 만들면 유지가 안 된다 — 최소 구조부터 키운다.
  • 속성·DB가 많을수록 입력 부담이 커진다. "꼭 필요한 것"만 둔다.
  • 실제 페이지 생성에는 연결된 Notion 커넥터의 해당 쓰기 기능과 대상 워크스페이스 권한이 필요하다. 미연결 시 구조 설계까지 제공한다.

관련 스킬

  • moai-coworker:productivity-goal: 목표·핵심 결과를 노션 DB로 관리
  • moai-coworker:productivity-retro: 회고 양식을 노션 회고 DB로 구조화
  • moai-coworker:productivity-habit: 습관 트래커를 노션 뷰로 시각화
  • moai-coworker:collab-productivity-report: 업무일지 DB를 주간보고 작성에 활용

이 스킬을 사용하지 말아야 할 때

  • 팀 협업 워크스페이스·권한 설계: 조직 단위 노션은 moai-coworker를 사용한다.
  • 노션 외 도구(엑셀·구글시트) 표 생성: 문서 산출물은 moai-coworker 계열로 보낸다.
  • 코드·DB 스키마 설계: 소프트웨어 데이터 모델은 moai-coworker/백엔드 도메인이 맞다.

출처

노션 업무관리·대시보드의 일반 설계 예시. 사용자 자료나 연결된 워크스페이스를 확인하지 않았다면 이를 근거로 특정 구조나 기존 페이지를 단정하지 않는다.

PDF 생성 (doc-pdf)

범위

입력 형식과 원하는 결과를 먼저 확인한다. HTML의 화면 디자인, 종이 인쇄 레이아웃, 편집 가능한 원본은 서로 다르다. PDF가 필요하면 실제 출력 기능을 사용하고 생성된 파일을 다시 검사한다.

경로 선택

  1. 호스트에 문서·브라우저의 PDF 내보내기 기능이 있으면 입력 형식과 지원 범위를 확인하고 사용한다.
  2. HTML 출력이고 실행 환경에 WeasyPrint가 이미 있으면 공식 사용법에 따라 렌더할 수 있다. CSS 지원과 결과는 브라우저 화면과 다를 수 있으므로 비교한다.
  3. 위 경로가 없으면 PDF 생성 완료를 주장하지 않는다. HTML 또는 원본 문서 대안은 사용자가 형식 변경을 선택한 경우에만 제공한다.

WeasyPrint를 사용할 때의 최소 예시는 다음과 같다. 입력 경로와 출력 경로는 실제 파일로 바꾼다. 외부 CSS·이미지·폰트가 있으면 상대경로와 네트워크 접근을 확인한다.

from pathlib import Path
from weasyprint import HTML

source = Path("input.html").resolve()
output = Path("output.pdf").resolve()
HTML(filename=str(source), base_url=source.parent.as_uri()).write_pdf(str(output))

Markdown·JSON·일반 텍스트는 먼저 제목·단락·표·이미지와 특수문자를 올바르게 이스케이프한 HTML 또는 호스트 문서로 구성한다. 이 스킬에는 자동 입력 감지기나 JSON→HTML 렌더러가 포함돼 있지 않다. 구조화 JSON은 실제 필드·자료 출처를 확인하고 문서 구조로 옮긴다.

글꼴과 플랫폼

assets/fonts/에는 라이선스와 안내문만 있으며 폰트 바이너리는 없다. 폰트 다운로드 스크립트도 없다. 번들 Noto Sans CJK가 있다고 가정하거나 CJK 글리프를 무조건 보장하지 않는다. 현재 호스트의 사용 가능한 글꼴을 확인하고 한국어·일본어·중국어·기호가 들어간 시험 문구로 결과를 눈으로 본다. 누락된 글자는 대체 글꼴 또는 접근 가능한 폰트 소스로 다시 출력한다.

WeasyPrint의 시스템 의존성은 OS마다 다르다. 공식 설치 안내를 확인하되, 비개발자 사용자의 컴퓨터에 Python 패키지·시스템 라이브러리 설치를 필수 절차로 요구하지 않는다. 현재 호스트에서 사용할 수 없는 경우 다른 실제 PDF 출력 경로를 확인한다.

검수와 보고

  • 출력 파일이 존재하고 PDF로 다시 열리는지 확인한다.
  • 제목·본문·표·이미지·페이지 수를 입력과 대조한다. 마크다운 표와 긴 단락은 페이지 경계에서 잘림이 없는지 확인한다.
  • CJK·기호·숫자·인용부호의 실제 화면 표시를 확인한다. PDF 텍스트 추출만으로 글리프 표시를 판정하지 않는다.
  • 원본 HTML과 비교할 때 화면과 인쇄의 차이, 외부 리소스 누락, 대체 글꼴을 기록한다.
  • 미실행 검사는 미실행으로 보고한다. 생성 성공만으로 디자인 보존이나 다른 OS의 동일 표시를 선언하지 않는다.

관련 스킬

  • moai-officer:doc-html-report: 보고서 HTML
  • moai-officer:doc-html-slide: 슬라이드 HTML
  • moai-officer:doc-docx: 편집 가능한 Word 문서

PPTX 발표자료 작성

입력 확인

청중, 발표 목적, 원고·데이터의 출처, 필요한 슬라이드 수와 화면 비율, 사용자 브랜드 요소를 확인한다. 조직의 색·로고·폰트가 있으면 이를 우선한다. 특정 AI 회사의 브랜드색을 일반 비즈니스 문서의 기본값으로 쓰지 않는다. 수치·고객 사례·팀 경력은 원본 근거가 없으면 만들지 않는다.

생성 경로

  1. 현재 호스트에 PPTX 생성·편집·내보내기 기능이 있는지 확인한다.
  2. 없다면 실행 환경에 PptxGenJS 같은 PPTX 도구가 이미 설치됐는지 확인한다. 아래 참고 코드는 설치된 환경에서만 사용한다. 비개발자 사용자의 컴퓨터에 npm 설치를 필수 절차로 요구하지 않는다.
  3. HTML·Markdown·NotebookLM 원고는 PPTX 파일과 다르다. 실제 PPTX 변환 기능을 확인하기 전에는 이 형식을 PPTX 산출물로 제시하지 않는다.
  4. 출력 경로가 없으면 현재 작성할 수 있는 원고·디자인 지침만 제공하고 파일 생성은 미실행으로 보고한다.

구성

  • 각 슬라이드의 주장 하나와 근거를 정한다. 표지·문제·해법·데이터·마무리 중 필요한 유형만 사용한다.
  • references/slide-archetypes.md는 와이어프레임 예시다. 정해진 장수·시퀀스를 강제하지 않는다.
  • references/curated-palettes.md와 references/typography-pairings.md는 참고 색·폰트 예시다. 조직 브랜드와 실제 발표 PC의 서체를 확인한다.
  • 차트에는 분모·기간·단위·출처를 표시한다. 값이 없는 경우 예시 수치를 채운 채로 전달하지 않는다.
  • 이미지·로고·인용은 사용 권한과 출처를 확인한다. ChatGPT 기본 이미지 생성 또는 사용자가 지정한 Higgsfield 경로를 사용하며, 어떤 경로로 만들었는지 기록한다.

출력과 검수

  1. PPTX를 실제로 저장하고 다시 열어 슬라이드 수, 텍스트, 표·차트 데이터, 그림·링크를 확인한다.
  2. 가능한 발표 앱에서 전체 슬라이드를 미리 보며 잘림, 겹침, 줄바꿈, 대체 폰트, 명도 대비를 확인한다. references/qa-checklist.md는 수동 검수 항목이다.
  3. 사용 가능한 경우 PDF 미리보기도 비교한다. PDF의 표시가 PPTX의 PowerPoint·Keynote 표시와 같다는 보장은 없다.
  4. 실행하지 않은 시각·앱·OS 검사는 미실행으로 표시한다. ZIP 구조 검사만으로 완성도를 PASS 처리하지 않는다.

참고 파일

파일쓰임
references/pptxgen-code-patterns.md설치된 PptxGenJS의 기본 작성 예시
references/qa-checklist.md원본·PPTX·화면 검수
references/curated-palettes.md사용자 브랜드가 없을 때 검토할 색상 예시
references/typography-pairings.md사용 가능한 서체 조합
references/slide-archetypes.md내용 유형별 레이아웃 예시
references/templates/minimal-business.md간결한 비즈니스 레이아웃 예시
references/guide.md디자인 시스템 설계 항목
references/report-generator.md근거 있는 보고서형 덱 구성

문서 읽기 (doc-reader)

범위

이 플러그인의 kordoc MCP를 우선 사용한다. 이 저장소의 .mcp.json에 서버가 등록돼 있지만, 현재 호스트에서 도구가 실제로 연결됐는지 확인한다. kordoc 원저작자 README는 지원 형식과 도구를 설명한다. 도구 수나 기능은 배포 버전에 따라 달라지므로 이 문서의 목록을 런타임 검증으로 대신하지 않는다.

절차

  1. 사용자가 제공한 파일의 경로·접근 권한과 읽기 목적을 확인한다. 원본을 수정하지 않는다.
  2. 확장자가 의심스럽거나 입력 형식이 불명확하면 detect_format으로 확인한다.
  3. 목적에 따라 현재 노출된 도구를 선택한다.
목적kordoc 도구
전체 내용parse_document
메타데이터parse_metadata
일부 페이지·표parse_pages·parse_table
문서 간 차이compare_documents
양식 필드parse_form
기존 양식 채우기fill_form
기존 HWPX/HWP 수정patch_document
새 HWPX 생성generate_document → moai-officer:doc-hwp 절차
문서 미리보기render_document
  1. 파싱된 텍스트·표와 원본의 주요 부분을 대조한다. 병합 셀, 그림 속 글자, 스캔 페이지, 각주, 숨김 텍스트는 빠질 수 있으므로 결과의 warnings를 읽고 사용자에게 알린다.
  2. 양식 채우기나 문서 수정은 쓰기 작업이다. 대상 필드·출력 경로를 확인하고 원본을 보존한다. 출력 파일을 다시 읽고 변경된 값·변경되지 않아야 할 서식을 대조한다.

OCR·보호 문서

이미지·스캔 문서는 도구가 OCR 옵션을 제공하는지 확인하고, 문자 인식 결과를 원본 화면과 대조한다. 모델 다운로드나 네트워크 접근이 필요할 수 있다. 암호·DRM 보호 문서는 권한 있는 파일과 실제 지원 기능만 처리한다. 잠금을 우회할 수 있다고 보장하지 않는다. 오류가 나오면 오류 코드와 처리하지 못한 범위를 보고한다.

결과 보고

  • 감지한 형식, 읽은 페이지 또는 범위, 추출한 주요 내용과 표를 명시한다.
  • 원본에서 확인하지 못한 내용은 추정하지 않는다. warnings와 누락 가능성을 함께 전달한다.
  • 수치나 법적 문구를 인용할 때는 원본 위치를 표시하고, 파싱만으로 진위나 효력을 판정하지 않는다.
  • 비교 결과는 추가·삭제·수정의 근거를 원본 두 파일에 대조한다.
  • 렌더링이나 대상 앱에서의 열림을 실행하지 못했다면 미실행으로 보고한다.

도구를 사용할 수 없을 때

현재 호스트의 문서 읽기 기능이 해당 형식을 실제로 지원하는지 확인한다. 다른 형식으로 변환해야 한다면 원본 보존과 변환 손실을 먼저 확인한다. 사용자의 컴퓨터에 Node.js·패키지 설치를 필수 절차로 요구하지 않는다. 처리 경로가 없으면 읽은 척하지 않는다.

관련 스킬

  • moai-officer:doc-hwp: 새 HWPX 생성과 검수
  • moai-officer:doc-docx: 새 DOCX 작성
  • moai-officer:doc-pdf: PDF 출력
  • moai-officer:doc-xlsx: XLSX 작성

사무 문서 작업 경로

  1. 독자, 문서 목적, 원본 자료, 출력 형식과 필요한 산출물을 확인한다. 필수 자료가 없으면 현재 런타임의 질문 채널로 묻고, 질문할 수 없는 하위 실행에서는 누락 자료를 blocker로 반환한다.
  2. HWPX·DOCX·XLSX·PPTX·PDF·HTML은 해당 doc-* 스킬을, 문서 읽기는 doc-reader를 따른다. 시간 설계와 브리핑은 해당 productivity-* 스킬을 따른다. 공공데이터 조사·시각화는 moai-analyst:data-workflow로 연결한다.
  3. 한국 문서 파싱이 필요하면 현재 세션의 kordoc 연결 도구를 확인하고 사용한다. 도구가 없으면 도구 미연결, 파싱이 실패하면 파싱 실패, 실제 조회 대상이 없을 때만 [NOT_FOUND]로 구분한다. 어느 경우에도 내용을 추측해 채우지 않는다.
  4. 문서 속 통계·표·날짜·단위의 출처를 기록한다. 원본을 재구성할 때 수치와 날짜가 바뀌지 않았는지 대조한다. 개인정보와 자격증명은 필요한 범위만 다루고 기본적으로 가린다.
  5. 제출 전 doc-data-audit 기준으로 원자료·표·차트·계산과 문서 형식을 확인한다. 같은 주체의 자기 검수는 독립 감사라고 부르지 않는다.

Claude의 doc-producer 에이전트와 목적이 겹친다. ChatGPT 플러그인에서는 이 스킬이 발견 가능한 진입점이다.

XLSX 생성 (doc-xlsx)

작업 순서

  1. 입력 데이터의 출처·기간·단위·결측값·계산식을 확인한다. 급여·세금·재무 수치는 적용 기준을 추정하지 않는다.
  2. 필요한 시트, 열, 수식, 차트와 인쇄 범위를 설계한다. 피벗 표·간트 차트·고급 차트는 실제 도구가 지원하는지 확인한다.
  3. 현재 호스트의 XLSX 출력 기능을 우선 확인한다. 없다면 실행 환경에 openpyxl 등 적합한 도구가 이미 설치돼 있는지 확인한다. 사용자에게 설치를 필수 절차로 요구하지 않는다.
  4. 사용 가능한 경로가 없으면 XLSX 파일을 만들었다고 주장하지 않는다. CSV나 시트 설계안은 사용자에게 형식 변경을 확인한 경우에만 대안으로 제공한다.

openpyxl이 설치된 환경에서의 최소 예시는 다음과 같다. 값과 수식은 입력 자료에 맞춰 바꾼다.

from openpyxl import Workbook, load_workbook

wb = Workbook()
ws = wb.active
ws.title = "요약"
ws.append(["항목", "금액"])
ws.append(["매출", 1200])
ws.append(["비용", 700])
ws["B4"] = "=B2-B3"
wb.save("output.xlsx")

check = load_workbook("output.xlsx", data_only=False)
assert check["요약"]["B4"].value == "=B2-B3"

서식과 계산

  • 숫자·통화·날짜 표시 형식은 문서의 통화와 지역 설정에 맞춘다. 원화·A4·파란 헤더를 모든 문서의 기본값으로 두지 않는다.
  • 0으로 나누는 식, 빈 셀, 통화 혼합, 퍼센트 분모를 검토한다.
  • openpyxl 공식 문서에 따르면 라이브러리는 수식 결과를 계산하지 않는다. 저장된 수식 문자열을 확인하고, 실제 계산 값은 Excel·호환 스프레드시트에서 재계산해 검증한다.
  • 차트의 데이터 범위·범례·단위와 조건부 서식의 경계값을 원본과 대조한다.
  • 셀·시트 보호는 파일 암호화와 다르다. 민감한 파일의 접근 제한을 시트 보호만으로 해결했다고 주장하지 않는다.

출력 검수

  • 파일을 다시 열어 시트명·행 수·열 수·값·수식·차트 정의를 확인한다.
  • 사용 가능한 스프레드시트 앱에서 수식 계산·차트 표시·인쇄 범위·한글 글꼴을 확인한다. 열지 못했으면 그 검사는 미실행으로 남긴다.
  • 개인정보는 필요한 범위만 포함하고 공유 대상·저장 위치를 확인한다.
  • 다른 OS나 앱에서 같은 레이아웃이 나온다고 단정하지 않는다.

관련 스킬

  • moai-officer:doc-reader: 기존 파일 읽기
  • moai-officer:doc-pdf: 검토용 PDF 출력
  • moai-analyst:data-visualizer: 차트 설계

업무 브리핑

범위 설정

업종, 관심 기업·키워드, 지역, 기준 시각과 기간을 확인한다. 사용자가 원하는 항목만 담는다. 실제 자료에 접근하지 못한 항목은 비워 두거나 미확인으로 표시한다. 사용자의 캘린더·할 일 목록은 연결된 자료를 확인한 경우에만 포함한다.

조사

  1. 뉴스는 기사 발행일과 사건 발생일을 구분한다. 원문 링크와 매체를 남긴다.
  2. 규제·정책은 해당 기관의 공고, 법령, 시행일, 적용 대상을 확인한다. 기사 해설만으로 법률 효과를 단정하지 않는다.
  3. 시장 지표는 공식 거래소·중앙은행·통계기관 등의 수치와 관측 시각·단위·전일 대비 기준을 확인한다. 실시간 수치 접근이 없으면 추정치를 넣지 않는다.
  4. 경쟁사 정보는 공개된 제품 공지·보도자료·채용 공고·공시 등을 사용한다. 사이트 변경이나 채용만으로 매출 부진·신사업 확정·고객 만족도를 추론하지 않는다. 신분을 숨긴 문의나 사칭으로 내부 정보를 얻도록 안내하지 않는다.
  5. 서로 다른 출처가 충돌하면 어느 수치·날짜가 다른지 표시하고 확인되지 않은 결론을 남긴다.

작성 형식

# [기준일·시간] [업종] 브리핑

## 핵심 변화
- [확인된 사실] — [원문 링크, 발행일 / 사건일]

## 우리 업무와의 관계
- [영향 가능성] — [근거와 전제]
- [확인할 질문]

## 지표
| 항목 | 값 | 기준 시각·단위 | 출처 |

## 다음 행동
- [ ] [근거가 있는 검토·확인 작업]

관련 자료가 없으면 섹션을 억지로 채우지 않는다. 시사점은 사실과 분리해 추론이라고 밝힌다. 예시 회사·주가·환율·정책·뉴스를 실제 오늘의 브리핑처럼 제시하지 않는다.

검수와 저장

  • 링크가 해당 주장에 직접 연결되는지, 날짜·숫자·단위·인용이 원문과 맞는지 다시 확인한다.
  • 유료·비공개 자료는 접근 권한과 인용 범위를 지킨다.
  • 파일 저장이나 정기 실행은 현재 호스트의 해당 기능과 사용자의 저장 위치·주기를 확인한 뒤 실행한다. 저장하지 않았다면 브리핑 파일이 있다고 주장하지 않는다.

관련 스킬

  • moai-consultant:consult-market: 시장 규모와 경쟁 구조 심층 분석
  • moai-accountant:finance-investor-relations: 투자자용 자료
  • moai-seller:commerce-morning-brief: 실제 매장 운영 데이터

시간 시스템 (Time System)

개요

현재 일정과 업무량을 확인하고 집중 시간·회의·휴식을 배치한다. 일정표만으로 야근이 줄어든다고 보장하지 않으며, 과도한 업무량이나 조직의 회의·마감 조건도 함께 살핀다.

트리거 키워드

시간관리, 블록식스, 덩어리 시간, 일정관리, 야근 줄이기, 우선순위, 주간 계획, 타임블로킹, 집중 시간, 하루 설계

워크플로우

1단계: 현재 시간 사용 진단

먼저 하루가 어디로 새는지 가볍게 파악한다.

  • 고정 시간: 출퇴근·회의·식사 등 이미 정해진 블록
  • 집중 가능 시간: 방해 없이 몰입할 수 있는 시간대(오전/오후/저녁)
  • 새는 시간: 알림·짧은 회의·맥락 전환으로 흩어지는 구간
  • → 가용 시간이 생각보다 적다는 사실부터 인정한다

2단계: 하루를 블록으로 나누기 (블록식스)

하루를 큰 덩어리 블록으로 나눠 "무엇을 언제 할지"를 미리 배치한다.

블록시간대(예시)성격
1블록이른 오전고집중 업무·중요한 일
2블록늦은 오전협업·회의
3블록점심·전환휴식·가벼운 정리
4블록이른 오후실행·처리 업무
5블록늦은 오후마무리·다음 날 준비
6블록저녁회복·개인 시간

→ 블록 수·시간대는 본인 리듬에 맞춰 조정한다. 핵심은 "빈 시간"이 아니라 "배치된 시간".

3단계: 덩어리 시간 확보

가장 중요한 일은 잘게 쪼개진 틈이 아니라 방해받지 않는 덩어리 시간에 넣는다.

  • 집중력이 가장 높은 시간대 1~2블록을 "회의 없는 집중 시간"으로 선점
  • 알림·메신저는 그 블록 동안 꺼두기
  • → 짧게 여러 번보다, 길게 한 번이 깊은 작업에 유리하다

4단계: 우선순위 매트릭스

해야 할 일을 중요도·긴급도로 나눠 블록에 배치한다.

  • 중요+긴급: 즉시(이른 블록에)
  • 중요+덜 긴급: 일정에 미리 예약(가장 자주 미뤄지는 영역 → 덩어리 시간에)
  • 덜 중요+긴급: 위임·자동화·짧게 처리
  • 덜 중요+덜 긴급: 줄이거나 제거
  • → "긴급한 일"에 밀려 "중요한 일"이 사라지지 않게 미리 자리를 잡는다

5단계: 주간 계획 + 야근 점검

  • 주간 계획: 주 시작 전 핵심 일 3개를 정하고 블록에 먼저 배치
  • 야근 원인 점검: 회의 과다·잦은 전환·과한 완벽주의 중 무엇이 시간을 먹는지 분석
  • 버퍼 확보: 실제 긴급 업무와 휴식 필요를 고려해 비워 둘 시간을 정함. 고정 비율을 강요하지 않음
  • → 한 주 종료 시 productivity-retro로 시간 사용을 가볍게 복기

사용 예시

예시 1: "맨날 야근하는데 시간을 어떻게 짜야 할지 모르겠어" → 시간 사용 진단 → 회의·전환 누수 도출 → 블록식스 배치 + 덩어리 집중 시간 확보안

예시 2: "할 일이 너무 많아서 우선순위를 못 정하겠어" → 중요·긴급 매트릭스로 분류 → 이번 주 핵심 3개 → 블록 배치 + 버릴 일 제안

예시 3: "오전에 집중이 잘 되는데 자꾸 회의에 뺏겨" → 오전 1~2블록을 회의 없는 집중 시간으로 선점 → 알림 차단 + 회의 오후 몰기

산출물

  • 시간 사용 진단(고정·집중·누수)
  • 블록식스 기반 하루 배치표
  • 덩어리 집중 시간 설계
  • 우선순위 매트릭스 분류
  • 주간 핵심 3개 + 버퍼 확보안

주의사항

  • 예상치 못한 업무와 휴식 시간을 확보한다. 필요한 여유는 직무와 실제 일정에 따라 다르다.
  • 블록 배치는 통제가 아니라 가이드다. 어긋나면 자책 말고 다음 블록부터 다시.
  • 누구에게나 맞는 정답 시간표는 없다 — 본인 집중 리듬에 맞춰 조정한다.

관련 스킬

  • moai-coworker:productivity-goal: 목표의 주간 행동을 시간 블록에 배치
  • moai-coworker:productivity-habit: 블록 안에 들어가는 반복 행동을 습관화
  • moai-coworker:personal-self-care: 과도한 업무량으로 인한 번아웃 점검·조정
  • moai-coworker:productivity-retro: 주간 시간 사용을 가볍게 복기

검수 체인 (서술형 산출물)

단계스킬목적
Post-검수원자료 직접 대조일정·업무량·시간 수치와 사용자가 제공한 제약을 확인 (필수)
Post-검수moai-coworker:ai-slop-reviewer설치돼 있으면 문장 검수에 추가 사용
Post-검수moai-writer:korean-humanize설치돼 있으면 한국어 문장 검수에 추가 사용. 사용했다면 원문 대조 수행

이 스킬을 사용하지 말아야 할 때

  • 팀 일정·프로젝트 타임라인·간트차트: 조직 일정 관리는 moai-coworker를 사용한다.
  • 장기 목표 자체 설계: 무엇을 할지(목표)가 아직 없다면 productivity-goal가 먼저다.
  • 외부 일정 예약·캘린더 연동 실행: 실제 캘린더 이벤트 생성은 별도 도구·커넥터로 진행한다.

출처

시간 블록과 중요도·긴급도 분류를 활용한 일반 설계 예시다. 사용자 일정이나 개인 자료를 확인하지 않았다면 기존 습관·업무량을 추정하지 않는다.

외부 앱과 MCP 연결 확인

사용자가 연결하려는 서비스와 앱을 먼저 확인한다. 이 스킬은 연결을 안내하며, 다른 플러그인이나 계정 권한이 이미 있다고 가정하지 않는다. moai-officer 플러그인 자체의 .mcp.json에는 kordoc만 선언돼 있다. 다른 기관 데이터 서버는 해당 플러그인을 설치하고 연결해야 한다.

공통 절차

  1. 현재 앱의 Plugins 또는 Apps/Connectors 화면에서 필요한 플러그인·앱이 보이는지 확인한다. 관리형 워크스페이스에서 사용이 막혀 있으면 관리자 설정을 확인한다.
  2. 서비스가 계정 연결을 요구하면 앱 화면에서 대상 계정과 요청 권한을 확인하고 인증한다. 플러그인 설치와 서비스 계정 인증은 별도 단계다. API 키·토큰을 채팅에 붙여 넣게 하지 않는다.
  3. 현재 대화에 실제로 노출된 도구 이름과 입력 형식을 읽는다. 목록에 없는 도구 이름이나 과거의 고정된 인자 형식으로 호출하지 않는다.
  4. 사용자의 자료 중 공개해도 되는 대상이나 무해한 읽기 호출 하나로 응답을 확인한다. 단순히 connected 표시만 보았으면 설정 표시 확인, 도구 목록만 보았으면 도구 노출 확인, 호출이 성공했을 때만 읽기 호출 확인이라고 적는다. 계정별 쓰기 권한과 실제 생성·게시 가능 여부는 각각 별도로 확인한다.
  5. 실패하면 앱·플러그인 설치, 워크스페이스 허용, 계정 선택, 서비스 권한, 도구 노출, 실제 호출 중 어느 단계인지 분리해 보고한다. 확인하지 못한 단계는 미확인으로 둔다.

서비스별 안내

서비스현재 앱에서 확인할 것읽기 검증 예
Google DrivePlugins 또는 Apps/Connectors의 Google Drive 연결, 계정과 허용 범위접근 권한이 있는 파일 또는 폴더 목록
NotionNotion 연결, 선택한 워크스페이스와 허용된 페이지접근 권한이 있는 페이지 읽기
Higgsfield공식 Higgsfield 플러그인 또는 MCP 연결, 계정 권한현재 노출된 읽기 전용 모델·계정 도구가 있으면 호출
kordocmoai-officer 설치와 kordoc 도구 노출사용자가 제공한 문서의 읽기·파싱

Higgsfield 생성 모델, 크레딧, 비용과 입력 형식은 현재 연결에서 확인한다. 모델 조회 도구가 없으면 계정 연결만으로 특정 모델을 쓸 수 있다고 약속하지 않는다. 이미지·영상 생성은 사용자가 요청한 모델과 비용을 확인한 뒤 해당 앱의 승인 절차를 따른다. 상세 생성 절차는 moai-media:media-higgsfield-image 또는 moai-media:media-higgsfield-video가 설치돼 있을 때 참고한다.

Google Drive와 Notion의 읽기·쓰기 가능 범위는 앱, 워크스페이스, 계정 권한에 따라 다르다. 읽기 호출 성공을 쓰기 권한의 증거로 쓰지 않는다.

다른 플러그인의 데이터 서버

데이터담당 플러그인확인할 것
KOSIS 통계·건축물대장·OpenDARTmoai-analyst해당 플러그인 설치, 각 서버 연결, 필요한 인증과 실제 조회
법령·판례moai-lawyerkorean-law 연결과 법제처 OC 인증, 현재 도구 스키마와 원문 조회
한국 특허·상표 및 해외 IPmoai-lawyermoai-mcp-ip 연결, 기관별 자격증명과 실제 인증·검색

위 서버가 moai-officer에 자동 등록된다고 설명하지 않는다. 각 플러그인의 README와 현재 매니페스트에서 서비스별 설정을 확인한다. 기관 공식 데이터와 이를 중계하는 제3자 MCP의 운영 주체를 구분한다. 해당 플러그인이 없거나 도구가 보이지 않으면 연결 완료로 표시하지 않는다.

앱 화면에서 해결하기

  • Claude Cowork: Customize의 Plugins와 Connectors에서 설치·연결 상태, 계정과 권한을 확인한다. 원격 사용자 지정 MCP는 Claude 계정의 커넥터 설정을 거치며, 외부에서 접근 가능한 서버가 필요하다.
  • ChatGPT Work: Plugins 또는 Apps에서 설치와 계정 연결 상태를 따로 확인한다. 관리형 워크스페이스에서는 관리자 허용 여부도 확인한다.
  • macOS·Windows: 두 OS 모두 현재 앱 화면에 표시된 절차를 우선한다. 로컬 실행기가 필요한 서버에서 실패하면 해당 플러그인의 설치 요구사항과 앱 오류를 확인한다. 경로 길이·한글 파일명·브라우저 캐시를 확인 전 원인으로 단정하지 않는다.
  • Linux: 사용 중인 앱·호스트가 해당 OS를 실제 지원하는지 공식 안내에서 먼저 확인한다. 지원 여부를 확인하지 않은 데스크톱 앱 실행을 보장하지 않는다.

CLAUDE.md에 Markdown 목록을 붙여 넣어도 새 슬래시 명령이 등록되지는 않는다. 존재하지 않는 --check 명령이나 임의의 셸 설치 절차를 사용자에게 안내하지 않는다. 현재 연결 상태를 이 절차대로 확인해 표로 보고한다.

결과 표

서비스·앱플러그인/앱 표시계정 인증도구 노출실제 읽기 호출남은 확인
사용자 요청 대상확인/미확인확인/미확인/불필요확인/미확인성공/실패/미실행단계와 조치

공식 앱 안내: Claude 플러그인 · Claude 커넥터 · ChatGPT 플러그인 · ChatGPT 연결 앱.

Agents 2

data-auditor — Read-Only Document / Data Audit Specialist

You are a skeptical, evidence-first auditor of office deliverables: reports, slide decks, spreadsheets, form documents, public-data research briefs, and data visualizations. You operate in a strictly read-only capacity — you inspect artifacts and report findings; you never fix them yourself.

Audit Stance

  • Treat every figure and claim in the audited artifact as suspect until you can trace or reproduce it.
  • Verify source citations: every public-data number must name a traceable source (KOSIS statistics table ID, DART receipt number, data.go.kr dataset, building-ledger query). A figure with no source, or a source that does not plausibly cover the figure, is a finding — never a silent pass.
  • Check chart/table-to-source consistency: numbers rendered in charts, SVG labels, and summary tables must match the underlying source data included with the artifact. Flag any value, unit, axis scale, or date range that diverges.
  • Recompute all arithmetic independently (sums, growth rates, percentages, averages, currency/unit conversions). Show your work in the report.
  • Check Korean document-format conventions: HWPX/공문서 관행 (제목-수신-본문-붙임 구조, 날짜·기안 표기), consistent numbering, complete 붙임 references, correct file extension for the claimed format.
  • Check internal consistency: numbers quoted in prose vs numbers in tables; slide headlines vs backing data; totals vs line items; dates vs stated reporting period.
  • Check for privacy leaks: unmasked 주민등록번호, phone numbers, personal addresses, or account numbers in any deliverable are critical findings.

Output (AUDIT_SCHEMA)

Return a structured report:

  • verdict: PASS | FAIL | PASS-WITH-WARNINGS
  • findings: array of {severity: critical|major|minor, location: file+line or section, claim, evidence, recommendation}
  • recomputed: table of every number you independently recomputed (input → your result → artifact's value → match/mismatch)
  • unverifiable: claims you could not verify with available evidence (these are gaps, not passes)

A single verified critical finding (chart-source mismatch, arithmetic error, value presented as parsed despite a recorded empty result, privacy leak) forces verdict: FAIL. An uncited public-data figure is not proven fabricated solely because the citation is absent. Record its truth as unverified; if it is a key figure still used in a deliverable for release, return verdict: FAIL for missing required attribution. Never issue PASS for an unverified figure.

Guardrails (HARD)

  • Never use Write or Edit — you have no write tools. You inspect and report only.
  • Never call MCP tools or mutate any external state; audit against the evidence bundled with the artifact.
  • Do not prompt the user (no AskUserQuestion). Missing context → structured blocker report to the orchestrator.
  • Absence of a failure signal is not evidence of correctness: anything you did not verify goes in unverifiable, never silently into PASS.

doc-producer — Korean Office Document Specialist

You are an office-document specialist for Korean office workers. You turn a user's goal (write report X, present findings Y, parse official document Z, set up a Notion kit) into concrete, evidence-based deliverables: HWPX/DOCX/XLSX/PPTX/PDF documents, single-file HTML reports and slide decks, parsed Korean official documents, and Notion template kits. You work primarily through the moai-officer plugin's doc-* and productivity-* document skills and the connected kordoc MCP server for Korean document parsing.

Agent Loop (apply to every task, not just the first)

Run this 7-step loop for each task until the goal is met, then respond with results:

  1. Understand Goal — Restate the user's goal in one sentence: deliverable type, audience, source document, output format. If a required input (source data/document, document purpose, target format) is missing, return a structured blocker report to the orchestrator instead of guessing. If the goal is public-data research / data visualization / dataset profiling rather than document production, hand off to the moai-analyst plugin's data-analyst agent. If the goal is lifestyle or productivity planning (event, travel, wellness, habit, retro), hand off to moai-coworker's general/office lifestyle skills.
  2. Reason / Plan — Break the goal into ordered steps. Identify which deliverables are needed (document, slide deck, parsed source, Notion kit) and what evidence or source each requires (source document parse, embedded figure, productivity routine).
  3. Select Skill — Match each step to a skill from THIS plugin's doc-* and productivity-* document skill set (e.g. doc-hwp, doc-docx, doc-xlsx, doc-pptx, doc-pdf, doc-html-report, doc-html-slide, doc-reader, doc-notion-template, productivity-time, productivity-briefing, setup-mcp-connector, doc-design-library). Invoke it via the Skill tool. Prefer an existing skill over improvising; fall back to WebSearch/WebFetch research only when no skill covers the step.
  4. Execute — Produce the deliverable following the selected skill's guidance. Query the kordoc MCP server when a step needs Korean document parsing (HWP/HWPX/PDF/XLSX/DOCX → Markdown). Write files where the user asked for files; otherwise return content in the response.
  5. Observe — Check the output against the skill's own quality bar and the user's stated constraints (document format conventions, Korean official-document style, chart readability, complete 붙임 references).
  6. Verify — For high-stakes output (figures quoted in a report, recomputed tables, public-data numbers embedded in a document), request an independent audit by the data-auditor agent. You are a subagent and cannot spawn agents yourself: return a blocker report to the orchestrator naming data-auditor, the artifact path(s), and the specific figures/claims to verify, then incorporate the audit findings on re-delegation.
  7. Update Context → Loop or Respond — Record what was produced and what remains. If steps remain, loop back to step 2. When the goal is met, respond with the deliverables, the sources behind key numbers, and any residual risks.

Guardrails (HARD)

  • Every figure embedded in a document MUST cite its source: a traceable statistic, a cited table, or the source document it was parsed from. A number without a source must be labeled as an estimate. (Public-data figures should be researched in moai-analyst first, then embedded.)
  • Never fabricate data. When a parse or lookup returns no result, report [NOT_FOUND] explicitly — never fill the gap with a plausible-looking value.
  • Never write credentials, API keys, or tokens into any file.
  • Mask personal data (주민등록번호, phone numbers, exact addresses of individuals, account numbers) in every generated document unless the user explicitly provides and requests them verbatim.
  • Preserve original figures when transforming documents (parse → rewrite, table → chart): the transformed output must not silently change any number, date, or unit.

Boundary

Do not prompt the user directly (no AskUserQuestion). Missing inputs → structured blocker report to the orchestrator.

MCP servers 1

Sponsors

Details

Marketplace
modu-ai/moai-cowork
Source
plugins/moai-officer
Category
문서·오피스

More from modu-ai/moai-cowork

All 18