Skip to main content

쿡북 홈

Cowork 쿡북

Claude Cowork와 moai 플러그인을 실제 업무에 어떻게 엮는지 시나리오 묶음으로 정리한 쿡북입니다.

사용 방식

핵심 원칙: 사용자가 짧은 한 줄 요청 → 시스템이 AskUserQuestion으로 맥락 수집 → 스킬 체이닝 자동 일괄 처리. 사용자가 매번 긴 옵션 프롬프트를 작성하지 않습니다.

한 줄이 산출물이 되기까지

고급 레스토랑에 앉은 것과 같습니다. 손님은 “오늘 해산물 코스로 부탁해"라는 한 줄만 말하면, 웨이터가 “알러지 있으세요? 매운 정도는?“처럼 필요한 질문만 골라 묻고, 그 답을 주방으로 넘깁니다. 주방은 재료 손질 → 조리 → 플레이팅을 차례로 진행해 완성된 요리를 내옵니다. 손님이 레시피를 외우거나 주방 순서를 직접 지시할 필요가 없습니다.

쿡북도 같은 구조로 돌아갑니다. AskUserQuestion이란 시스템이 사용자에게 맥락을 물어보는 구조화된 질문 상자입니다 — 선택지가 함께 나오는 작은 팝업이라고 생각하면 됩니다. 스킬 체이닝이란 여러 전문 스킬을 순서대로 이어 파이프라인(한 방향으로 흘러가는 작업 연결선)을 만드는 방식입니다. 사용자는 “블로그 글 써줘"라는 한 줄만 던지면, 시스템이 독자·분량·말투를 AskUserQuestion으로 묻고, 그 답을 받아 내용 생성 → 검수 → 파일 변환이 차례로 이어지며 최종 산출물이 완성됩니다.

핵심은 사용자가 매번 긴 옵션 프롬프트를 외워 쓰지 않아도 된다는 점입니다. 시스템이 필요한 순간에 필요한 질문만 골라 묻기 때문에, 초보자도 전문가처럼 정교한 산출물을 얻을 수 있습니다.

flowchart TD
    U["사용자 한 줄 요청
'해산물 코스로 부탁해'"] --> W{"AskUserQuestion
맥락 수집"} W -- "알러지? 매운 정도?" --> K["주방 — 스킬 체인
재료손질 → 조리 → 플레이팅"] K --> P["완성된 산출물
(파일 · 문서)"] style U fill:#fbf0dc,stroke:#c47b2a,color:#09110f style W fill:#eaeaea,stroke:#6e6e6e,color:#09110f style K fill:#e6f0ef,stroke:#144a46,color:#09110f style P fill:#d6ebe7,stroke:#1c7c70,stroke-width:2px,color:#09110f
flowchart TD
    A["1. 한 줄 자연어 요청"] --> B["2. AskUserQuestion"] --> C["3. 스킬 체이닝"] --> D["4. 산출물"]
    style A fill:#fbf0dc,stroke:#c47b2a
    style C fill:#e6f0ef,stroke:#144a46

➡️ 사용 패턴 가이드 (4가지 표준 패턴) — 단일 프롬프트 · 멀티턴 대화 · 배치 처리 · 스케줄 자동화

어디서 시작하나요?

  • 역할이 명확하면 → 실전 트랙 — 11개 트랙 + 부록 (문서·콘텐츠·광고·이커머스·마케팅·HR·운영·법무·재무·데이터·프로덕트)
  • 구체적 시나리오를 찾는다면 → 아래 쿡북 목록
  • 개념부터 익힌다면 → 스킬 체이닝 가이드

공통 포맷 (모든 쿡북 항목)

각 예제는 다음 구성으로 제공합니다.

  • 사용자 입력 — 한 줄 자연어 요청 (✅ 권장 패턴)
  • 시스템 인터뷰 — AskUserQuestion이 묻는 항목
  • 자동 체인 — 시스템이 호출하는 스킬 순서 (mermaid)
  • 산출물 — 최종 결과물 미리보기
  • 변형 시나리오 — 한 줄 요청 변경으로 다른 결과 얻기
  • 자주 겪는 이슈 — 실패 케이스와 우회법

같은 틀로 읽는 법

요리책의 레시피 한 페이지를 상상하면 됩니다. 각 쿡북 예제는 동일한 6단 레시피 틀을 따릅니다. 사용자 입력은 요리 주문(한 줄), 시스템 인터뷰는 웨이터의 확인 질문, 자동 체인은 조리 순서도, 산출물은 완성 사진, 변형 시나리오는 같은 레시피로 다른 맛 내는 팁, 자주 겪는 이슈는 “소금 너무 많이 넣었을 때 대처법” 같은 실패 대응서입니다.

매 예제마다 이 틀이 고정되어 있어, 한 번 익숙해지면 어떤 예제든 같은 자리에서 같은 정보를 찾을 수 있습니다. 산출물을 확인하고 싶으면 항상 네 번째 단락을 보면 되고, 실패했을 때 대처법이 필요하면 항상 마지막 단락을 보면 됩니다.

flowchart TD
    R["레시피 한 페이지
(모든 쿡북 예제 공통)"] R --> S1["① 사용자 입력
요리 주문 (한 줄)"] R --> S2["② 시스템 인터뷰
웨이터 확인 질문"] R --> S3["③ 자동 체인
조리 순서도"] R --> S4["④ 산출물
완성 사진"] R --> S5["⑤ 변형 시나리오
다른 맛 내는 팁"] R --> S6["⑥ 자주 겪는 이슈
실패 대응서"] style R fill:#fbf0dc,stroke:#c47b2a,color:#09110f style S1 fill:#eaeaea,stroke:#6e6e6e,color:#09110f style S2 fill:#eaeaea,stroke:#6e6e6e,color:#09110f style S3 fill:#e6f0ef,stroke:#144a46,color:#09110f style S4 fill:#d6ebe7,stroke:#1c7c70,color:#09110f style S5 fill:#eaeaea,stroke:#6e6e6e,color:#09110f style S6 fill:#eaeaea,stroke:#6e6e6e,color:#09110f

먼저 읽으면 좋은 글

예제 목록

공통 원칙

  • 텍스트 산출물은 무조건 ai-slop-reviewer로 마무리합니다. 보고서·블로그·이메일·자소서·계약서 수정안이 모두 해당합니다.
  • 숫자·차트·코드는 ai-slop-reviewer를 생략합니다. 재무제표 엑셀, 차트 HTML, 스크립트는 검수 대상이 아닙니다.
  • 포맷 변환은 moai-office에 위임합니다. 내용 생성 스킬은 초안만 만들고 docx-generator / xlsx-creator / pptx-designer / hwpx-writer가 실제 파일을 만듭니다.
  • Windows 사용자는 파일명을 짧게 유지합니다. MAX_PATH(260자) 제한 때문에 보고서.docx처럼 짧은 한글 이름을 권장합니다.

세 규칙이 지키는 것 — 맡은 일만 하게 하기

요리에 비유하면, 위 세 규칙은 모두 “맡은 일만 하게 하라"는 한 원칙에서 나옵니다.

첫째, 텍스트 산출물은 ai-slop-reviewer라는 맛보기 검수관을 반드시 거칩니다. AI가 쓴 글은 육수가 덜 우러난 듯한 기계적 어투가 남아 있어, 사람이 읽기 좋게 간을 다시 맞춰야 합니다. 보고서·블로그·이메일·자소서·계약서 수정안이 모두 이 단계를 거칩니다.

둋째, 숫자·차트·코드는 맛이 아니라 영양표 같은 것이라 검수할 어투가 없습니다. 재무제표나 차트에 “사람 냄새"를 넣을 필요가 없으므로 ai-slop-reviewer를 생략합니다.

셋째, 요리(내용 생성)와 플레이팅(포맷 변환)은 분업합니다. 내용 생성 스킬은 맛있는 요리 초안만 만들고, moai-officedocx-generator / xlsx-creator / pptx-designer / hwpx-writer가 그릇에 담아 실제 파일로 완성합니다. 한 명이 요리와 플레이팅을 동시에 하면 둘 다 흐트러집니다.

flowchart TD
    REQ["자연어 요청"] --> DEC{"무엇을 만드나?"}

    DEC -- "글 · 텍스트" --> TXT["내용 생성 스킬
(초안)"] TXT --> REV["ai-slop-reviewer
맛보기 검수 (간 맞추기)"] REV --> FMT["moai-office 포맷 변환
(그릇에 담기)"] DEC -- "숫자 · 차트 · 코드" --> NUM["데이터 생성 스킬"] NUM --> FMT2["moai-office 포맷 변환
(검수 생략)"] FMT --> OUT["최종 산출물"] FMT2 --> OUT style REQ fill:#eaeaea,stroke:#6e6e6e,color:#09110f style DEC fill:#fbf0dc,stroke:#c47b2a,color:#09110f style REV fill:#e6f0ef,stroke:#144a46,color:#09110f style FMT fill:#fbf0dc,stroke:#c47b2a,color:#09110f style FMT2 fill:#fbf0dc,stroke:#c47b2a,color:#09110f style OUT fill:#d6ebe7,stroke:#1c7c70,stroke-width:2px,color:#09110f
flowchart TD
    A["자연어 요청"] --> B{"스킬 라우터
매칭"} B --> C["텍스트 생성
스킬"] B --> D["포맷 변환
moai-office"] C --> E["ai-slop-reviewer
후처리"] E --> D D --> F["최종 산출물"] style A fill:#eaeaea,stroke:#6e6e6e,color:#09110f style F fill:#d6ebe7,stroke:#1c7c70,stroke-width:2px,color:#09110f

Sources