사용 패턴 가이드

Cowork-plugins의 모든 사용 사례는 하나의 공통 골격을 따릅니다. 사용자가 긴 프롬프트를 매번 작성하는 게 아니라, 짧은 한 줄로 의도만 전달하면 시스템이 필요한 맥락을 물어보고 스킬 체이닝으로 자동 일괄 처리합니다.

flowchart TD
    A["1. 한 줄 자연어 요청
(사용자)"] --> B["2. AskUserQuestion
(시스템이 필요한 맥락 수집)"]
    B --> C["3. 스킬 체이닝
(자동 일괄 처리)"]
    C --> D["4. 산출물
(DOCX·PPTX·HTML·이미지)"]
    style A fill:#fbf0dc,stroke:#c47b2a,color:#09110f
    style C fill:#e6f0ef,stroke:#144a46,color:#09110f
    style D fill:#f5dcd7,stroke:#c44a3a,color:#09110f

Warning

사용자가 매번 옵션·요구사항을 일일이 명시하는 것은 권장 사용법이 아닙니다. 그러면 시스템이 가진 자동 인터뷰 기능과 스킬 체이닝이 무력화됩니다.

> ./nda_inbox/ 폴더의 NDA PDF 12개를 분류·검토해줘.

  회사 정보:
  - 회사명: SmartFlow Inc.
  - 핵심 영업비밀: 고객 거래 데이터, 알고리즘 가중치, 고객사 명단

  요청:
  1. 각 NDA를 nda-triage로 분류 (상호/일방, 기간, 손해배상 캡, 준거법, 분쟁관할)
  2. contract-review로 조항별 검토, 트랙체인지 형식의 수정 제안
  3. legal-risk로 위험도(상/중/하) 평가 + 우선순위 부여
  4. 종합 위험 보고서를 docx로 만들어줘
     - 1페이지 경영진 요약 (위험도 분포 차트, Top 3 위험 NDA)
     - NDA별 상세 (1건당 1~2페이지)
     - 부록: 표준 NDA 템플릿 비교표
  5. 마지막에 ai-slop-reviewer로 어투 정리

  저장: 90_Output/nda-report/2026-Q2-nda-review.docx
  면책 문구: "본 보고서는 1차 검토 가이드이며 최종 법률자문은 변호사 검토를 거쳐야 합니다"를 자동 삽입

위 형식은 사용자가 시스템 내부 구조(스킬명·체인 순서·산출 옵션)를 미리 알고 있어야 가능합니다. 이는 cowork-plugins의 설계 의도와 정반대입니다.

> ./nda_inbox/ 폴더의 NDA 12개 위험도 검토해서 한 페이지로 정리해줘

위 한 줄 요청을 받으면 시스템이 자동으로 진행합니다:

sequenceDiagram
    participant U as 사용자
    participant S as Cowork
    participant Skills as 스킬 체인
    U->>S: NDA 12개 위험도 검토해줘
    S->>U: AskUserQuestion — 회사 정보·영업비밀·면책 문구·저장 경로?
    U->>S: SmartFlow Inc. / 고객 데이터·알고리즘·고객사 / (권장 면책 사용)
    S->>Skills: nda-triage → contract-review → legal-risk → docx-generator → ai-slop-reviewer
    Skills-->>U: 90_Output/nda-report/...docx (1페이지 요약 + 상세)

적용: 한 번의 자연어 요청으로 끝나는 작업. 가장 흔한 패턴.

골격:

flowchart TD
    A["사용자 한 줄"] --> B["AskUserQuestion
3~5개 질문"] --> C["스킬 체인 자동 실행"] --> D["산출물 1개"]

예시 1: 사업계획서

> AI 영어 회화 앱 사업계획서 만들어줘

시스템이 인터뷰: ① 단계(시드/A/B) ② 조달 목표 ③ 타깃 시장 ④ 형식(PPT/DOCX) ⑤ 저장 경로

체인: strategy-planner → docx-generator → ai-slop-reviewer

예시 2: 블로그 포스팅

> 네이버 블로그에 '프리랜서 3.3% 원천징수' 글 써줘

시스템이 인터뷰: ① 분량 ② 키워드 ③ 톤(친근/격식) ④ 발행 여부

체인: blog → ai-slop-reviewer → korean-spell-check → humanize-korean → (선택) WordPress 발행

적용: 시스템이 중간 산출물을 보여주고, 사용자가 검토·수정을 거치는 작업. 창의적 콘텐츠·전략에 적합.

골격:

flowchart TD
    A["사용자 한 줄"] --> B["1차 산출"]
    B --> C{"사용자 검토"}
    C -->|수정 요청| B
    C -->|확정| D["2차 체인"]
    D --> E["최종 산출물"]

예시: IR 덱

> 시리즈 A IR 덱 15장 만들고 싶어

시스템: 회사 개요·시장·솔루션·BM·재무·팀·로드맵 7대 슬라이드 스토리라인 초안 제시 → 사용자 검토

> Slide 4(BM)에 SaaS 매출 모델 추가하고, Slide 7(팀)에 자문단 1장 추가해줘

시스템: 스토리라인 수정 → 사용자 확정 → pptx-designer → ai-slop-reviewer 자동 실행

적용: 폴더 안의 다수 파일을 일괄 처리. 입력이 N개일 때.

골격:

flowchart TB
    A["폴더 입력 (N 파일)"] --> B["AskUserQuestion — 처리 옵션"]
    B --> C{"파일별 분기 처리"}
    C --> D1["파일 1 체인"]
    C --> D2["파일 2 체인"]
    C --> DN["파일 N 체인"]
    D1 --> E["통합 보고서 1개"]
    D2 --> E
    DN --> E

예시: NDA 12개 일괄 검토 (앞서 본 ✅ 사례)

> ./nda_inbox/ 폴더 NDA 12개 위험도 검토해줘

시스템 인터뷰: 회사 정보·영업비밀·보고서 형식·면책 문구

체인: 12개 PDF × nda-triage → contract-review → legal-risk → 통합 docx-generator → ai-slop-reviewer

적용: 반복적인 정기 업무. 주간 보고서·일일 브리핑 등.

골격:

flowchart TD
    A["사용자 한 줄
+ 주기 명시"] --> B["AskUserQuestion
데이터 소스·수신자·발송 시각"] --> C["Schedule 등록"]
    C --> D["매주/매일
자동 실행"]
    D --> E["스킬 체인"]
    E --> F["산출물 + 알림"]
    F --> D

예시: 주간 보고서 자동화

> 매주 금요일 오후 4시에 우리 팀 주간보고 만들어줘

시스템 인터뷰: ① 데이터 소스(Notion·Linear·Slack) ② 수신자 ③ 임원/팀 톤 ④ 슬랙 채널 자동 발행 여부

체인: weekly-report → docx-generator → ai-slop-reviewer → Slack 발송 (매주 자동 반복)

flowchart TD
    Start["작업 유형"] --> Q1{"입력이 폴더
다수 파일?"}
    Q1 -->|예| P3["패턴 3: 배치 처리"]
    Q1 -->|아니오| Q2{"반복 주기
있음?"}
    Q2 -->|예| P4["패턴 4: 스케줄 자동화"]
    Q2 -->|아니오| Q3{"중간 검토·수정
필요한가?"}
    Q3 -->|예| P2["패턴 2: 멀티턴 대화"]
    Q3 -->|아니오| P1["패턴 1: 단일 프롬프트"]
    style P1 fill:#fbf0dc,stroke:#c47b2a
    style P2 fill:#e6f0ef,stroke:#144a46
    style P3 fill:#f5dcd7,stroke:#c44a3a
    style P4 fill:#e6efeb,stroke:#3a7c5f

시스템이 합리적 기본값을 자동 선택합니다 (예: 사업계획서 분량 → 15장, 보고서 톤 → 격식체). 단, 민감 영역(회사 정보·고객 데이터·법률 면책)은 사용자 명시 확인을 강제합니다.

/stop 또는 자연어 “여기까지 멈춰줘” — 현재 단계 산출물까지만 저장하고 체인 중단.

매 작업 후 *.moai/log/<run_id>/chain.json에 호출된 스킬·순서·소요 시간이 기록됩니다.

프로젝트 메모리(.moai/project/profile.md)에 회사 정보·기본 설정을 한 번 저장하면 시스템이 자동 참조 — 다음부터 묻지 않습니다. 프로젝트·메모리 가이드 참조.

예. 예) 패턴 4 + 패턴 3: 매주 월요일 09:00 ./inbox/ 폴더 영업 메일 일괄 분류 (스케줄 + 배치). 시스템이 자동 조합합니다.

• 실전 트랙 — 역할별(문서·마케팅·이커머스·법무 등) 10개 트랙
• 쿡북 — 30+ 구체적 시나리오 (한 줄 요청 + 자동 체인)
• 플러그인 카탈로그 — 21 도메인 144 스킬 전체 목록
• 용어 사전 — 스킬·플러그인·체인·메모리·MCP 등 개념 30초 정리

• modu-ai/cowork-plugins README
• 핵심 사용 패턴 디자인: 사용자 인터뷰 + AskUserQuestion 자동화 + 스킬 체이닝 통합 (v2.8.0)