modu-ai avatar

moai-coworker

실무 범용 코어 AI 코워커 — 브랜드·제안서·보고·협상·프로세스 등 비즈니스 실무와 목표·습관·회고·여행·웰니스·행사기획을 돕습니다. 전문 영역은 해당 분야 플러그인으로 연결합니다. 이런 분께 추천: 1인 사업자·스타트업 운영자.

version
1.2.28
GitHub stars
316

Install

/plugin install moai-coworker@moai-cowork

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

Contents

Discovered from source

Skills 32

ai-diagnostic

기술·프로세스·사람·비즈니스 관점에서 문제를 살피는 진단 스킬입니다. 실제 병렬 실행은 현재 호스트가 지원하고 해당 작업에 필요할 때만 사용합니다.

개요

증상과 가능한 원인을 구분하고 확인 방법을 정하는 진단 틀을 제공합니다. 근본 원인은 로그·측정·당사자 확인 등으로 검증한 경우에만 확정합니다. 관련 자료가 없는 관점은 추정하지 않습니다.

핵심 기능

  • 다차원 진단: 문제와 관련된 기술, 프로세스, 사람, 비즈니스 관점 조사
  • 원인 검증: 필요한 경우 5 Whys, Fishbone Diagram 등의 기법 활용
  • 가설 기반 진단: 검증 가능한 가설 수립과 우선순위 부여
  • 실행 가능한 해결책: 근거 있는 우선순위와, 비용·효과 자료가 있을 때만 ROI 추정

트리거 키워드

  • 진단, diagnostic, 문제 분석, 트러블슈팅, 원인 분석
  • 근본 원인, 시스템 진단, 현황 점검, 문제 해결
  • 성능 저하, 오류 원인, 병목 파악, 이슈 분석

워크플로우

1단계: 문제 수집

증상과 컨텍스트를 체계적으로 수집합니다:

  • 증상 파악: 오류 메시지, 성능 지표, 사용자 불만
  • 영향도 파악: 영향받는 사용자 수, 비즈니스 영향, 긴급성
  • 타임라인: 문제 발생 시점, 변화 추이, 패턴
  • 환경 정보: 시스템 사양, 구성, 최근 변경사항

2단계: 가설 생성

증상을 바탕으로 검증 가능한 가설을 생성합니다:

  • 차원별 가설: 기술, 프로세스, 사람, 비즈니스 차원별 가능성
  • 우선순위 부여: 발생 가능성과 영향도 기반 정렬
  • 검증 방법 수립: 각 가설을 검증할 방법론 정의

3단계: 병렬 진단

관련된 차원을 조사합니다. 도구나 팀 자료에 접근할 수 없으면 확인할 항목으로 남깁니다:

차원 1: 기술 진단

  • 인프라: 서버, 네트워크, 데이터베이스, 서드파티 API
  • 코드: 버그, 성능 병목, 리소스 누수, 예외 처리
  • 아키텍처: 확장성, 가용성, 복잡도, 기술 부채
  • 보안: 취약점, 권한 관리, 데이터 보호

차원 2: 프로세스 진단

  • 워크플로우: 업무 프로세스, 승인 체계, 핸드오버
  • 자동화: 반복 작업 자동화 여부, CI/CD 파이프라인
  • 모니터링: 로그, 알림, 대응 절차
  • 문서화: Runbook, 장애 보고서, 지식 베이스

차원 3: 사람 진단

  • 역량: 기술 스택, 도메인 지식, 문제 해결 능력
  • 커뮤니케이션: 팀 협업, 정보 공유, 의사결정
  • 워크로드: 번아웃, 리소스 배분, 온콜 부담
  • 문화: 책임감, 학습 문화, 실패 허용

차원 4: 비즈니스 진단

  • KPI: 성과 지표, SLA, 목표 달성률
  • 비용: 인프라 비용, 개발 비용, 기회 비용
  • 고객: NPS, 이탈률, 불만 사항
  • 전략: 비즈니스 목표와 기술 목표 정렬성

4단계: 근본 원인 식별

필요한 기법으로 원인 가설을 구체화하고, 실제 자료로 반증·확인합니다:

  • 5 Whys: 원인을 더 묻되 반복 횟수만으로 근본 원인을 확정하지 않음
  • Fishbone Diagram: 원인을 카테고리별로 분류 (Man, Machine, Material, Method, Environment)
  • Iceberg Model: 수면 아래 잠재적 원인 탐색

5단계: 해결책 제안

근본 원인별 실행 가능한 해결책을 제시합니다:

  • 완화 조치: 현재 증상의 영향을 줄이는 방법
  • 원인 해결: 검증된 원인에 대한 수정 방법
  • 재발 예방: 관측·운영·검증 절차 개선
  • 우선순위: 영향, 긴급성, 실행 비용을 확인해 정렬

사용 예시

예시 1: 웹 서비스 응답 시간 저하 진단

증상:
- 지난 2주간 API 평균 응답 시간 200ms → 800ms로 악화
- 오후 2시~4시에 심각 (최대 3초)
- 사용자 불만 50건/일 접수

컨텍스트:
- 2주 전 신규 기능 배포 (검색 엔진 변경)
- AWS, RDS MySQL 사용
- 온콜 엔지니어 1명, 번아웃 위험

확인 가능한 사실: 응답 시간과 고객 문의가 늘었고, 검색 엔진 변경 시점과 겹친다.

가설과 확인 방법:

  • 검색 쿼리 증가: 배포 전후 쿼리 수·실행 계획·DB 지표 비교
  • 캐시 영향: 캐시 적중률과 검색 경로 로그 비교
  • 운영 영향: 해당 시간대의 요청량·알림·당직 기록 확인

조치 후보: 실제 지표에서 배포와 성능 저하의 인과관계를 확인한 뒤 롤백이나 쿼리 개선을 선택한다. 고객 이탈률, SLA 위반, 인력 부족은 별도 자료 없이는 판정하지 않는다.

예시 2: 스타트업 팀 생산성 저하 진단

증상:
- 분기별 기능 릴리스 5개 → 2개로 감소
- 스프린트 완료율 60% (이전 85%)
- 팀원 사기 저하, 퇴사 2명 발생

컨텍스트:
- 시리즈 A 투자 유치로 팀 10명 → 25명으로 급성장
- PO 3명, 각자 다른 우선순위
- 기술 부채 누적, 재택근무 전환

확인 가능한 사실: 출시 수와 완료율이 낮아졌고, 팀 규모·PO 수가 늘었다. 동시에 기술 부채와 재택 전환이 있었다.

가설과 확인 방법:

  • 우선순위 충돌: 스프린트 중 요구 변경 기록과 PO별 결정권 확인
  • 대기 시간 증가: 코드 리뷰·배포 대기 시간과 실패율 측정
  • 온보딩 영향: 입사 시점별 업무 시작 시간과 팀원 면담 확인

조치 후보: 우선순위 결정 방식과 병목 지표를 확인한 뒤 범위 조정·온보딩·배포 개선을 선택한다. 투자자 기대, 매출 목표, 채용 속도는 입력에 없으므로 결과로 단정하지 않는다.

출력 형식

진단 보고서는 다음 섹션들을 포함합니다:

필수 섹션

  1. 증상 요약: 관찰된 증상의 간결한 요약, 영향도, 시간적 패턴
  2. 가설 목록: 검증 가능한 가설 리스트, 우선순위, 검증 방법
  3. 차원별 진단 결과: 4차원 분석 결과, 발견된 이슈와 증거
  4. 원인 분석: 가설별 근거·반증·미확인 항목, 확인된 경우에만 근본 원인
  5. 해결책 우선순위: 영향·비용·선행 조건, 담당자가 정해졌다면 담당자
  6. 실행 계획: 우선순위와 확인 기준, 합의된 일정이 있다면 일정

선택적 섹션

  • 위험도 평가: 해결책 실행 리스크와 완화 방안
  • 대안 비교: 여러 해결책의 장단점 비교
  • 모니터링 계획: 성공 추적을 위한 지표와 알림

주의사항

진단 시 유의사항

  1. 증상과 원인의 구분: 관찰된 현상(증상)과 근본 원인을 명확히 구분
  2. 편견 방지: 확인 편향(Confirmation Bias)을 피하고 데이터에 기반
  3. 다차원 사고: 한 차원에만 집중하지 않고 4차원 모두 고려
  4. 검증 가능성: 가설은 반드시 검증 가능한 형태로 수립
  5. 우선순위: 모든 것을 한 번에 해결하려 하지 말고 영향력 순으로 접근

흔한 실수 피하기

  • 증상만 해결: 근본 원인을 해결하지 않고 임시 조치만 반복
  • 단일 차원 편중: 기술 문제만 보고 프로세스/사람/비즈니스 무시
  • 데이터 부족: 근거 없이 직관에만 의존한 진단
  • 너무 많은 가설: 실행 가능한 수준으로 가설을 한정하고 우선순위 부여
  • 실행 가능성 무시: 리소스와 역량을 고려하지 않은 이상적인 해결책 제안

관련 스킬

  • moai-workflow-spec: 문제의 구조적 분석이 필요한 경우
  • moai-workflow-project: 프로젝트 컨텍스트 이해가 필요한 경우
  • moai-foundation-thinking: 전략적 사고 프레임워크가 필요한 경우

후처리 체인 (진단 보고서·근본 원인 분석·해결책 서술 등 서술형 산출물)

진단 보고서의 서술형 본문은 관측값·가설·미확인 사항을 원문과 대조하고, 과장·번역투·모호한 표현을 직접 검수한다. 현재 앱에 아래 스킬이 노출돼 있으면 추가로 적용한다. 별도 플러그인이 없어도 진단 보고서를 완성한다.

  • moai-coworker:ai-slop-reviewer: 노출된 경우 AI 티 나는 표현·과장·상투구 추가 검수
  • moai-writer:korean-humanize: 별도 설치돼 노출된 경우 한국어 문장 추가 윤문. 수치·근거·미확인 표시는 유지

ai-prompting-basics — 비개발자용 AI 대화 가이드

Claude Cowork와 ChatGPT Work에서 공통으로 쓸 수 있는 요청 방법을 안내합니다. 앱마다 지원하는 기능과 버튼은 실제 화면에서 확인합니다.

핵심 원칙

  1. 목표를 구체적으로 — "도움말 만들어줘"보다 "처음 쓰는 사람이 앱에서 설치할 수 있도록 단계별 도움말을 써줘"라고 요청합니다.
  2. 필요한 맥락을 제공 — 대상 독자, 사용 상황, 제약과 이유를 알려 줍니다. 개인정보·비밀 자료는 제공 전에 공유 범위를 확인합니다.
  3. 실제 예시를 첨부 — 원하는 문체나 표가 있으면 짧은 예시를 줍니다. 예시 속 수치가 실제 자료인지도 구분합니다.
  4. 자료와 요청을 구분 — 긴 자료는 제목과 구분선을 붙여 제공하고, 어떤 자료를 근거로 삼을지 적습니다. XML 태그는 Claude에서 복잡한 자료를 구조화할 때 쓸 수 있는 선택지입니다.
  5. 출력 형식을 지정 — 문단, 표, 체크리스트 등 원하는 형식을 적습니다. 전문 자격이나 경력을 꾸며 주는 역할 설정은 근거가 되지 않습니다.
  6. 확인 기준을 적기 — 최신 정보가 필요하면 공식 출처와 기준일을 확인하게 하고, 확인하지 못한 내용은 추정이라고 표시하게 합니다.

비개발자 실전 치트키

이런 요청은이렇게 바꾸세요
"글 써줘""건강보험을 처음 알아보는 사람에게 제도 개요를 3문단으로 써줘. 현재 혜택은 공식 자료로 확인해줘"
"잘 만들어줘" (모호)원하는 형식의 예시 1개를 직접 보여주기
"~하지 마" (부정)원하는 형태를 구체적으로 적기. 금지 조건도 필요하면 함께 명시
"더 좋게" (평가어)구체 기준("초등 5학년이 이해 가능하게, 문장당 25자 이내")

자주 묻는 질문

Q: 답변이 너무 길어요 → 출력 형식 명시: "3문단, 문장당 25자 이내" 또는 "한 슬라이드당 핵심 1줄".

Q: 내 뉘앙스가 안 살아요 → 실제 문체 예시를 제공. "이런 톤으로: [예시]".

Q: 거짓말(할루시네이션)해요 → "모르면 모른다고 해. 추측하지 마" + 확인 가능한 출처 요청.

참고

AI 슬롭 검수 및 인간화 스킬

AI가 생성한 텍스트는 내용은 정확하지만, 종종 기계적이고 예측 가능한 패턴으로 가득 차 있습니다. 이 스킬은 그 패턴을 체계적으로 찾아내고, 독자가 사람의 목소리로 느낄 수 있도록 글을 재구성합니다.

개요

이 스킬은 사용자가 문체 검수를 요청하거나 다른 스킬이 현재 앱에 노출된 이 스킬로 서술형 본문의 검수를 맡길 때 사용합니다. 블로그, 뉴스레터, 카피, 사업계획서, 계약서, 제안서, 보고서, 이메일, 랜딩 카피, 사업보고, 특허 초안, 강의자료 원고 등에 적용할 수 있습니다.

코드, JSON/CSV 데이터, 차트·표, 숫자 리포트, 단순 조회 응답에는 적용하지 않습니다.

트리거 키워드

이 스킬이 현재 앱에 노출된 경우 다음 요청이나 작업 흐름에서 사용할 수 있습니다. 작성 직후 자동 호출을 보장하지 않습니다:

  1. 명시적 요청: "AI 슬롭 제거", "사람이 쓴 것처럼 수정", "AI 티 나는 부분 고쳐줘"
  2. 웹사이트/콘텐츠 제작 후 검수: 블로그 포스트, 랜딩 페이지, 카피라이팅, 뉴스레터의 서술형 본문
  3. 비즈니스 문서 제작 후 검수: 사업계획서, 제안서, 보고서, 이메일 초안의 서술형 본문
  4. AI 도구 출력물 후처리: Cowork, Claude, ChatGPT 등으로 생성한 텍스트의 검수 요청 시
  5. 품질 개선 요청: "너무 기계적인 느낌이야", "자연스럽게 다듬어줘"

워크플로우

1단계: AI 슬롭 패턴 진단

텍스트를 받으면 먼저 체크리스트를 기준으로 문제 패턴을 식별합니다.

🔴 금지어: 즉시 제거/교체

한국어 과용 표현:

  • ~에 대해 살펴보겠습니다 → 바로 본론으로
  • ~의 중요성은 아무리 강조해도 지나치지 않습니다 → 왜 중요한지 구체적으로
  • ~을 통해 알 수 있듯이 → 삭제하거나 직접 서술
  • 다음과 같습니다: + 목록 → 산문으로 통합하거나 진짜 필요할 때만 목록 사용
  • 이처럼 ~은 매우 중요한 의미를 가집니다 → 결론 부분의 공허한 마무리
  • 종합적인, 체계적인, 효율적인 (의미 없이 반복될 때)
  • 또한, 그러나, 따라서, 더불어, 한편 (문단마다 반복될 때)
  • ~라고 할 수 있습니다 → ~입니다 또는 구체적 서술로
  • ~를 기반으로 한 접근 방식 → 무슨 접근 방식인지 직접 설명
  • 핵심은 + 같은 말 반복

영어 과용 표현:

  • delve, leverage, utilize, harness, embark → 단순한 동사로 대체
  • pivotal, robust, seamless, cutting-edge, comprehensive → 구체적 묘사로
  • tapestry, landscape, realm (비유로 쓸 때), synergy, testament
  • "It's important to note that", "In today's ever-evolving world"
  • "In conclusion / In summary / In essence" (서두에 오는 결론)
  • "Not just X, but Y" 구조의 남용
  • "Certainly!" 로 시작하는 답변
🟡 구조적 AI 패턴

획일적인 문장 길이:

  • 문장 길이가 지나치게 획일적이면 독자가 읽기 편한지 검토합니다. 길이만으로 작성 주체를 판정하지 않습니다.

공식적인 단락 구조:

  • 모든 단락이 "주제문 → 설명 → 예시 → 소결론" 패턴을 따르고 있으면 AI 글입니다
  • 단락 길이와 구조에 변화를 줍니다

AI식 도입부:

  • "오늘날의 급변하는 세상에서...", "디지털 시대에는..." 류의 문장
  • "이 글에서는 X에 대해 알아보겠습니다" 형식

AI식 결말:

  • "지금까지 살펴본 바와 같이..." + 앞 내용 반복
  • 구체적 내용 없이 "더 나은 미래를 위해 노력해야 합니다" 류의 호소

과도한 목록화:

  • 산문으로 쓸 수 있는 내용을 모두 글머리 기호(•)로 나열
  • 3개 이상의 중첩 목록

수동태 남용:

  • "~이 확인되었습니다", "~가 제안됩니다", "~로 판단됩니다"
  • → 주체를 명확히 하고 능동태로
🔴 구조적 슬롭 S1 패턴 3종 (헤드라인·카피 필수 탐지)

마케팅 카피·슬라이드 헤드라인에서 반복되면 어색할 수 있는 구조 세 가지입니다. 문장 구조만으로 AI 작성 여부를 확정할 수 없고, 한 번 사용됐다는 이유만으로 삭제하지 않습니다. 장르·독자·원문의 의도를 보고 수정 여부를 결정합니다.

#패턴탐지 신호[나쁜 예]수정 방향
1대시 대비 헤드라인대시(em-dash —)로 문장을 분할해 대비를 만드는 "X — Y" 구조 (대시 대비 헤드라인)[나쁜 예] "복붙에서 위임으로 — 목표만 주면, 나머지는 에이전트가"대시 제거 후 한 문장으로 통합하거나 두 문장으로 분리
2조사·체언 종결 조각문문장이 조사(~은/에/로)나 체언(명사형)으로 끝나는 파편화된 조각문 (조사·체언 종결)[나쁜 예] "성공의 열쇠 — 자동화" (체언 종결 조각문)서술어를 포함한 완전한 문장으로 재작성
3"A에서 B로" 전환 공식"X에서 Y로" 전환 공식으로 도입/헤드라인을 여는 상투문[나쁜 예] "엑셀에서 노션으로, 일하는 방식이 바뀌었다" (전환 공식)전환 공식 대신 구체적 사례·근거로 시작

탐지 원본: plugins/moai-writer/skills/korean-humanize/references/ai-tell-taxonomy.md D카테고리("X에서 Y로" 변환 공식) + J카테고리(em-dash 남용). 본 게이트가 이 3종을 잡지 못하면 커머스/카피 스킬 체인(본 스킬만 호출)을 통과한 채 slop 카피가 배포됩니다.

2단계: 인간화 수정 전략

진단이 끝나면 아래 전략을 적용해서 텍스트를 다시 씁니다.

전략 1: 목소리 구체화
  • 글쓴이가 제공한 의견·판단·경험이 있으면 분명하게 드러냅니다.
  • "이 기능은 효율적입니다" → "어떤 작업이 어떻게 달라졌는지 확인할 자료가 필요합니다"
  • 사례·날짜·숫자는 원문이나 확인된 자료에 있을 때만 씁니다. 없으면 구체화를 위한 질문으로 남깁니다.
전략 2: 리듬 변화
  • 짧은 문장으로 강조점을 만드세요. 딱 한 줄만
  • 그 다음 문장에서 맥락을 채웁니다. 이렇게 하면 독자의 호흡이 자연스러워집니다
  • 길고 복잡한 문장은 두 개로 나누거나, 때로는 일부러 길게 두어서 설명이 풍부한 느낌을 줍니다
전략 3: 전환어 다이어트
  • "또한", "더불어", "한편" 등의 전환어가 연속으로 나오면 하나씩 삭제해보세요
  • 전환 없이 자연스럽게 이어지는지 확인합니다. 대부분은 이어집니다
  • 꼭 필요한 전환에만 씁니다. 그래야 전환어가 의미를 갖습니다
전략 4: 목록 → 산문 변환
  • 3개 이하의 항목은 산문으로: "A, B, C 세 가지가 핵심입니다"
  • 목록이 정말 필요한 경우: 실제로 비교하거나 순서가 중요한 정보
전략 5: 구체성 주입
  • "많은 사람들이" → 실제 조사 대상·표본·출처를 확인하거나 표현을 삭제
  • "상당한 개선" → 측정 자료가 있으면 수치와 기간을 표시하고, 없으면 효과를 단정하지 않음
  • "최근의 연구에 따르면" → 논문·발행일을 확인할 때만 구체적으로 인용
전략 6: 도입부 재작성
  • AI 글의 도입부는 거의 항상 버려야 합니다. 처음 1-2문장을 직접 새로 씁니다
  • 독자가 궁금할 만한 질문이나 의외의 사실로 시작합니다
  • 또는 결론을 먼저 던지는 역피라미드 방식도 효과적입니다
전략 7: 결말 재작성
  • 앞 내용을 단순 반복하지 않습니다
  • 다음 행동(CTA), 열린 질문, 혹은 독자에게 직접 던지는 한 마디로 마무리합니다

3단계: 수정 출력 형식

수정된 텍스트를 제공할 때는 다음 형식을 따릅니다:

### 🔍 진단 요약
발견된 패턴: (예: AI식 도입부, 수동태 남용, 금지어 12개, 획일적 문장 길이)
심각도: 낮음 / 보통 / 높음

### ✍️ 수정된 텍스트
(수정된 전체 텍스트)

### 📝 주요 변경사항
(중요한 수정 포인트를 3~5개 간략히 설명)

원본이 길 경우(500자 이상), 진단 요약과 주요 변경사항을 먼저 보여주고 수정된 전체 텍스트를 그 다음에 제공합니다.

사용 예시

예시 1: 제공된 사실만 보존

입력: "오늘날의 급변하는 비즈니스 환경에서 효율적인 팀 커뮤니케이션의 중요성은 아무리 강조해도 지나치지 않습니다. 정기 미팅, 역할 분담, 피드백이 필요합니다."

수정: "팀 소통을 개선하려면 정기 미팅의 목적을 정하고 담당 역할을 분명히 하며, 작업 결과에 대한 피드백을 주고받아야 합니다."

확인: 회의 시간을 줄였다거나 생산성이 높아졌다는 결과는 원문에 없으므로 추가하지 않습니다.

예시 2: 영어 문장

입력: "In today's rapidly evolving landscape, it is crucial to leverage cutting-edge technologies to streamline your workflow."

수정: "Choose tools that help with the work your team actually does."

확인: 사용한 앱의 개수, 비용, 테스트 결과는 제공되지 않았으므로 넣지 않습니다.

예시 3: 원인 추정과 관찰값 분리

입력: "2024년 고객 만족도가 전년 대비 15% 향상됐습니다. 제품 품질과 응대 속도가 주요 요인으로 판단됩니다."

수정: "2024년 고객 만족도는 전년보다 15% 높았습니다. 제품 품질과 응대 속도가 영향을 줬는지는 별도 자료로 확인해야 합니다."

확인: 불량률·응대 시간·증원 계획은 원문에 없으므로 만들지 않습니다.

출력 형식

이 스킬은 다음 구조로 결과를 출력합니다:

  1. 진단 요약: 발견된 AI 패턴 목록과 심각도(낮음/보통/높음)
  2. 수정된 텍스트: 원본의 의미를 유지하면서 인간적인 목소리로 재구성된 전체 텍스트
  3. 주요 변경사항: 3-5개 핵심 수정 포인트 설명

진단 요약은 수정 전 사용자에게 "어떤 패턴이 발견되었는지"를 빠르게 파악하게 합니다. 심각도가 '높음'인 경우 AI 패턴이 많아 수정 전후 차이가 클 것임을 시사합니다.

주의사항

✅ 의미 보존 원칙

  • 형태는 바꾸되 핵심 정보와 메시지는 반드시 보존합니다
  • 원문에 없는 사실·경험·수치·고유명사를 추가하지 않습니다. 숫자·날짜·계약 조건은 대조합니다.

✅ 톤 앤 매너 유지

  • 공식 문서, 보고서, 기술 문서는 격식이 필요합니다
  • 대상 독자와 목적에 맞는 톤을 유지합니다
  • 과도하게 구어체로 만들지 않습니다

✅ 문맥 기반 판단

  • 모든 AI 표현을 기계적으로 제거하지 않습니다
  • "활용", "중요합니다" 같은 표현도 문맥에 따라 자연스러울 수 있습니다
  • 패턴의 반복이 문제이지, 단어 자체가 나쁜 것은 아닙니다

✅ 사용자 의도 확인

  • 사용자가 유지하고 싶은 스타일 특성이 있다면 확인합니다
  • 예: "전문적인 톤은 유지할게요, AI 패턴만 제거해드릴까요?"

❌ 적용 제외 대상

이 스킬은 다음 경우에 적용하지 않습니다:

  • 코드 (프로그래밍 언어 소스)
  • JSON/CSV 데이터 (구조화된 데이터)
  • 차트·표 (시각화 자료)
  • 숫자 리포트 (통계, 지표)
  • 단순 조회 응답 (정보 제공)

관련 스킬

선행 스킬 (입력 생성)

  • moai-marketer:content-blog — 블로그 포스트 생성
  • moai-marketer:marketing-landing-page — 랜딩 페이지 카피라이팅
  • moai-marketer:content-newsletter — 뉴스레터 작성
  • moai-marketer:content-copywriting — 마케팅 카피 작성
  • moai-officer:doc-docx — DOCX 문서 생성
  • moai-officer:doc-pptx — PPTX 발표자료 생성

후속 스킬 (선택적)

  • moai-media:media-higgsfield-image — (선택) 블로그 발행 체인의 이미지 생성 단계

통합 워크플로우

이 스킬을 사용할 수 있는 작업 흐름의 예시는 다음과 같습니다. 연결된 플러그인이 현재 앱에 노출된 경우에만 해당 단계를 실행합니다:

블로그 발행:
  content-blog → ai-slop-reviewer → (선택) media-higgsfield-image

사업계획서(PPT):
  consult-strategy → doc-pptx → ai-slop-reviewer

제품 랜딩:
  content-copywriting → marketing-landing-page → ai-slop-reviewer

다른 스킬에서 이 검수를 호출하지 않더라도 해당 스킬은 자체 근거·문체 검수를 마치고 산출물을 낼 수 있습니다.

References

파일로드 조건
references/kr-pii-masking.md개인정보 마스킹 공유 규격 (이 스킬이 물리 소유). 입력에 주민등록번호·계좌·카드·연락처·주소 등이 포함된 산출물을 처리하는 모든 스킬(career·recruiter·cs·accountant·lawyer 라인)이 참조 — 마스킹 자릿수 규칙, 산출물 재출력 금지 원칙, 개인정보 보호법 국외 이전 고지 조건

Classification: Post-processing Skill (Text Output Quality)

브랜드 아이덴티티 (Brand Identity)

개요

브랜드의 전략 수립부터 네이밍, 언어 아이덴티티, 비주얼 아이덴티티, 가이드라인 문서까지 체계적으로 설계합니다.

신규 브랜드 아이덴티티 전체 설계, 기존 브랜드 리브랜딩/리뉴얼, 브랜드 네이밍 단독 개발, 슬로건/태그라인 개발, 톤앤매너 가이드 설계, 비주얼 아이덴티티 설계, 브랜드 가이드라인 문서 생성을 지원합니다.

책임 범위 (경계 계약)

본 스킬은 기업·제품 브랜드의 언어와 가이드 초안을 만듭니다. 개인·전문가 브랜드는 moai-marketer:marketing-personal-branding, 디자인 토큰·컴포넌트 체계는 moai-designer:design-brand-system으로 연결합니다. 실제 로고와 시각 자산 제작은 해당 디자인 스킬의 범위를 확인합니다.

트리거 키워드

브랜드 만들어줘, 브랜드 아이덴티티, 브랜드 네이밍, 이름 짓기, 슬로건, 태그라인, 톤앤매너, 브랜드 가이드라인, 로고 컨셉, CI 설계, 브랜드 전략, 브랜드 포지셔닝, 리브랜딩, 브랜드 리뉴얼, 기업 브랜딩, 브랜드 스토리, 브랜드 컬러, 브랜드 보이스

실전 브랜드 네이밍·아이덴티티 패턴 (한국 시장)

브랜드 이름과 슬로건은 기억·검색·확장 가능성을 함께 검토합니다. 광고비 절감 효과는 실제 캠페인 자료가 있을 때만 평가합니다.

6개 핵심 패턴

① 광고비 줄이는 네이밍 5원칙 (한국 가게·회사)

원칙안 좋은 예좋은 예
검색 친화일반적인 이름은 동명이 많을 수 있음후보별 실제 검색 결과 확인
발음 용이대상 고객에게 발음이 어려운 이름후보를 소리 내어 읽고 사용자 반응 확인
표기 일관"E-mart / 이마트" 혼용"카카오" 일관
상표 조사동일·유사 상표 미조사KIPRIS와 전문가 검토로 출원 위험 확인
확장 가능성"OO 김밥집" → 김밥만"OO" → 카테고리 확장 가능

한국 특화 함정: 외래어 표기법 미준수("커피숖" X), 동음이의어 (특히 욕설 연상), 한자 변환 시 의미 변질.

② 슬로건·매니페스토·톤앤매너 구분

구분길이사용 채널한국 사례
슬로건10자 이내TVCF·옥외·SNS"방을 구할 땐 직방" / "금융을 쉽고 편하게 토스"
태그라인5-15자로고 하단·서명"오늘은 무엇이든 가능합니다"
매니페스토200-500자About·홈·브랜드북회사 신념 선언문
톤앤매너가이드라인모든 콘텐츠어조·금기어·필수어 룰북

③ 한국 시장 브랜드 컨텍스트 7요소 (작업 전 필수)

작업 시작 전 다음 항목 수집:

  • 사업 영역 (필수)
  • 타깃 고객 (연령·성별·라이프스타일·핵심 니즈)
  • 경쟁 브랜드 2-3개 (벤치마크)
  • 브랜드 방향 (이미지 키워드 3개)
  • 기존 확정 요소 (이미 정해진 이름·컬러·로고)
  • 사업 단계 (스타트업·중기·대기업)
  • 예산·인력 (네이밍만 vs 풀 패키지)

④ 네이밍 SMILE 평가 5축

축평가
Simple짧고 단순한가
Meaningful의미가 명확한가
Interesting호기심·기억을 자극하는가
Legal상표·도메인 충돌 없는가
Endurance5-10년 후에도 유효한가

각 항목은 비교 메모로 사용합니다. 후보 수와 추천 수는 사용자 요청에 맞추며, 상표·도메인 결과를 확인하지 못하면 법적 가용성 점수를 확정하지 않습니다.

⑤ 카테고리별 톤앤매너 매트릭스 (한국)

카테고리톤한국 사례
식품·F&B친근·정겨움·푸근함본죽·삼립·이춘무 메밀국수
패션·뷰티트렌디·세련·자유로움무신사·올리브영·스타일난다
IT·SaaS명료·전문·간결토스·당근마켓·노션
교육신뢰·따뜻·격려콴다·산타토익·해커스
B2B격식·정확·전문NHN·삼정 KPMG·삼성 SDS
라이프스타일진정성·차분마켓컬리·오늘의집

카테고리 톤과 다른 방향 = 의도적 차별화 시그널 (예: 토스가 핀테크의 격식을 깸).

⑥ 작은 범위로 시작하는 브랜딩 (초기 스타트업)

  1. 포지셔닝 한 줄 확정: "OO하는 OO" 공식 (방 구할 땐 직방 / 금융을 쉽고 편하게 토스)
  2. 인스타·블로그·X 무료 채널 일관 운영: 톤·시각 동일
  3. 고객 피드백 즉시 반영: 페르소나 가설 → 검증 사이클
  4. 확인 가능한 채널 선택: 운영 비용과 실제 고객 접점을 확인하고, 후기·언론 노출을 보장하지 않음
  5. 체화된 브랜드 표현: 창업자 본인이 SNS·인터뷰로 직접 발화

한국 사업자 등록 시 추가 체크리스트

  • 키프리스 상표 검색 (출원·등록 양쪽)
  • 도메인 .com / .kr / .co.kr 확보
  • 카카오톡 채널 ID 사용 가능 여부
  • 인스타·X·유튜브 핸들 동일 확보
  • 비속어·연관 검색어 (네이버·구글) 점검
  • 다른 언어 (영어·중국어·일본어) 발음 시 문제 없는지

이름을 확정하기 전에 검색 결과와 상표·도메인 현황을 확인합니다. 간이 검색 결과는 상표 등록 가능성의 확정 판정이 아닙니다.

워크플로우

사전 수집: 브랜드 컨텍스트 체크리스트

작업 시작 전 다음 항목을 확인합니다. 필수 항목이 누락되면 3가지 방향을 제안하여 선택을 유도합니다.

항목필수설명
사업 영역필수제품/서비스 종류, 업종
타깃 고객권장연령, 성별, 라이프스타일, 핵심 니즈
경쟁 브랜드권장벤치마크할 브랜드 2-3개
브랜드 방향권장원하는 이미지 키워드
기존 확정 요소선택이미 정해진 브랜드명, 컬러, 로고 등

1단계: 시장 분석 및 경쟁사 벤치마킹

접근 가능한 현재 자료로 시장과 관련 브랜드를 살펴봅니다. 자료가 없으면 시장 현황이나 경쟁사 약점을 추정으로 표시합니다.

2단계: 브랜드 전략

포지셔닝맵 설계, 타깃 페르소나 개발, 아키타입 선택, 브랜드 에센스(미션, 비전, 핵심 가치) 정의를 수행합니다.

3단계: 네이밍

사용자가 원하는 범위의 후보를 생성하고 비교 기준을 명시합니다. 도메인·상표는 실제 조회한 범위와 기준일을 적으며, 조회하지 못했다면 미확인으로 표시합니다.

4단계: 언어 아이덴티티

슬로건/태그라인 개발(각 5개 이상), 브랜드 스토리 작성(300자/500자/1000자 버전), 톤앤매너 가이드 설계를 수행합니다.

5단계: 비주얼 아이덴티티

색상·타이포그래피·로고 방향을 제안합니다. 실제 색상 쌍의 대비율을 계산한 경우에만 WCAG 기준 충족을 주장합니다.

6단계: 브랜드 가이드라인 문서 생성

1-5단계 산출물을 통합하고 채널별 적용 가이드, 브랜드 용어집을 포함한 가이드라인 문서를 생성합니다.

사용 예시

요청실행 범위
"친환경 생활용품 브랜드 만들어줘. 2030 여성 타깃, 프리미엄"풀 파이프라인 (1-6단계 전체)
"펫 케어 스타트업 브랜드 네이밍해줘"1-3단계 (전략+네이밍)
"브랜드명은 '그리너리'로 정했어. 슬로건이랑 톤앤매너 만들어줘"4단계 (언어 아이덴티티)
"프랜차이즈 카페 브랜드 리뉴얼 해줘. 기존명 '모닝빈'"풀 파이프라인 (기존 요소 반영)
"테크 스타트업 비주얼 아이덴티티 설계해줘"2+5단계 (전략+비주얼)
"패션 브랜드 가이드라인 문서로 정리해줘"6단계 (가이드라인 생성)

출력 형식

사용자가 파일을 원하고 현재 호스트에서 쓰기가 가능하면 합의한 위치에 마크다운으로 저장합니다. 그 외에는 대화에서 초안을 제공합니다.

파일내용
01_brand_strategy.md시장 분석, 포지셔닝맵, 페르소나, 아키타입, 에센스
02_naming_candidates.md네이밍 후보 15개+, SMILE 평가, TOP 3 추천
03_verbal_identity.md슬로건, 태그라인, 스토리, 톤앤매너
04_visual_identity.md색상 시스템, 타이포, 로고 컨셉
05_brand_guideline.md통합 가이드라인, 채널별 적용, 용어집

주의사항

  • 후보 수·언어·평가 방식은 실제 요청에 맞춥니다
  • 아키타입과 색상 비율은 선택적 아이디어 도구이며 검증된 효과나 법칙으로 제시하지 않습니다
  • WCAG 충족은 실제 사용되는 텍스트·배경 및 UI 색상 쌍을 계산한 경우에만 표시합니다
  • 실제 로고 파일(.ai, .svg) 제작, 인쇄물 시안, 상표 출원 대행은 이 스킬의 범위가 아닙니다
  • 도메인/상표 확인이 불가능한 경우 "[확인 필요]"로 표시하고 사용자에게 직접 확인을 권고합니다

후처리 (필수 체인)

슬로건·태그라인·브랜드 스토리·매니페스토·톤앤매너 가이드 등 텍스트 산출물은 발행 전에 이름·주장·고유명사·표현의 일관성과 원자료에 없는 사실이 추가되지 않았는지 직접 검수합니다. 색상 시스템·SMILE 평가표 등 표·수치 산출물은 산문 윤문 대상이 아닙니다.

추가 검수: 현재 앱에 노출된 경우 moai-coworker:ai-slop-reviewer를 사용하고, moai-writer:korean-humanize가 별도 설치돼 노출된 경우에만 윤문을 요청합니다. 두 스킬이 없어도 자체 검수 후 초안을 완성합니다.

관련 스킬

스킬사용 시점
moai-marketer:marketing-personal-branding개인 브랜딩, 퍼스널 브랜딩
moai-marketer:marketing-campaign-planner광고 캠페인 기획, 미디어 플래닝
moai-marketer:content-sns-contentSNS 콘텐츠 제작
moai-coworker:ai-slop-reviewer노출된 경우 브랜드 텍스트의 AI 패턴 추가 검수
moai-writer:korean-humanize별도 설치돼 노출된 경우 한국어 문장 추가 윤문
moai-designer:design-system-library디자인 시스템/컴포넌트 구축

References

파일로드 조건
references/brand-identity/naming-methodology.md브랜드 네이밍 개발 시 (12가지 기법·SMILE 정량 평가·한국어 음운론 분석·도메인/상표 사전검증)
references/brand-identity/archetype-framework.md브랜드 성격·톤앤보이스 설계 시 (융 12 아키타입 기반, 한국 브랜드 예시)
references/brand-identity/color-psychology.md브랜드 컬러 시스템 설계 시 (색상별 심리 반응·한국 문화 색상 의미·팔레트·접근성 기준)
references/brand-identity/brand-guide-template.md1-5단계 산출물을 통합 가이드라인 문서로 정리하는 6단계에서 (fill-in-the-blank 템플릿)

갈등·소통빌런 대응 (Conflict Handler)

개요

직장 스트레스의 큰 부분은 일이 아니라 사람이다. 그런데 까다로운 동료를 욕한다고 상황은 바뀌지 않는다. 이 스킬은 갈등을 인격 대 인격의 싸움이 아니라 유형·행동·구조의 문제로 다시 보게 한다. 상대 유형을 진단하고, 감정을 사안에서 떼어내고, 정중하지만 분명하게 선을 긋는 법을 설계한다. 이기는 게 아니라 덜 소모되는 게 목표다.

트리거 키워드

갈등, 소통빌런, 까다로운 동료, 떠넘기는 동료, 거절, 거절하는 법, 직장 인간관계, 마이크로매니징, 갈등 대응, 관계 스트레스, 거리 두기, 선 긋기

워크플로우

1단계: 상황 진단 (사람 vs 구조)

먼저 이게 사람 문제인지 구조 문제인지 가른다.

  • 구조 문제: 역할·책임이 불명확해 누구라도 부딪힐 상황 → 요청 구조·R&R을 바꿔야 함
  • 행동 문제: 특정인의 반복 행동(떠넘김·말 끊기·뒷말) → 행동 단위 대응
  • 일회성 vs 반복: 한 번의 상황도 심각도와 안전을 살피고, 반복 행동은 기록과 함께 다룬다

→ "저 사람은 원래 그래"로 끝내지 말고, 무엇을 바꿀 수 있는지부터 본다.

2단계: 빌런 유형별 대응 전략

자주 마주치는 유형과 대응 원칙이다(낙인이 아니라 행동 기준).

유형특징대응
떠넘기는 사람자기 일을 슬쩍 넘김요청을 문서·메신저로 명확히. 범위·기한을 되묻기
말 끊는 사람발언 독점·끼어듦"끝까지 듣고 답할게요"로 차분히 되찾기
세부 확인이 많은 상사확인 요청이 잦음보고 빈도와 자율 범위를 합의하고 부담을 확인(collab-feedback-loop)
뒷말·정치형앞뒤가 다름중요한 합의는 기록으로 남기기. 감정 동조 사절
늘 부정적인 사람모든 안에 반대"그럼 대안은요?"로 책임을 되돌리기

3단계: 감정과 사안 분리

갈등에서 망가지는 건 보통 사안이 아니라 감정이다.

  • 나-전달법(I-message): "당신이 틀렸어요"가 아니라 "저는 이 부분이 막혀서 곤란해요"
  • 사람 → 행동 치환: "무책임하다"(인격) 대신 "이 일이 두 번 누락됐어요"(행동)
  • 즉답 금지: 화날 때 바로 대응하지 말고 한 박자 — "정리해서 다시 얘기할게요"
  • 목표 재확인: 이 대화의 목적이 "이기기"인지 "문제 풀기"인지 스스로 점검

4단계: 정중한 거절·선 긋기

다 받아주면 다 떠안는다. 거절은 관계를 끊는 게 아니라 지속 가능하게 만든다.

  1. 공감 + 거절 + 대안 3단: "도와드리고 싶은데(공감), 지금 A가 마감이라 어려워요(거절). 대신 ○○는 가능해요(대안)"
  2. 사람이 아니라 상황 탓으로: "당신이 싫어서"가 아니라 "지금 여건상"
  3. 변명 길게 늘이지 않기: 거절 이유는 한 줄. 길어지면 협상 여지로 보인다
  4. 기록으로 남기기: 떠넘김·구두 약속은 메신저로 확인해 책임 소재를 분명히

5단계: 관계 거리 조정

모든 동료와 친할 필요는 없다. 거리만 잘 둬도 충돌이 준다.

  • 에너지 보호: 소모적인 사람과는 업무 접점만, 사적 영역은 분리
  • 에스컬레이션 기준: 반복·심각한 문제는 혼자 끌어안지 말고 상사·인사 채널로
  • 나의 기여 점검: 갈등이 반복되면 내 패턴(과한 수용·모호한 거절)도 함께 본다

사용 예시

예시 1: "자기 일을 자꾸 나한테 떠넘기는 동료가 있는데 어떻게 대응하지?" → 구조/행동 진단 → 요청을 문서화하는 응대 멘트 → 공감+거절+대안 3단 스크립트

예시 2: "팀장이 사사건건 간섭해서 숨이 막혀" → 확인 요청의 내용과 빈도 파악 → 보고 방식·자율 범위 합의 대화 설계

예시 3: "부탁을 거절 못 해서 일이 계속 쌓여" → 거절 3단 템플릿 → 한 줄 사유·상황 탓 전환 → 거절 후 관계 유지 멘트

산출물

  • 상황 진단(구조/행동·일회성/반복)
  • 빌런 유형별 대응 전략표
  • 나-전달법·감정 분리 스크립트
  • 정중한 거절 3단(공감·거절·대안) 템플릿
  • 에스컬레이션 기준 + 거리 두기 가이드

주의사항

  • 유형 분류는 대응을 돕는 도구지 사람에게 붙이는 낙인이 아니다. 행동에만 적용한다.
  • 거절·선 긋기는 무례함이 아니다. 모호하게 미루는 게 오히려 관계를 망친다.
  • 직장 내 괴롭힘·차별·폭언은 개인 소통 기술의 영역이 아니다. 공식 절차로 다룬다.

관련 스킬

  • moai-coworker:collab-negotiation: 갈등을 면담·요청·협상으로 풀 때
  • moai-coworker:collab-feedback-loop: 행동 변화가 필요할 때 건설적 피드백 전달
  • moai-coworker:collab-report-speak: 까다로운 상사에게 보고할 때 화법 설계
  • moai-coworker:productivity-goal: 관계 스트레스 관리·경계 설정 루틴

후처리 체인 (대응 스크립트·거절 멘트 등 서술형 산출물)

대응 스크립트·거절 멘트는 관찰한 행동만 적고 상대의 동기·성격을 단정하지 않았는지, 거절 문장이 짧고 자연스러운지 직접 검수한다. 아래 스킬은 현재 앱에 노출된 경우에만 추가로 사용한다.

  • moai-coworker:ai-slop-reviewer: 노출된 경우 표현 추가 검수
  • moai-writer:korean-humanize: 별도 설치돼 노출된 경우 한국어 문장 추가 윤문. 갈등 사실과 안전 안내는 보존

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

  • 직장 내 괴롭힘·차별·폭언: 소통 기술이 아니라 인사·고충처리·법적 절차의 영역이다.
  • 공식 징계·인사 조치: 평가·징계는 moai-recruiter 영역을 사용한다.
  • 개인 멘탈·번아웃 관리: 깊은 소진은 전문 상담·moai-coworker의 자기관리로 다룬다.

출처

직장 갈등 대응을 위한 일반적인 대화 구조다. 사용자 자료를 실제로 제공받은 경우에만 그 내용을 반영하고, 법적 판단이나 인사 조치가 필요하면 해당 절차로 연결한다.

경영진 요약

목적

제공된 보고서의 핵심 사실, 사업상 의미, 결정해야 할 사항을 짧게 정리합니다. 요약에 쓴 수치와 판단은 원문 위치나 실제 조회 자료로 추적할 수 있어야 합니다. 자료가 없으면 요약 대상 자료를 요청하거나, 제공된 정보만으로 가능한 초안이라고 표시합니다.

입력과 범위

  • 사용자가 제공한 보고서, 재무제표, 회의록, 운영 지표 등을 읽습니다.
  • 읽을 수 없는 파일·페이지와 조회하지 못한 외부 자료를 밝힙니다.
  • 원문의 기간, 단위, 회계 기준, 잠정·확정 여부를 보존합니다.
  • 인과관계나 전망은 근거가 없으면 사실 대신 가설로 적습니다.
  • 1페이지·500단어처럼 분량 지정이 있으면 그 요청에 맞춥니다. 한국어는 단어 수보다 실제 페이지와 읽기 쉬운 길이를 확인합니다.

작성 순서

  1. 결론: 원문이 뒷받침하는 가장 중요한 메시지를 한 문장으로 적습니다.
  2. What: 결정과 관련된 사실·수치, 기준 기간과 출처를 추립니다.
  3. So What: 사실이 목표·비용·위험에 미치는 의미를 설명합니다. 계산한 값에는 산식을 붙입니다.
  4. Now What: 실제 가능한 선택지, 장단점, 확인이 필요한 전제를 적습니다. 권고가 가능하면 근거와 함께 제시하고, 자료가 부족하면 결정을 유보할 조건을 적습니다.
  5. 위험과 다음 확인: 남은 불확실성과 누가 무엇을 확인할지 적습니다. 합의되지 않은 날짜나 담당자를 만들지 않습니다.

자료에 없는 매출·EBITDA·LTV/CAC·K-IFRS 적용 여부를 채워 넣지 않습니다. 재무 수치는 moai-accountant:finance-financial-statements 또는 moai-accountant:finance-variance-analysis의 실제 결과가 있을 때 참고합니다.

출력

기본 출력은 대화에서 읽을 수 있는 마크다운 요약입니다. 사용자가 파일을 원하면 현재 앱에서 가능한 방식으로 저장합니다. 단일 HTML·PDF·DOCX·PPTX·HWPX가 필요할 때는 해당 형식을 지원하는 moai-officer 스킬의 현재 기능을 확인한 뒤 연결합니다. 공유 채널에 실제 전송한 것처럼 말하지 않습니다.

# 경영진 요약: [주제]

**결론**: [자료로 확인된 핵심 메시지]

## What
- [사실·수치] — [출처, 기간, 단위]

## So What
- [사업상 의미] — [판단 근거 또는 가설 표시]

## Now What
- 선택지 A: [효과·비용·선행 조건]
- 선택지 B: [효과·비용·선행 조건]
- 권고 또는 판단 보류: [이유]

## 위험과 다음 확인
- [미확인 자료, 확인 담당자가 정해졌다면 담당자]

검토

  • 원문과 요약의 수치·단위·기간·인용을 대조합니다.
  • [추정] 표시는 근거 없는 수치를 허용하는 면책 표시가 아닙니다. 계산 근거가 없으면 수치를 빼고 필요한 자료를 적습니다.
  • 모든 권고는 확인된 선택지와 제약에 연결합니다.
  • 파일 생성이나 공유를 실행하지 않았다면 완료라고 쓰지 않습니다.

관련 스킬

  • moai-accountant:finance-financial-statements · moai-accountant:finance-variance-analysis: 검증된 재무 입력
  • moai-coworker:collab-pm-report: 프로젝트 보고 입력
  • moai-officer:doc-html-report · moai-officer:doc-pdf · moai-officer:doc-docx · moai-officer:doc-pptx · moai-officer:doc-hwp: 요청한 형식의 문서 제작
  • 서술형 문장은 이 스킬에서 원문 수치·기간·판단 근거를 대조하고 문체를 검수합니다. moai-coworker:ai-slop-reviewer가 노출된 경우 추가 검수하고, 별도 설치된 moai-writer:korean-humanize가 노출된 경우에만 윤문합니다.

피드백 주고받기 (Feedback Loop)

개요

피드백은 어렵다. 주는 사람은 관계가 상할까 봐 돌려 말하다 메시지가 흐려지고, 받는 사람은 인격 공격으로 받아들여 방어부터 한다. 이 스킬은 피드백을 사람이 아니라 행동·사안에 고정하는 구조(SBI)를 제공하고, 받은 피드백에서 감정과 사실을 분리해 배울 것만 건지는 법을 돕는다. 회피하지 않고, 깨지지도 않게.

트리거 키워드

피드백, 피드백 주는 법, 피드백 받기, 부정적 피드백, 건설적 피드백, 쓴소리, 피드백 회피, 중간 보고, 중간 피드백, SBI, 피드백 소화

워크플로우

1단계: 피드백의 목적 정하기

비난과 피드백은 다르다. 피드백은 상대가 더 잘하도록 돕는 것이지 화풀이가 아니다.

  • 주기 전 자문: "이 말로 상대가 무엇을 바꾸길 바라는가?" 답이 없으면 그건 감정 배설이다.
  • 받을 때 전제: "이 안에 내가 쓸 수 있는 게 한 조각이라도 있나?"
  • 칭찬 피드백도 똑같이 구체적으로 — "잘했어" 대신 "어디가 왜 좋았는지"

2단계: SBI 구조로 전달하기 (주는 쪽)

행동을 사람에서 떼어내는 3단 구조다.

단계내용예시
S (상황)언제·어디서"어제 고객 미팅에서"
B (행동)관찰한 사실(해석 빼고)"발표 중 자료를 미리 안 띄워서 5분 지연됐어요"
I (영향)확인된 영향 또는 본인이 받은 영향"자료를 다시 여는 동안 발표가 멈췄어요"

→ "당신은 항상 준비가 부족해" 같은 인격·일반화는 금지. 사실 → 영향만 말하고, 개선은 함께 찾는다.

3단계: 받은 피드백 소화하기 (받는 쪽)

부정적 피드백이 오면 본능은 방어다. 그 사이에 한 박자를 둔다.

  1. 즉답 대신 멈춤: "피드백 고마워요, 정리해서 다시 말씀드릴게요"로 시간 확보
  2. 감정 ↔ 사실 분리: 기분 나쁜 것과 내용이 맞는지는 별개로 본다
  3. 하나만 건지기: 전부 맞을 필요 없다. 쓸 수 있는 한 조각만 골라 행동으로 바꾼다
  4. 근거 확인: 반복되는 지적도 실제 사례와 맥락을 확인한다. 상대의 의도는 추측만으로 판단하지 않는다

→ 피드백은 나에 대한 최종 판결이 아니라 한 시점의 한 관점이다.

4단계: 먼저 피드백 요청하기

피드백을 기다리지 말고 먼저 구하면 작게·자주 받을 수 있다(중간 보고).

  • 구체적으로 묻기: "어땠어요?"(막연) 대신 "이 보고서에서 논리가 약한 부분이 있을까요?"
  • 타이밍 잡기: 완성 전 초안 단계에서 — 다 만든 뒤보다 고치기 쉽다
  • "나 일하고 있어요" 신호: 진행 중 중간 공유는 신뢰를 쌓고 막판 사고를 막는다

5단계: 피드백을 행동으로 닫기

받았으면 닫아야 다음 피드백이 온다.

  • 받은 피드백 중 바꿀 1~2가지를 정해 실제로 적용
  • 피드백 준 사람에게 반영 결과를 짧게 공유 — "지난번 말씀 반영해서 이렇게 바꿨어요"
  • 이 닫는 루프가 "이 사람은 피드백을 받는 사람"이라는 신뢰를 만든다

사용 예시

예시 1: "후배가 자꾸 마감을 놓치는데 어떻게 말해야 기분 안 상하게 전달할까?" → SBI 구조(상황·행동·영향) → 인격 표현 제거 → 개선책을 함께 찾는 질문형 마무리

예시 2: "상사한테 일 못한다는 피드백 받고 너무 속상해" → 감정·사실 분리 → 반복·신뢰 출처인지 가중치 판단 → 쓸 수 있는 1조각 + 행동 전환안

예시 3: "프로젝트 중간에 피드백을 미리 받고 싶은데 어떻게 요청하지?" → 구체적 질문 설계 → 초안 단계 타이밍 → 중간 보고 메시지 템플릿

산출물

  • SBI 기반 피드백 스크립트(상황·행동·영향)
  • 받은 피드백 소화 체크리스트(감정/사실 분리·가중치)
  • 피드백 요청 질문 + 중간 보고 메시지 템플릿
  • 반영 결과 공유 멘트

주의사항

  • 부정적 피드백은 1:1로, 즉시·짧게. 공개 자리에서의 지적은 메시지보다 모욕으로 남는다.
  • 받은 피드백을 전부 수용할 필요는 없다. 단, 반복되는 피드백은 신호일 가능성이 높다.
  • 피드백을 "돌려 말하기"로 부드럽게 하려다 핵심이 사라지면 안 준 것과 같다.

관련 스킬

  • moai-coworker:collab-negotiation: 피드백이 면담·요청으로 이어질 때 대화 설계
  • moai-coworker:collab-report-speak: 중간 보고로 피드백을 미리 받기
  • moai-coworker:collab-conflict: 피드백이 갈등으로 번질 때 대응
  • moai-recruiter:hr-performance-review: 공식 성과평가 피드백 면담

후처리 체인 (SBI 피드백 스크립트·요청 멘트 등 서술형 산출물)

SBI 피드백 스크립트·요청 멘트는 관찰한 행동과 확인된 영향을 분리하고, 인격 평가·과장·어색한 표현이 없는지 직접 검수한다. 아래 스킬은 현재 앱에 노출된 경우에만 추가로 사용한다.

  • moai-coworker:ai-slop-reviewer: 노출된 경우 표현 추가 검수
  • moai-writer:korean-humanize: 별도 설치돼 노출된 경우 한국어 문장 추가 윤문. 행동·영향의 사실 관계는 보존

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

  • 공식 인사평가·고과 피드백: 평가 면담은 moai-recruiter:hr-performance-review를 사용한다.
  • 개인 회고·자기 점검: 나 혼자 돌아보는 회고는 moai-coworker를 쓴다.
  • 괴롭힘·차별 상황: 단순 피드백이 아니라 직장 내 괴롭힘이면 인사·고충 채널과 공식 절차로 다룬다.

출처

SBI 모델과 피드백 대화의 일반적인 구성 예시다. 사용자 자료는 실제로 제공된 경우에만 반영한다.

회의 진행·퍼실리테이션 (Meeting Facilitator)

개요

회의가 길어지는 이유는 보통 사람이 많아서가 아니라 목적이 흐릿하고 진행 규칙이 없어서다. 이 스킬은 회의 전 목적·아젠다·산출물을 못 박고, 회의 중에는 시간과 발언을 관리하며, 회의 후에는 결정과 담당자가 남게 하는 진행 설계를 돕는다. 모이는 시간을 줄이고 남는 결론을 늘린다.

트리거 키워드

회의, 회의 진행, 아젠다, 퍼실리테이션, 산으로 가는 회의, 의사결정 회의, 회의록, 회의 준비, 미팅 진행, 회의 규칙, 후속 액션

워크플로우

1단계: 회의의 목적과 산출물 정의

회의를 잡기 전에 한 줄로 답한다. 답이 안 나오면 회의 대신 메시지로 끝낼 일이다.

  • 이 회의가 끝나면 무엇이 남아야 하는가? (결정 / 정렬 / 아이디어 / 공유)
  • 회의 유형 구분:
유형목적끝났을 때 남는 것
의사결정선택지 중 결정결정 + 담당자 + 기한
정렬·공유같은 그림 맞추기합의된 이해·다음 단계
발산·아이디어가능성 펼치기후보 목록 + 다음 판단 기준
문제 해결막힌 곳 풀기원인 + 해결안 + 책임자

2단계: 아젠다 설계 (시간 박스)

안건마다 목적·시간·산출물을 붙인다. 막연한 "○○ 논의"는 금지.

  • 각 안건: 제목 / 목적(결정·공유·발산) / 배정 시간 / 누가 발제
  • 무거운 결정 안건을 앞쪽에 배치(에너지 높을 때)
  • 사전 공유 자료를 미리 돌려 회의에서 "읽는 시간"을 없앤다
  • 안건이 5개를 넘으면 회의를 쪼개거나 일부를 비동기로 돌린다

3단계: 진행 규칙 (산으로 가지 않게)

회의 시작 30초에 규칙을 합의하면 끌고 가기 쉬워진다.

  • 타임키퍼·기록자 지정: 진행자가 둘 다 하면 둘 다 놓친다
  • 주차장(Parking Lot): 주제에서 벗어난 논의는 보드에 적어두고 나중에. "그건 주차장에 적어둘게요"
  • 발언 균형: 발언을 요약하고 의견을 낼 기회를 고르게 제공한다. 직접 호명은 참석자의 선호와 상황을 고려한다
  • 결론 신호: 안건마다 "그래서 우리가 정한 건 ○○ 맞죠?"로 못 박고 다음으로

4단계: 의사결정 끌어내기

결정이 안 나는 회의를 끝내려면 결정 방식을 미리 정한다.

  • 결정 방식 합의: 합의 / 다수결 / 책임자 단독결정(RAPID·DACI 등 단순 버전)
  • 선택지를 좁히기: 무한 토론 대신 2~3개 안으로 압축 후 비교
  • 결정 못 할 땐: 무엇이 더 있어야 결정 가능한지(데이터·승인)와 누가 언제까지를 정하고 종료
  • 결정 권한자가 실제로 합의한 내용만 문장으로 적고 참석자에게 확인한다

5단계: 회의록 + 후속 액션

기록의 핵심은 회의 내용 받아쓰기가 아니라 결정과 할 일이다.

  • 3줄 회의록: 결정 사항 / 액션 아이템(담당·기한) / 보류·다음 안건
  • 회의록을 합의한 채널에 공유하기 전, 공유 대상과 민감 정보 포함 여부를 확인한다
  • 액션 아이템은 담당자·기한·완료 기준까지. "○○ 검토"가 아니라 "○○ 금요일까지 A/B 비교안"

사용 예시

예시 1: "내일 주간 회의가 매번 1시간 넘게 늘어지는데 어떻게 줄이지?" → 목적 재정의 → 안건별 시간 박스 아젠다 → 타임키퍼·주차장 규칙 → 3줄 회의록 템플릿

예시 2: "신규 기능 우선순위를 정하는 의사결정 회의를 진행해야 해" → 결정 방식 사전 합의 → 후보 2~3안 압축 → 비교 기준표 → 결정 문장화 + 담당·기한

예시 3: "회의가 자꾸 딴 얘기로 새서 결론이 안 나" → 주차장 규칙 + 결론 신호 멘트 → 안건 5개 초과 시 분할·비동기화 → 진행 멘트 스크립트

산출물

  • 회의 목적·유형·산출물 한 줄 정의
  • 시간 박스 아젠다(안건·목적·시간·발제자)
  • 진행 규칙 세트(타임키퍼·주차장·결론 신호)
  • 의사결정 방식·비교안
  • 3줄 회의록 + 액션 아이템(담당·기한) 템플릿

주의사항

  • 모든 모임이 회의일 필요는 없다. 공유·보고는 비동기 메시지가 더 빠를 때가 많다.
  • 진행자는 의견 주인이 아니라 흐름 관리자다. 본인 주장을 끌고 가면 균형이 깨진다.
  • 결정을 문장화하지 않으면 회의가 끝나도 각자 다르게 기억한다.

관련 스킬

  • moai-coworker:collab-report-speak: 회의에서 결론 먼저 발제·보고
  • moai-coworker:collab-negotiation: 회의 전 핵심 인물과 사전 정렬·설득
  • moai-coworker:collab-conflict: 회의 중 충돌·발언 독점 대응
  • moai-officer:doc-docx: 회의록을 정식 문서로 정리

후처리 체인 (회의록·진행 멘트 등 서술형 산출물)

회의록·진행 멘트는 실제 결정·담당자·기한과 미결정 사항을 구분하고, 없는 합의를 만들어 넣지 않았는지 직접 검수한다. 아래 스킬은 현재 앱에 노출된 경우에만 추가로 사용한다.

  • moai-coworker:ai-slop-reviewer: 노출된 경우 표현 추가 검수
  • moai-writer:korean-humanize: 별도 설치돼 노출된 경우 한국어 문장 추가 윤문. 결정·담당·기한은 보존

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

  • 별도의 기획서 작성: 문서 형식과 내용에 맞는 스킬을 사용한다. 회의록 초안은 이 스킬 범위에 포함된다.
  • 개인 일정·할 일 관리: 내 작업 계획은 moai-coworker를 사용한다.
  • 워크숍·교육 프로그램 설계: 장시간 퍼실리테이션 커리큘럼은 별도 설계가 필요하다.

출처

아젠다 시간 배분·보류 안건 기록·의사결정 방식의 일반적인 진행 예시다. 사용자 자료는 실제로 제공된 경우에만 반영한다.

1:1 면담·설득·협상 (1on1 Negotiation)

개요

면담·협상은 말솜씨가 좋은 사람이 이기는 게 아니라 준비한 사람이 이긴다. 그리고 직장의 협상은 한 번 이기고 끝나는 게 아니라 내일도 봐야 할 사람과 하는 것이라, 관계를 깨면 이겨도 진다. 이 스킬은 면담 전 목표와 상대 입장을 정리하고, 설득의 순서를 짜고, 요청·거절을 정중하지만 분명하게 하는 대화를 설계한다. 태도와 구조로 푸는 협상이다.

트리거 키워드

면담, 1on1, 1:1, 설득, 협상, 연봉 협상, 요청, 부탁, 정중한 거절, 대화 준비, 설득 구조, 면담 준비

워크플로우

1단계: 목표와 양보선 정하기

협상에 들어가기 전 세 가지를 정해 둔다. 즉흥은 끌려가는 길이다.

  • 최선(목표): 가장 원하는 결과
  • 마지노선(양보선): 여기 아래로는 받아들이지 않을 선
  • 차선(대안·BATNA): 합의가 깨졌을 때의 다른 선택지 — 이게 있어야 끌려가지 않는다

→ 양보선과 대안을 미리 알면, 감정에 휩쓸려 그 자리에서 손해 보는 결정을 안 한다.

2단계: 상대 입장 파악 (왜를 듣기)

설득은 내 주장 키우기가 아니라 상대가 무엇을 원하는지 아는 것에서 시작한다.

  • 상대가 밝힌 요구와 확인하지 못한 이해관계 가설을 구분한다
  • 거절 이유·제약은 추측으로 단정하지 말고 질문해 확인한다
  • 상대 말을 되짚고 맞는지 확인한다 — "○○ 부분이 걱정이신 건가요?"

3단계: 설득 구조 설계

설득은 순서가 절반이다. 결론 → 상대 이득 → 근거 → 우려 해소로 짠다.

순서내용
① 결론·요청무엇을 원하는지 한 문장
② 상대의 이득"그쪽에" 무엇이 좋은지 먼저
③ 근거숫자·사례로 뒷받침
④ 우려 해소상대가 걱정할 점에 대한 대비책

→ 내 입장만 나열하면 "그래서 나한테 뭐가 좋은데?"에서 막힌다. 상대 언어로 번역한다.

4단계: 요청·거절 화법

요청·부탁
  • 구체적으로: "좀 도와주세요"가 아니라 "○○을 금요일까지, 30분만"
  • 이유 + 영향: 왜 필요한지, 안 되면 무엇이 막히는지
  • 상대의 선택권 존중: "가능하실까요?"로 여지를 남겨 부담을 줄인다

요청·거절 스크립트의 종결어미·쿠션어·화법 구조는 수신자 위계에 따라 moai-coworker:collab-report-speak의 references/kr-honorific-tone.md 공유 규격을 적용한다.

정중한 거절
  • 공감 → 거절 → 대안 3단(짧게): "필요하신 거 알아요 → 지금은 어려워요 → 대신 ○○는 가능해요"
  • 사람이 아니라 상황을 이유로. 변명은 한 줄.

5단계: 창조적 대안 + 합의 마무리

한정된 파이를 나누는 싸움(제로섬)에서 파이를 키우는 대안으로 옮기면 둘 다 얻는다.

  • 창조적 대안: 돈이 안 되면 시간·권한·성장 기회 등 다른 카드를 섞는다(예: 연봉 대신 교육비·재택·직책)
  • 합의 문장화: 구두로 끝내지 말고 무엇을·언제·누가를 메시지로 확인
  • 관계 닫기: 결과와 무관하게 "이야기 나눠서 좋았어요"로 다음을 위한 신뢰를 남긴다

사용 예시

예시 1: "연봉 협상 면담을 앞두고 있는데 어떻게 준비하지?" → 목표·양보선·대안 정리 → 회사의 실제 기준·예산 확인 → 성과 근거와 가능한 대안 정리 → 합의 내용 확인

예시 2: "다른 팀에 급하게 협조를 부탁해야 하는데 어떻게 말하지?" → 상대 이득 먼저 → 구체 요청(범위·기한) → 우려 해소 → 선택권 존중 멘트

예시 3: "선배 부탁을 거절해야 하는데 관계가 틀어질까 걱정돼" → 공감+거절+대안 3단 → 상황 탓 전환 → 거절 후 관계 유지 마무리

산출물

  • 협상 목표·양보선·대안(BATNA) 정리
  • 상대 입장·이해관계 분석
  • 4단 설득 스크립트(결론·이득·근거·우려 해소)
  • 요청/거절 화법 템플릿
  • 창조적 대안 카드 + 합의 문장화 체크리스트

주의사항

  • 협상은 능력이라기보다 태도다. 이기려 들기보다 함께 풀 문제로 두면 더 멀리 간다.
  • 대안(BATNA) 없이 들어가면 끌려간다. 깨졌을 때의 길을 먼저 마련한다.
  • 구두 합의는 흐려진다. 중요한 약속은 반드시 기록으로 확인한다.

관련 스킬

  • moai-coworker:collab-conflict: 면담이 갈등·거절 상황과 얽힐 때
  • moai-coworker:collab-feedback-loop: 면담에서 피드백을 주고받을 때
  • moai-coworker:collab-report-speak: 면담에서 결론 먼저 설득 구조 적용
  • moai-coworker: 영업 제안·계약 협상 문서가 필요할 때

후처리 체인 (설득·요청·거절 화법 스크립트 등 서술형 산출물)

설득·요청·거절 화법 스크립트는 상대의 실제 발언과 확인되지 않은 의도·조건을 구분하고, 요구·양보선·합의 내용을 원자료와 대조한 뒤 문체를 직접 검수한다. 아래 스킬이 현재 앱에 노출된 경우에만 추가로 사용한다.

  • moai-coworker:ai-slop-reviewer: 노출된 경우 과장·상투구 추가 검수
  • moai-writer:korean-humanize: 별도 설치돼 노출된 경우 한국어 문장 추가 윤문. 요구·양보선·합의 내용은 보존

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

  • 공식 성과평가·인사 면담 진행: 평가 면담은 moai-recruiter:hr-performance-review를 사용한다.
  • 계약서 검토: 법적 판단이 필요한 경우 moai-lawyer:legal-contract-review 또는 전문가 검토로 연결한다.
  • 법적 분쟁·노사 협상: 법적 효력이 걸린 협상은 전문가·공식 절차로 다룬다.

출처

BATNA·이해관계 파악·대안 비교를 위한 일반적인 대화 구조다. 사용자 자료는 실제로 제공된 경우에만 반영한다.

팀 주간보고

목적

완료한 일, 진행 중인 일, 다음 계획, 위험과 의사결정 요청을 읽는 사람에게 맞게 정리합니다. 조직의 기존 양식이 있으면 그 양식을 따르고, 없으면 아래 구조를 출발점으로 사용합니다. 임원용 요약과 팀 내부판은 요청된 경우에만 따로 작성합니다.

입력 확인

  1. 보고 기간, 팀, 대상 독자와 기존 양식을 확인합니다.
  2. 사용자가 지정한 Notion·Linear·Asana·Slack 등의 연결 자료가 현재 앱에서 실제로 사용 가능한지 확인합니다. 접근 권한이 있어도 관련 범위만 조회합니다.
  3. 첨부 파일이나 자유 텍스트만 있다면 그 내용으로 작성합니다. 연결 도구가 없거나 조회에 실패하면 실패 범위와 추가로 필요한 자료를 밝힙니다.
  4. 완료·진행 상태, 담당자, 수치, 목표값, 날짜의 출처와 기준일을 기록합니다. 서로 다른 서비스의 상태를 병합할 때 중복·불일치를 확인합니다.

보고서 구성

섹션기록할 내용
핵심 지표실제 지표와 측정 기간. 목표가 있을 때만 목표 대비를 계산
완료확인된 결과와 산출물 링크. 효과는 측정됐을 때만 기재
진행 중현재 상태, 막힌 일과 확인된 다음 단계
다음 계획합의된 우선순위와 기한. 미정이면 미정으로 표시
위험·이슈근거, 영향, 대응 담당자가 정해졌다면 담당자
결정 요청결정권자에게 필요한 질문, 선택지와 확인할 전제

내용이 없는 섹션에 수치나 사건을 만들지 않습니다. 의사결정 요청이 없다면 없음이라고 적습니다. 사용자가 제시한 일정은 임의의 P0/P1/P2로 바꾸지 않고 목표인지 확정된 약속인지 구분합니다.

작성과 검토

  • 업무 기록을 단순 시간순으로 복사하지 않고 결정에 필요한 결과를 앞에 둡니다.
  • 수치에는 출처·기간·단위를 적습니다. [추정] 표시는 없는 숫자를 만들라는 허가가 아닙니다.
  • 개인별 비난·평가는 업무 보고에 임의로 넣지 않습니다.
  • 외부 공유 문서는 대상과 공개 범위를 확인하고, 민감 정보는 승인된 범위만 포함합니다.
  • 초안 작성과 실제 전송·공유는 구분합니다. 연결 서비스를 조회하지 않았다면 자동 동기화했다고 말하지 않습니다.

출력 예시

# 주간보고 — [팀명] · [보고 기간]

## 핵심 지표
- [지표, 값, 기간, 출처 또는 자료 없음]

## 완료
- [확인된 결과와 근거]

## 진행 중
- [현재 상태와 막힌 일]

## 다음 계획
- [합의된 우선순위와 일정 또는 미정]

## 위험·이슈
- [확인된 위험과 대응 또는 없음]

## 결정 요청
- [결정할 질문과 필요한 자료 또는 없음]

임원용 압축 요약은 moai-coworker:collab-exec-summary를 사용하거나 위 보고서에서 핵심 판단만 추립니다. 슬라이드가 필요하면 moai-officer:doc-pptx의 현재 기능을 확인합니다. 스탠드업·회고 자료도 사용자가 제공했을 때만 요약합니다.

관련 스킬

  • moai-coworker:collab-roadmap: 향후 제품 방향·마일스톤 계획
  • moai-coworker:collab-exec-summary: 경영진용 압축 요약
  • 서술형 문장은 이 스킬에서 기록·수치·기간·담당자를 대조하고 문체를 검수합니다. moai-coworker:ai-slop-reviewer가 노출된 경우 추가 검수하고, 별도 설치된 moai-writer:korean-humanize가 노출된 경우에만 윤문합니다.
  • moai-officer:doc-pptx: 요청된 발표 자료 제작

프로세스 관리자 (collab-process)

전략 가이드

ID한국명설명
operations-manual운영 매뉴얼업무 프로세스, 운영 규정, 워크플로우 설계
procurement-docs조달 문서구매 요청서, 발주서, 벤더 평가
sop-writerSOP 작성표준 운영 절차, 매뉴얼, 가이드라인
meeting-strategist회의 전략가회의록 작성, 안건 관리, 후속 조치

→ 참조 파일: references/{id}.md

실행 규칙

  1. 사용자 요청 수신 → 해당 전략 가이드 판별
  2. references/{id}.md 로드 → 전략 가이드에 따라 실행
  3. 복잡한 절차는 입력 자료의 단계·권한·예외 경로를 확인하고, 현재 앱에서 실제로 쓸 수 있는 도구만 사용
  4. 결과물 생성 후 사용자 검토 요청

트리거 키워드

프로세스, 운영 매뉴얼, 업무 절차, SOP, 조달, 구매, 발주, 회의록, 안건, 워크플로우

사용 예시

  • "신규 직원 온보딩 SOP를 작성해줘"
  • "IT 장비 구매 요청서 양식을 만들어줘"
  • "오늘 회의 내용을 회의록으로 정리해줘"
  • "영업팀 월간 운영 매뉴얼을 설계해줘"
  • "소프트웨어 구매를 위한 벤더 평가표를 만들어줘"

독립 실행 워크플로우

전략 가이드 파일 없이도 다음 단계로 실행 가능합니다:

  1. 요청 파악: 문서 유형(SOP/회의록/조달/매뉴얼) 및 대상 업무 확인
  2. 구조 설계: 목적, 적용 범위, 담당자, 단계별 절차 초안 작성
  3. 내용 작성: 각 절차를 구체적인 액션 단위로 기술 (담당자·도구·산출물 명시)
  4. 검토 포인트 제시: 법적 준수 사항, 결재 라인, 비상 대응 절차 포함 여부 확인
  5. 최종 확인: 사용자 검토 후 최종본 제공

전자결재·결재선 설계

프로세스 문서에 결재 절차가 필요하면 사용자의 조직 규정과 실제 권한자를 먼저 확인합니다. 아래는 초안을 위한 예시 흐름입니다.

기안(담당) → 검토(팀장/부서장) → 합의·협조(관련 부서) → 전결 또는 최종 결재(결재권자)
  1. 기안: 담당자가 문서를 작성하고 결재를 상신합니다. 문서번호·시행일자는 서식 규칙을 따릅니다.
  2. 검토: 직속 상급자(팀장·부서장)가 내용·형식을 확인합니다.
  3. 합의(협조): 예산·법무·보안 등 이해관계 부서의 확인이 필요한 안건은 결재선 중간에 합의란을 둡니다. 합의 부서가 반려하면 기안 단계로 되돌립니다.
  4. 최종 승인: 전결·대결 표기와 결재란은 조직의 실제 위임 규정과 문서 시스템 서식에 맞춥니다. 행정기관 규정을 민간 회사의 공통 의무로 적용하지 않습니다.

위임전결 규정 설계 가이드: 사안 유형과 금액 구간별 권한자는 조직의 실제 규정을 확인합니다. 규정이 없다면 결정해야 할 항목만 초안으로 제시하고, 승인권자를 임의로 지정하지 않습니다.

공문·기안문·품의서의 결재란·전결 실서식은 moai-officer:doc-hwp가 현재 앱에 노출돼 있으면 해당 스킬의 references/kr-official-forms.md를 참조합니다. 없으면 조직이 제공한 서식을 확인하고, 실서식을 검증하지 못한 부분은 초안으로 표시합니다.

문제 해결

상황해결 방법
결재 라인 정보 부족조직도 또는 결재 권한 범위를 알려주시면 맞춤 작성 가능합니다
조달 규정 확인 불가일반적인 내부 구매 기준으로 작성 후 담당 부서 검토를 권장합니다
기존 프로세스와 충돌현행 절차 문서를 공유해 주시면 개선안으로 작성해 드립니다
업종·도메인 특화 요구해당 업종 규정이나 컴플라이언스 기준을 함께 제공해 주세요

관련 스킬 (후처리 체인)

SOP, 운영 매뉴얼, 회의록, 조달 문서 등 서술형 산출물은 담당·순서·예외·확인되지 않은 결재권한을 원자료와 대조하고 문체를 직접 검수합니다. 아래 스킬은 현재 앱에 노출된 경우에만 추가로 사용합니다.

collab-process → 자체 절차·문체 검수 → (노출된 경우) ai-slop-reviewer → (별도 설치된 경우) korean-humanize
  • moai-coworker:ai-slop-reviewer — 노출된 경우 문서 본문의 AI 티 패턴을 추가 검수합니다.
  • moai-writer:korean-humanize — 별도 설치돼 노출된 경우 한국어 실무 문체를 추가로 다듬습니다. 절차·권한·예외는 보존합니다.

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

  • 법적 구속력이 있는 계약서 작성 → 법률 전문가 검토가 필요합니다. moai-lawyer:legal-contract-review를 함께 사용하세요
  • 실제 발주 처리 또는 시스템 입력 → ERP나 조달 시스템에 직접 접속해야 합니다
  • 인사·노무 관련 절차 → moai-recruiter:hr-operations 스킬이 더 적합합니다
  • 재무·예산 승인 절차 → 조직의 재무 담당자와 승인 규정을 확인하고, 재무 분석은 moai-accountant의 해당 스킬로 연결하세요

References

파일로드 조건
references/operations-manual.md운영 매뉴얼 작성 시 (기존 문서/코드 분석→업무 프로세스·단계별 매뉴얼·FAQ·교육 자료 생성)
references/procurement-docs.md조달 문서 작성 시 — 발주자 관점 (요건 정의→공급업체 비교→평가 기준→계약 검토→수락 기준). 입찰자 관점 나라장터 가이드는 moai-coworker:collab-proposal의 references/nara-jangteo.md
references/sop-writer.md표준 운영 절차(SOP) 작성 시 (프로세스 분석→절차 설계→문서화→검증)
references/meeting-strategist.md회의 전략 수립 시 (회의 목표 설정→참석자 구성→안건 개발→진행 계획)

주간업무보고 (Weekly Report)

개요

개인 업무 기록을 성과·진행·이슈·다음 계획으로 정리해 제출용 초안을 만든다. 팀 전체의 지표·프로젝트 상태 보고는 moai-coworker:collab-pm-report로 연결한다.

트리거 키워드

주간보고, 주간업무보고, 업무보고, 한 주 리뷰, 이번 주 한 일, 업무일지, 주간 업무 정리, 위클리 리포트, 주간 보고서

워크플로우

1단계: 한 주 업무 수집

먼저 사용자가 제공한 업무일지·메신저·커밋·캘린더 기록에서 필요한 범위만 모은다. 연결 자료에 접근하지 못했다면 읽은 것처럼 쓰지 않는다.

  • 완료한 일: 마무리한 업무·산출물
  • 진행 중인 일: 아직 끝나지 않은 업무와 현재 단계
  • 이슈·블로커: 막힌 점, 도움이 필요한 부분
  • → 업무일지가 있다면 출처와 기간을 확인한다. Notion 템플릿은 사용자가 원하고 연결 기능이 있을 때만 쓴다

2단계: 성과 중심으로 정리

"한 일 나열"이 아니라 "결과·영향"이 보이게 정리한다.

  • 작업(무엇을) → 결과(어떻게 됐는지·숫자) 형태로
  • "보고서 작성함" → "신규 캠페인 보고서 완료, 다음 주 임원 보고 예정"
  • 수치(건수·비율·금액·기한)는 실제 기록에서 확인된 경우에만 넣는다
  • → 받는 사람이 "그래서 뭐가 어떻게 됐나"를 바로 알게 한다

3단계: 표준 보고 틀에 배치

조직에서 흔히 쓰는 4블록 틀에 채운다.

블록내용
금주 주요 성과완료·진척이 있는 핵심 3~5개
진행 중 업무현재 단계·예상 완료 시점
이슈·요청막힌 점, 의사결정·지원 요청
차주 계획다음 주 집중할 일 3개

→ 너무 길게 쓰지 않는다. 핵심만, 읽는 데 1분 안에.

4단계: 톤·격식 맞추기

받는 사람과 조직 문화에 맞춰 문장 톤을 정한다.

  • 격식체(임원·공식 보고): "~하였습니다", 간결한 개조식 + 종결 정돈
  • 구어체(가까운 팀·슬랙): "~했어요/했습니다", 부드럽고 빠르게
  • 개조식 vs 서술식: 빠른 스캔용은 개조식, 맥락 설명이 필요하면 서술식
  • → 같은 내용도 톤만 바꿔 두 버전 제시 가능

5단계: 마무리 점검

  • 이슈에 요청 붙이기: 막힌 점은 "무엇을 도와달라"까지 명시
  • 차주 계획 우선순위: 3개로 좁히고 productivity-time으로 블록 배치
  • AI 티 다듬기: 업무 기록과 수치·기간·담당·요청을 대조하고 어색한 번역투·과한 미사여구를 직접 제거. moai-coworker:ai-slop-reviewer가 노출된 경우 추가 검수
  • → 한 주 회고가 필요하면 productivity-retro로 가볍게 이어간다

사용 예시

예시 1: "이번 주 한 일 정리해서 팀장님께 보낼 주간보고 써줘" → 업무 수집 → 성과 중심 4블록 정리 → 격식체 개조식 초안

예시 2: "슬랙에 올릴 위클리 가볍게 정리해줘" → 핵심 3~5개 → 구어체 톤 → 짧은 스캔용 포맷

예시 3: "이번 주 막힌 일 있는데 보고에 어떻게 쓰지?" → 이슈 + "필요한 의사결정/지원" 명시 → 차주 계획에 후속 반영

산출물

  • 한 주 업무 수집 정리
  • 성과 중심 4블록 보고서(성과·진행·이슈·차주 계획)
  • 톤별 버전(격식체/구어체)
  • 이슈에 붙인 요청·차주 우선순위 3개

주의사항

  • "한 일 나열"이 아니라 "결과·영향" 중심으로 — 받는 사람 관점에서 쓴다.
  • 길수록 안 읽힌다. 핵심만, 1분 안에 읽히게.
  • 보고 톤·양식은 조직마다 다르다. 받는 사람·기존 양식에 맞춘다.
  • 제출 전 업무 기록과 수치·기간·담당·요청을 대조하고 AI 패턴을 직접 다듬는다. ai-slop-reviewer가 노출된 경우 추가 검수한다.

관련 스킬

  • moai-coworker:productivity-retro: 주간보고와 한 주 회고를 함께 운영
  • moai-officer:doc-notion-template: 업무일지 DB로 보고 작성 자동화
  • moai-officer:productivity-time: 차주 계획을 시간 블록에 배치
  • moai-coworker: 보고 대화·구두 보고·피드백 등 대인 커뮤니케이션
  • moai-coworker:ai-slop-reviewer: 보고서 초안의 AI 티 후처리
  • moai-writer:korean-humanize: 별도 설치돼 노출된 경우 한국어 문장 추가 윤문. 수치·기간·담당·요청은 보존

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

  • 팀 전체 스프린트 리포트·프로젝트 진척 보고: 조직 단위 보고는 moai-coworker:collab-pm-report를 사용한다.
  • 구두 보고·회의 발언 스크립트: moai-coworker:collab-report-speak를 사용한다.
  • 공식 문서(품의서·기획서·제안서): 문서 종류에 맞는 moai-officer 또는 moai-coworker:collab-proposal 스킬을 확인한다.

출처

개인 주간업무보고의 구성 예시다. 사용자 업무 기록은 실제로 제공된 경우에만 반영한다.

B2B 제안서 작성

적용 범위

민간 고객의 영업 제안과 공공조달 입찰의 문서 초안을 지원합니다. 정부 지원사업 신청은 moai-consultant:consult-gov-grant, 투자자 IR은 moai-accountant:finance-investor-relations로 연결합니다. 실제 입찰 제출·계약 체결은 별도 실행과 권한 확인이 필요합니다.

입력 확인

  • 고객 요구사항 또는 해당 공고·RFP의 최신 원문, 공고번호, 발주기관, 마감 시각
  • 자사 제품 기능·가격·계약 조건·인증·수행 실적의 증빙
  • 제출 형식, 페이지 한도, 평가 기준, 필수·선택 서류
  • 고객사명과 담당자 표기, 공개 가능한 레퍼런스 범위

자료를 읽지 못하면 항목별로 확인 필요를 남깁니다. 사용자 제공 정보와 원문 공고, 실제 증빙을 구분합니다. 다른 고객의 과거 제안서는 재사용 권한·비밀 유지 범위를 확인합니다.

작성 순서

  1. RFP가 있으면 요구사항을 원문 위치와 함께 목록화합니다. 공고가 없으면 고객이 밝힌 요구만 정리합니다.
  2. 각 요구에 자사 근거를 연결하고 충족 증빙 확인, 불일치, 미확인으로 구분합니다. ISO·ISMS·매출·실적 등은 증빙 없이 충족 처리하지 않습니다.
  3. 고객 문제, 제안 방식, 기능·운영 범위, 비용, 위험과 전제를 문서화합니다. 목차는 공고 양식을 우선하고, 자유 제안에서는 필요한 섹션만 씁니다.
  4. ROI나 일정은 입력 자료와 계산 근거가 있을 때만 제시합니다. 고객의 확정 예산이나 마감은 임의 우선순위로 바꾸지 않습니다.
  5. 가격에 VAT 포함 여부가 주어졌는지 확인합니다. 모르면 임의로 정하지 않고 견적 담당자 확인 항목으로 남깁니다.
  6. 공공조달이면 references/nara-jangteo.md를 읽고, 해당 기관·공고에 실제 적용되는 자격·서류·계약 방식을 담당자와 확인합니다.
  7. 최종 발송·제출 전에 사용자가 누락 항목, 실제 증빙, 가격과 문구를 검토할 수 있도록 체크리스트를 제공합니다.

출력 형식

# [고객/공고] 제안서 초안

## 제안 개요
[확인된 요구와 자사 제안]

## 요구사항 대응
| 요구 | 원문 위치 | 자사 대응 | 증빙 | 상태 |
|---|---|---|---|---|
| [요구] | [페이지/항목] | [대응] | [자료] | 충족 증빙 확인/불일치/미확인 |

## 구현·운영 범위
[확인된 기능, 지원 범위, 제외 사항]

## 가격·일정
[실제 견적과 합의된 일정 또는 확인 필요]

## 위험·결정 사항
[남은 조건과 담당자 검토 항목]

[추정]은 없는 숫자를 만들어 넣는 수단이 아닙니다. 수치·시장 규모·효과를 쓸 때는 출처, 기준일, 산식을 함께 적습니다. 문서 파일이 필요하면 현재 앱이 지원하는 moai-officer:doc-docx·doc-pptx·doc-xlsx 등의 기능을 확인한 뒤 요청한 형식으로 제작합니다. 파일 작성과 외부 제출·발송을 구분합니다.

관련 스킬

  • moai-consultant:consult-market: 실제 산업·시장 자료 조사
  • moai-lawyer:legal-contract-review: 계약 조건 검토
  • 서술형 문장은 이 스킬에서 RFP·자사 증빙·가격·일정과 대조하고 문체를 검수합니다. moai-coworker:ai-slop-reviewer가 노출된 경우 추가 검수하고, 별도 설치된 moai-writer:korean-humanize가 노출된 경우에만 윤문합니다.
  • moai-officer:doc-docx · moai-officer:doc-pptx · moai-officer:doc-xlsx: 요청된 문서 형식 제작

보고·설명의 기술 (Report & Speak)

개요

같은 내용을 보고해도 어떤 사람은 30초 만에 "오케이"를 받고, 어떤 사람은 5분을 설명하고도 "그래서 결론이 뭐예요?"를 듣는다. 차이는 정보량이 아니라 순서다. 이 스킬은 머릿속에 흩어진 사실을 결론 먼저 구조로 재배열하고, 듣는 사람의 유형에 맞춰 보고·설명을 다듬는다.

트리거 키워드

보고, 보고하는 법, 두괄식, 결론부터, 상사 보고, 팀장 보고, 설명하는 법, 핵심 요약, 보고 정리, 구두 보고, 설명을 쉽게

워크플로우

1단계: 보고의 목적부터 한 줄로

보고는 자랑이 아니라 상대의 의사결정을 돕는 도구다. 먼저 한 줄로 정한다.

  • 이 보고로 상대가 뭘 결정·승인·인지해야 하는가?
  • 유형 구분: ① 승인 요청(결정해 주세요) ② 진행 공유(알고 계세요) ③ 문제 보고(도움이 필요해요)

→ 목적이 분명해야 결론이 분명해진다. 목적이 모호하면 보고도 길어진다.

2단계: 결론 먼저 (두괄식 구조)

핵심 한 문장을 맨 앞에 둔다. 배경·과정은 그다음이다.

순서내용예시
① 결론가장 중요한 한 문장"A안으로 진행 승인 부탁드립니다."
② 근거실제 확인된 사실과 자료"두 안의 비용과 일정 차이는 첨부 표에 있습니다."
③ 리스크·대안알아야 할 위험·다른 선택지"단, 외주 의존도가 올라갑니다."
④ 요청·다음 단계실제 결정이 필요한 내용"A안 진행 여부를 검토해 주세요."

→ "배경 설명부터 차근차근"은 보고가 아니라 회고다. 결론을 먼저 던지고, 질문이 오면 깊이 들어간다.

3단계: 상사 유형에 맞추기

같은 결론도 상대 성향에 따라 살을 다르게 붙인다.

  • 결론형(바쁜 임원): 한 줄 결론 + 숫자. 디테일은 묻기 전엔 생략, 부록으로.
  • 디테일형(꼼꼼한 상사): 결론 뒤에 근거·데이터·검증 과정을 준비. 예상 질문 미리 대비.
  • 관계형(맥락 중시): 누가·왜 영향받는지, 이해관계자 반응까지 한 줄 곁들이기.
  • 위험을 먼저 묻는 상대: 확인된 위험과 가능한 대비책을 함께 제시하기.

→ 상대가 던질 질문을 미리 2~3개 예상해 답을 준비하면 보고가 면담으로 안 번진다.

4단계: 상대 뇌에 꽂히는 설명 순서

설명이 안 통할 땐 보통 듣는 사람이 모르는 전제를 건너뛴 것이다.

  1. 상대가 이미 아는 것에서 출발: 새 개념을 익숙한 것에 빗대기
  2. 전체 → 부분: 큰 그림(왜·무엇) 먼저, 세부(어떻게)는 나중
  3. 하나에 하나씩: 한 문장에 정보 한 개. 접속사로 욱여넣지 않기
  4. 검증된 숫자·예시 활용: 측정 자료가 있을 때만 수치를 쓰고, 예시는 실제인지 가상인지 밝히기

5단계: 30초 압축 + 부록 분리

  • 30초 버전: 결론 + 근거 1개 + 요청. 엘리베이터에서도 통하게.
  • 3분 버전: 위 + 근거 전체 + 리스크·대안.
  • 부록: 데이터·과정·세부는 따로 빼두고 "필요하면 자료 있습니다"로 마무리.

→ 처음부터 다 쏟지 말고 계층으로 준비한다. 상대가 깊이를 정하게 한다.

6단계: 존댓말·톤 맞추기

보고 스크립트는 수신자의 관계와 조직 문체에 맞춥니다. references/kr-honorific-tone.md는 선택 가능한 표현 예시이며, 직급만으로 말투나 서명을 확정하지 않습니다.

사용 예시

예시 1: "프로젝트가 2주 늦어질 것 같은데 팀장님한테 어떻게 보고하지?" → 결론 먼저("일정 2주 지연 예상, 만회안 함께 보고드립니다") → 원인 1줄 → 만회 대안 2개 → 필요한 의사결정 형태로 재구성

예시 2: "신규 기능을 비개발자 임원한테 설명해야 하는데 자꾸 못 알아들어" → 익숙한 비유로 출발 → 전체 가치 먼저 → 동작은 한 단계씩 → 숫자·화면 예시로 고정

예시 3: "보고할 때마다 말이 길어지고 결론이 뒤로 가" → 결론·근거·리스크·요청 4블록 템플릿 → 30초/3분 2버전 + 예상 질문 3개 준비

산출물

  • 보고 목적 한 줄(승인/공유/문제)
  • 결론 먼저 4블록 보고 스크립트(결론·근거·리스크·요청)
  • 상사 유형별 보고 변형안
  • 30초/3분 2버전 + 부록 분리안
  • 예상 질문 2~3개와 답변

주의사항

  • 두괄식은 "배경 생략"이 아니라 "배경을 뒤로"다. 필요하면 묻는 순간 꺼낸다.
  • 나쁜 소식일수록 더 빨리, 더 결론 먼저 보고한다. 숨기면 신뢰를 잃는다.
  • 숫자는 정확히. 어림수로 보고하면 디테일형 상사에게 신뢰가 깎인다.

관련 스킬

  • moai-coworker:collab-meeting: 보고가 회의로 이어질 때 진행 설계
  • moai-coworker:collab-feedback-loop: 진행 중 중간 보고·피드백 요청
  • moai-coworker:collab-conflict: 까다로운 상사·반응에 대한 대응
  • moai-officer:doc-docx: 구두 보고를 문서 보고서로 정리

후처리 체인 (보고 스크립트·설명문 등 서술형 산출물)

보고 스크립트·설명문은 결론과 요청이 먼저 보이는지, 수치·일정·책임자가 확인된 자료와 맞는지, 문장이 실제로 말하기 자연스러운지 직접 검수한다. 아래 스킬은 현재 앱에 노출된 경우에만 추가로 사용한다.

  • moai-coworker:ai-slop-reviewer: 노출된 경우 표현 추가 검수
  • moai-writer:korean-humanize: 별도 설치돼 노출된 경우 한국어 문장 추가 윤문. 보고 근거·요청은 보존

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

  • 긴 문서·보고서 자체를 작성: moai-coworker:collab-productivity-report 또는 moai-coworker:collab-exec-summary를 사용한다. 이 스킬은 말과 구조에 집중한다.
  • 공식 성과평가 면담: 평가·고과 피드백은 moai-recruiter:hr-performance-review를 사용한다.
  • 마케팅 카피 작성: 요청한 채널에 맞는 moai-marketer 스킬을 사용한다.

References

파일로드 조건
references/kr-honorific-tone.md존댓말·톤 공유 규격 (이 스킬이 물리 소유). 수신자 위계별 종결어미·서명·요청/거절/사과/독촉 화법이 필요할 때 — 이메일·보고·CS 응대·협상·공지 스킬이 공동 참조

출처

결론 먼저 설명하는 일반적인 대화 구성 예시다. 사용자 자료는 실제로 제공된 경우에만 반영한다.

로드맵 관리 (Roadmap Manager)

개요

프로젝트 및 파트너십 전문 스킬입니다. 프로젝트 트래커(일정, 마일스톤, 리소스 관리), 파트너십 개발(전략적 제휴, MOU, 공동사업 기획), 지속가능성 감사(환경 영향 평가, 지속가능성 지표), 다양성 & 포용(DEI 전략, 포용적 조직 문화 설계)을 지원합니다.

트리거 키워드

로드맵, 마일스톤, 프로젝트 관리, 일정, 리소스, 파트너십, MOU, 제휴, 지속가능성, DEI

워크플로우

전략 가이드 로드 및 실행

사용자 요청 수신 → 해당 전략 가이드 판별 → references/{id}.md 로드 → 전략 가이드에 따라 실행 → 결과물 생성 후 사용자 검토 요청

복잡한 판단은 실제 자료·제약·가정을 분리해 검토합니다. 현재 앱에서 제공되지 않는 추론 도구나 키워드를 필수 실행 경로로 가정하지 않습니다.

사용 예시

  • "신규 서비스 출시 6개월 로드맵을 만들어줘"
  • "분기별 마일스톤과 담당자를 정리해줘"
  • "스타트업과의 MOU 협력 초안을 작성해줘"
  • "ESG 공시 대응 지속가능성 감사 체크리스트를 만들어줘"
  • "조직 내 DEI 정책 도입 로드맵을 설계해줘"

출력 형식

  • 프로젝트 로드맵 (마일스톤, 일정, 리소스 배분)
  • 파트너십 MOU 초안
  • 지속가능성 감사 보고서
  • DEI 전략 문서

주의사항

상황해결 방법
이해관계자 요구사항 상충우선순위 기준(고객 영향도 vs 기술 난이도 vs 비즈니스 가치)으로 정렬 매트릭스를 만들어 드립니다
우선순위 기준 불명확RICE(Reach·Impact·Confidence·Effort) 또는 MoSCoW 방법론으로 기준을 함께 설계합니다
리소스 배분 충돌담당자 역할·책임 매트릭스(RACI)를 작성해 역할을 명확히 합니다
ESG 규정 파악 어려움현재 금융위원회·KSSB 발표와 대상 기업의 적용 여부를 확인합니다

도구·제도 확인

로드맵 관리 도구 트렌드

도구검토할 사용처확인할 사항
Jira개발 작업 추적현재 조직의 계정·연결 권한
Notion문서·데이터베이스실제 자료 위치와 공유 범위
Linear이슈·사이클프로젝트와 현재 상태
Asana작업 추적조직의 워크플로우
Figma디자인 자료로드맵과 연결할 디자인 파일

한국 기업 파트너십 개발 특성

  • MOU 체결 문화: MOU는 사업 협력 공식화의 첫 단계. 구속력보다 협력 의지 표명 성격 강함
  • 대기업 협력: 실제 상대 기업의 협력사 등록·심사 기준과 일정을 확인
  • 스타트업 생태계: 판교·홍릉·성수 클러스터 중심. 투자사 네트워크 파트너십 전략 중요

ESG 지속가능성 공시

  • 적용 범위: 금융위원회의 현재 제도화 방안과 회사 유형·자산 기준을 대조한다. 예전 자산 2조 원 문구를 현재 의무로 쓰지 않는다.
  • 기준: KSSB 공시기준 공표를 확인하고 해당 기업에 실제 적용되는 기준만 사용한다.
  • 공급망 요청: 거래처가 요구한 지표·검증 수준을 확인하며 모든 중소기업에 동일한 의무가 있다고 단정하지 않는다.

관련 스킬

스킬사용 시점
moai-coworker:collab-spec제품 기능 명세(PRD) 작성
moai-lawyer:legal-contract-review법적 구속력 있는 계약서 작성
moai-accountant:finance-financial-statements재무·투자 의사결정

후처리 체인

MOU 초안·지속가능성 감사 보고서·DEI 전략 문서의 본문은 일정·권한·제도 적용 범위·근거와 대조해 이 스킬에서 직접 검수합니다. 로드맵 일정표·RACI 매트릭스 같은 표·데이터는 산문 후처리에서 제외합니다. 추가 스킬은 현재 앱에 노출된 경우에만 사용합니다:

moai-coworker:collab-roadmap → 자체 근거·문체 검수 → (노출된 경우) ai-slop-reviewer → (별도 설치된 경우) korean-humanize

  • moai-coworker:ai-slop-reviewer: 노출된 경우 상투적 표현·과장·군더더기를 추가 점검합니다.
  • moai-writer:korean-humanize: 별도 설치돼 노출된 경우 한국어 문장을 추가 윤문합니다. 일정·권한·제도 적용 범위·근거는 보존합니다.

References

파일로드 조건
references/project-tracker.md프로젝트 관리 요청 시 (계획 수립→마일스톤 추적→리소스 할당→위험 관리→상태 보고)
references/partnership-development.md파트너십 개발 요청 시 (파트너 식별→제안 작성→협상→거버넌스→공동 마케팅)
references/sustainability-audit.mdESG 지속가능성 감사 요청 시 (환경 분석→사회 평가→거버넌스 검토→ESG 보고→개선 계획)
references/diversity-inclusion.mdDE&I 전략 요청 시 (전략 수립→정책 설계→편향 감시→ERG 운영→교육 프로그램)

영업 플레이북

특정 고객사나 고객군을 상대로 반복해서 쓸 수 있는 접근 방법을 정리한다. 사용자가 제공한 제품 설명, 가격, 고객 자료, 실제 영업 기록을 먼저 확인한다. 외부 자료가 필요한 경우 접근 가능한 공식 공시·고객사 자료 등을 조회하고 출처와 확인일을 적는다. 조회하지 못한 사실은 확인 필요로 표시한다.

작성 순서

  1. 범위 확인: 판매 제품, 대상 고객군, 영업 목표, 사용 가능한 채널과 제약을 정리한다. 빠진 정보가 있어도 가능한 범위의 초안을 만들고 결정에 꼭 필요한 항목만 묻는다.
  2. 고객 이해: 확인된 고객사의 업무, 구매 절차, 관여 부서를 기록한다. 회사 규모·매출·예산·조직도·담당자의 의도를 근거 없이 채우지 않는다. 고객사가 지정되지 않았다면 고객군 가설로 표시한다.
  3. 접근 전략: 고객의 확인된 문제와 제품의 입증된 기능을 연결한다. 채널별 첫 연락 문안, 발견 질문, 다음 단계의 조건을 제시한다. 연락처 수집이나 발송은 사용자의 요청과 해당 도구의 권한 범위에서만 한다.
  4. 예상 질문: 가격, 도입 부담, 보안, 경쟁 대안 등 관련 있는 질문을 고른다. 답변은 확인된 제품 자료와 사례를 인용한다. 자료가 없으면 답을 만들어내지 않고 확인할 담당자나 자료를 적는다.
  5. 측정 계획: 실제로 기록할 수 있는 리드, 미팅, 제안, 계약 지표를 선택한다. 기준값·목표값은 제공된 데이터와 사용자 목표에서만 가져온다. 없으면 측정 방법과 기준값 수집 계획을 쓴다.
  6. 검수: 사실, 가설, 권장 행동을 구분하고 각 외부 주장에 출처를 붙인다. 경쟁사 우위, ROI, 절감액, 도입 기간, SLA, 고객 사례는 검증된 자료가 있을 때만 확정 표현으로 쓴다.

출력 틀

# [제품 또는 고객군] 영업 플레이북

## 입력과 근거
- 제품·가격·고객 범위: [제공 자료]
- 확인되지 않은 정보: [확인 과제]

## 고객과 구매 맥락
- 확인된 사실: [출처]
- 검증할 가설: [질문 또는 필요한 자료]

## 접근 전략
| 채널 | 선택 이유 | 첫 메시지 | 다음 단계 |
|---|---|---|---|

## 예상 질문과 답변
| 질문 | 확인할 쟁점 | 근거 있는 답변 또는 확인 과제 |
|---|---|---|

## 측정과 개선
| 지표 | 집계 기준 | 현재값·출처 | 목표·근거 |
|---|---|---|---|

## 실행 전 확인 사항
- [ ] 대외 문안의 제품 주장과 사례 확인
- [ ] 고객사 정보와 연락 권한 확인

사용자가 공공 입찰을 다룬다면 실제 공고와 제안요청서의 자격·평가·제출 요건을 확인한 뒤 해당 요건에 맞춰 작성한다. 공고 없이 낙찰 가능성이나 입찰 절차를 확정하지 않는다.

문체 검수가 필요하면 moai-coworker:ai-slop-reviewer나 moai-writer:korean-humanize를 사용할 수 있다. 검수 과정에서도 숫자와 사실의 근거를 보존한다. 단일 제안서가 목적이면 moai-coworker:collab-proposal을 사용한다.

제품 명세와 AI 도입 검토

요청에 따라 references/product-manager.md 또는 references/ai-strategy.md를 읽고 필요한 부분만 적용한다. 자료가 없다는 이유로 제품, 사용자, 팀 규모, 예산, 일정, 예상 성과를 만들어내지 않는다. 확인된 요구와 제안, 미결정 사항을 구분한다.

진행 방법

  1. 사용자가 해결하려는 문제, 대상 사용자, 원하는 산출물과 제공 자료를 확인한다. 입력이 부족해도 가능한 초안을 먼저 작성하고 중요한 빈칸을 질문으로 남긴다.
  2. 기존 자료와 접근 가능한 근거에서 요구사항을 뽑는다. 상충하는 요구는 어느 자료에서 왔는지 보여주고 결정이 필요한 쟁점으로 남긴다.
  3. 사용자 요청 범위에 맞는 문서만 작성한다. PRD 요청에 로드맵·스프린트 계획·회고를 자동으로 붙이지 않는다.
  4. 각 요구사항은 관찰 가능한 동작과 수용 기준으로 쓴다. 성능·보안·접근성 기준이 필요한 경우 해당 제품의 실제 제약과 검증 방법을 함께 적는다.
  5. 우선순위는 사용자가 정한 기준으로 매긴다. RICE, MoSCoW 같은 방법은 점수나 분류 근거가 있을 때 선택적으로 쓴다.
  6. 수치 목표와 일정은 사용자 입력이나 검증된 자료에 있을 때만 기입한다. 없으면 측정 방법, 기준값 수집, 결정 담당자를 제시한다.

PRD 기본 틀

  • 배경과 문제: 확인된 사용자 문제와 근거
  • 목표와 측정: 지표 정의, 기준값·목표값의 출처 또는 미정 표시
  • 범위: 포함·제외 기능, 사용자 흐름
  • 요구사항: 식별자, 동작, 우선순위 근거, 수용 기준
  • 제약과 의존성: 기술·운영·법적 검토가 필요한 항목
  • 결정 대기: 확인할 질문, 담당자, 필요한 자료

AI 도입 전략 요청은 현재 업무와 데이터 접근, 적용 후보, 작은 검증 방법, 비용과 위험, 성과 측정 방식을 정리한다. 실제 데이터 없이 ROI나 성공 확률을 계산하지 않는다.

정부 일반 지원사업 신청서는 moai-consultant:consult-gov-grant, 학술·연구비 과제 신청서는 moai-tutor:education-grant-writer를 사용한다. 문체 검수가 필요하면 moai-coworker:ai-slop-reviewer와 moai-writer:korean-humanize를 선택적으로 사용하되 요구사항과 수치를 바꾸지 않는다.

참고 자료

파일사용 시점
references/product-manager.mdPRD·기능 명세·우선순위 요청
references/ai-strategy.mdAI 도입 검토·전략 요청

운영 현황 보고자 (Status Reporter)

개요

사용자가 제공하거나 접근을 허용한 자료에서 KPI와 운영 현황을 정리합니다. 데이터 연결이나 갱신 주기가 확인되지 않으면 실시간 대시보드·이상 탐지·예측 분석이 동작한다고 말하지 않습니다.

트리거 키워드

상태 보고, 현황 보고, 진행 현황, 마일스톤, KPI, 대시보드, 주간 보고, 월간 보고, 실적 정리, 성과 요약, OKR, 분기 보고, 경영 보고

워크플로우

  1. 보고 유형 판별: 주간/월간/분기/연간 중 선택, 보고 대상(팀/부서/경영진) 확인
  2. KPI 수집: 사용자가 제공한 자료나 실제 접근 가능한 파일에서 수치·기간·정의를 추출하고 출처를 기록
  3. 구조 생성:
    • 핵심 성과 요약 (Executive Summary)
    • KPI 달성 현황 표 (목표 vs 실적, 달성률)
    • 주요 마일스톤 진행 상황
    • 이슈 및 리스크 목록
    • 다음 기간 액션 아이템
  4. 검증: 목표·실적의 기간과 단위가 같을 때만 달성률을 계산하고, 원인이 확인되지 않은 변동은 가설로 표시
  5. 형식 선택: 요청한 텍스트·마크다운·스프레드시트 형식으로 정리하고 발송이 필요하면 초안을 검토

보고 원칙

  • 지표마다 정의, 산식, 측정 기간, 데이터 출처와 담당자를 적습니다.
  • 목표가 없으면 달성률을 만들지 않고 실제 관찰값만 제시합니다.
  • 전기 비교는 같은 집계 기준의 두 기간이 있을 때만 합니다.
  • 자동 수집과 정기 발송은 해당 연결·권한·일정이 실제로 설정된 경우에만 수행합니다.

보고서 템플릿 구조

주간 현황 보고 (Weekly Status Report)

[주간 보고] {팀/프로젝트명} — {YYYY}년 {M}월 {N}주차

■ 핵심 요약
- 이번 주 주요 성과: ...
- 완료 마일스톤: ...
- 다음 주 핵심 과제: ...

■ KPI 달성 현황
| 지표 | 목표 | 실적 | 달성률 | 추이 |
|------|------|------|--------|------|
| ... | ... | ... | ...% | ▲/▼/— |

■ 이슈 & 리스크
| 구분 | 내용 | 영향도 | 대응 계획 |
|------|------|--------|-----------|

■ 다음 주 액션 아이템
- [ ] ...

월간 운영 보고 (Monthly Operations Report)

전월 자료가 비교 가능하다면 변동 폭을 적습니다. 원인은 자료로 확인된 것과 확인할 가설을 나눕니다.

산출물

  • 마크다운 형식 주간/월간 보고서
  • KPI 달성 현황 표 (목표/실적/달성률/전기 대비)
  • 마일스톤 진행률 요약
  • 이슈 및 리스크 매트릭스
  • 다음 기간 액션 아이템 목록
  • 경영진/팀별 맞춤 어조 조정 버전

관련 스킬 (후처리 체인)

보고서의 서술형 본문(핵심 요약, 이슈·리스크 설명, 액션 아이템 등)은 수치·기간·출처와 원인 가설을 대조하고, 과장·모호한 표현을 직접 검수합니다. 현재 앱에 아래 스킬이 노출돼 있으면 추가로 사용합니다.

collab-status-report → 자체 근거·문체 검수 → (노출된 경우) ai-slop-reviewer → (별도 설치된 경우) korean-humanize
  • moai-coworker:ai-slop-reviewer — 노출된 경우 서술형 본문의 AI 티 패턴을 추가 검수합니다.
  • moai-writer:korean-humanize — 별도 설치돼 노출된 경우 한국어 보고체를 추가로 다듬습니다. 수치와 미확인 표시는 보존합니다.

KPI 달성 현황 표, 마일스톤 진행률, 이슈·리스크 매트릭스 등 수치·표 산출물은 산문 후처리 대상이 아닙니다. 이 스킬에서 마크다운 표를 완성하고, 사용자가 엑셀 파일이나 대시보드를 요청했고 해당 플러그인이 현재 앱에 노출됐을 때만 moai-officer:doc-xlsx 또는 moai-analyst:data-visualizer로 연결합니다.

참고 사항

  • 공공기관 보고: 해당 기관이 제공한 양식과 지침을 확인한 뒤 적용
  • 결재 디지털화: 결재 문서용 포맷(공문서 스타일)으로 변환 지원
  • ESG 연계: 요청받은 지속가능성 지표가 있으면 적용 대상·기준과 원자료를 먼저 확인
  • 보안 주의: 재무 데이터, 인사 정보 포함 시 배포 범위 재확인 권장

문제 해결

상황해결 방법
결재 라인 정보 부족조직도나 결재 단계를 알려주시면 수신자별 맞춤 어조로 작성해 드립니다
KPI 데이터 미제공측정 가능한 지표 목록을 먼저 설계해 드릴 수 있습니다
보고 양식이 정해져 있음기존 양식이나 템플릿을 공유해 주시면 그 형식에 맞춰 작성합니다
이전 보고서와 비교 필요이전 보고서 내용을 함께 입력해 주시면 전기 대비 분석을 포함합니다

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

  • 실제 ERP·BI 시스템 데이터 조회 → 해당 시스템에 직접 접속해야 합니다
  • 재무제표 공식 작성 → moai-accountant:finance-financial-statements 스킬이 더 적합합니다
  • 인사 성과 평가 보고서 → moai-recruiter:hr-performance-review 스킬을 사용하세요
  • 마케팅 성과 분석 → moai-marketer:marketing-performance-report 스킬이 더 적합합니다

References

파일로드 조건
references/kpi-dashboard.mdKPI 대시보드 설계 시 (대시보드 유형별 갱신 주기·SMART 기준 KPI 선정)
references/reporting-standards.md운영 보고서 작성 시 (KPI 대시보드 구성 원칙·주간 보고 템플릿 등 표준 가이드)

UX 디자인 검토

사용자가 제공한 화면, 와이어프레임, 프로토타입, 실제 제품 중 접근 가능한 자료를 먼저 확인한다. 화면이 없고 설명만 있다면 설계 검토와 확인 질문을 제시할 수 있지만 특정 UI 결함을 관찰한 것처럼 쓰지 않는다.

검토 절차

  1. 대상과 범위: 플랫폼, 주요 사용자, 핵심 작업, 검토할 화면·상태와 접근 가능한 자료를 기록한다.
  2. 사용성: 화면에서 관찰한 단계·오류 복구·상태 표시·용어 일관성을 점검한다. 휴리스틱은 문제를 설명하는 도구로 사용하며 모든 항목을 억지로 채우지 않는다.
  3. 접근성: 웹 콘텐츠라면 적용할 W3C WCAG 2.2 성공 기준과 수준을 확인한다. 스크린샷만으로 키보드 동작, 스크린리더 출력, 실제 대비, 코드 구조의 적합성을 확정하지 않는다. 해당 검사는 실행 가능한 제품과 도구가 있을 때 수행한다.
  4. 플로우: 제공된 경로에서 완료·실패·되돌아가기·빈 상태를 살핀다. 사용자 행동 데이터나 테스트 기록이 없다면 이탈 원인과 전환율 영향은 가설로 둔다.
  5. 개선안: 관찰 근거, 영향받는 작업, 수정 제안, 검증 방법을 짝지어 쓴다. 긴급도는 실제 영향과 사용자 제약을 바탕으로 정하고 근거 없는 RICE 점수나 고정 기간 로드맵은 만들지 않는다.

출력 틀

화면·작업관찰 내용과 근거관련 기준영향과 불확실성제안확인 방법

화면이 없으면 관찰 결과 표 대신 필요한 화면·상태·사용자 자료 목록과 검토 계획을 낸다. 접근성 검토는 관찰한 항목, 미검사 항목, 적용 기준을 분리한다. 법적 준수 판정은 해당 관할·제품의 실제 요구와 검증 범위를 확인한 뒤 별도로 다룬다.

사용자 인터뷰·설문·VOC 분석은 moai-coworker:collab-ux-research, 요구사항 문서화는 moai-coworker:collab-spec을 사용한다. 문체를 다듬을 때도 결함의 근거와 미검사 표시를 지우지 않는다.

UX 리서치

요청에 맞춰 references/ux-research.md 또는 references/user-feedback-analysis.md를 읽는다. 인터뷰를 계획하는 일과 이미 수집된 응답을 분석하는 일을 구분한다. 접근하지 못한 고객 기록이나 수행하지 않은 인터뷰를 조사 결과로 제시하지 않는다.

진행 방법

  1. 연구 질문, 대상 사용자, 제품 단계, 사용자가 제공한 자료와 사용할 수 있는 채널을 확인한다.
  2. 계획 요청에는 참여자 기준, 질문·과제, 동의와 기록 방법, 관찰할 지표를 제안한다. 모집·발송·녹음은 명시된 권한과 실제 도구가 있을 때만 진행한다.
  3. 분석 요청에는 자료의 출처·기간·표본·누락·선택 편향을 적고 원문과 해석을 분리한다. 개인 식별 정보는 보고 목적에 맞게 최소화한다.
  4. 페르소나는 실제 연구 자료에서 확인된 패턴으로 만들고, 자료가 없으면 검증 전 가설 페르소나로 표시한다. 개수는 데이터가 뒷받침하는 만큼만 정한다.
  5. NPS나 CSAT는 질문 문항, 응답 척도, 응답 수와 집계 방식을 확인한 뒤 계산한다. 숫자 하나만 제공됐다면 산식이나 원인을 역추정하지 않는다.
  6. 발견과 권고를 원자료에 연결하고, 후속 검증 방법을 제안한다. 표본의 범위를 넘어 전체 고객의 선호라고 단정하지 않는다.

출력

요청에 맞는 인터뷰 가이드, 사용성 테스트 계획, VOC 분류표, 설문 해석, 검증 전 페르소나 또는 연구 결과 요약을 낸다. 각 발견에는 근거 자료와 불확실성을 붙인다. 문체를 다듬을 때 인용문의 의미와 수치를 보존한다.

화면 자체의 사용성·접근성 평가는 moai-coworker:collab-ux-design을 사용한다.

참고 자료

파일사용 시점
references/ux-research.md인터뷰·사용성 테스트·페르소나 계획
references/user-feedback-analysis.mdVOC·설문·NPS 분석

공급업체 관리

요청에 맞는 참고 문서만 읽는다. 공급업체 선정 기준과 실제 업체 평가 결과를 구분한다. 견적·계약·납품·품질 자료를 보지 않았다면 점수, 위험 수준, 이행률을 만들지 않는다.

요청참고 문서
계약 절차와 점검references/contract-management.md
공급망·재고 검토references/supply-chain.md
위험 등록부references/risk-register.md
수출입 검토references/import-export.md

진행 방법

  1. 구매 품목·서비스, 거래 국가, 후보 업체, 조직의 구매 권한과 실제 자료를 확인한다.
  2. 평가 기준과 가중치는 구매 목적과 조직 규정으로 정한다. 조직 기준이 없다면 선택 가능한 항목을 제안하고 가중치는 미정으로 둔다.
  3. 업체별 증빙의 출처·일자를 적고 미확인 항목은 평가 보류로 표시한다. 업체의 재무 상태, 인증, 납기 실적을 추정하지 않는다.
  4. 위험은 원인·영향·조기 신호·대응·담당자를 연결한다. 발생 확률과 비용 영향은 관련 자료가 있을 때만 수치화한다.
  5. 계약·법령·통관 관련 결론은 거래 유형, 당사자 지위, 관할, 최신 원문을 확인한 뒤 해당 전문 스킬이나 담당자의 검토로 넘긴다. 계약 체결·발주·지급·신고는 초안 작성과 별도 작업이다.

결과는 평가 기준표, 업체별 근거표, 미확인 사항, 실행 전 확인 목록으로 정리한다. 법적 계약서 해석은 moai-lawyer:legal-contract-review, 회계·지급은 관련 회계 스킬에 연결한다. 문체 후처리를 하더라도 수치와 근거를 보존한다.

플러그인 피드백

modu-ai/moai-cowork 플러그인에 관한 버그·개선 요청을 기록한다. 단순 사용법 질문은 해당 플러그인의 안내로 연결한다. 사용자가 등록을 요청했다면 필요한 내용을 정리해 진행한다. 초안만 요청한 경우에는 등록하지 않는다.

진행 순서

  1. 대상 확인: 어느 플러그인·스킬인지, 사용한 앱과 운영체제, 버전, 문제 상황을 제공된 정보에서 추출한다. 모르는 항목은 미확인으로 둔다.
  2. 증거 정리: 버그는 재현 절차·기대 동작·실제 결과·오류 메시지를 구분한다. 기능 제안은 사용 시나리오와 원하는 동작을 적는다. 재현하지 않았다면 재현 확인을 주장하지 않는다.
  3. 민감 정보 제거: 토큰, 개인 정보, 고객 문서 원문을 공개 이슈에 넣지 않는다. 공개하기 어려운 보안 취약점은 저장소의 현재 보안 제보 경로를 확인해 안내한다.
  4. 중복 확인: 접근 가능한 GitHub 이슈에서 같은 문제를 검색한다. 중복이면 기존 이슈와 차이를 정리한다.
  5. 등록: 사용자의 등록 요청과 GitHub 권한이 있으면 이슈를 생성한다. 앱이나 연결 도구에 이슈 생성 기능이 있으면 이를 사용하고, CLI를 쓴다면 GitHub CLI 공식 gh issue create 문서의 --body-file로 본문 파일을 전달한다. 레이블은 실제 저장소에 있는 것만 붙인다.
  6. 확인: 생성 결과의 번호·URL을 읽어 보고한다. 생성 명령이 모호하게 실패했다면 같은 제목의 이슈를 먼저 조회하고 중복 생성하지 않는다.

이슈 본문

## 대상과 환경
- 플러그인·스킬:
- 앱·운영체제·버전:

## 문제 또는 제안
[사용자가 설명한 내용]

## 재현 절차와 관찰 결과
[버그인 경우에만, 확인되지 않은 단계는 미확인 표시]

## 기대 동작
[사용자 기대]

## 추가 자료
[공개 가능한 로그·화면·관련 이슈]

GitHub 연결이나 권한이 없으면 등록하지 못했다는 사실과 함께 복사 가능한 초안 및 https://github.com/modu-ai/moai-cowork/issues/new를 제공한다. 이슈 생성 전후 상태를 혼동하지 않는다.

Skill Builder — 6-Phase 스킬 생성 워크플로우

moai-coworker | revfactory/harness 방법론 기반 스킬 생성

개요

harness 오픈소스의 6-Phase 스킬 생성 워크플로우를 모두의 코워크 컨텍스트에 맞게 변환한 스킬입니다. 수작업 스킬 작성의 품질 편차를 줄이고, 체계적인 생성 프로세스를 통해 일관된 품질의 스킬을 생산합니다.

이름 이력: v1.3.x까지 skill-forge로 제공되던 스킬이 v1.5.x에서 meta-skill-builder로 이름 변경되었습니다. 별칭은 유지되지 않으며 모든 참조는 meta-skill-builder로 갱신해야 합니다.

트리거 키워드

스킬 생성 스킬 제작 meta-skill-builder 새 스킬 만들기 스킬 추가 신규 스킬 harness 워크플로우

워크플로우

Phase 1: Requirements   → 사용자 의도 분석, 트리거 키워드 정의
Phase 1.5: Research     → 공식 자료·베스트 프랙티스 외부 조사 (현재 앱의 검색 기능, 관련 공식 문서 우선)
Phase 2: Architecture   → 에이전트 패턴 선택 (6종 중 매핑)
Phase 3: Skill Draft    → meta-skill-template 기반 SKILL.md 초안 + ## 출처 섹션
Phase 4: Test Gen       → 테스트 프롬프트 2-3개 + 기대 출력 정의
Phase 5: Validation     → 4차원 루브릭 스코어링 (meta-skill-tester 본문 §스코어링 루브릭)
Phase 6: Review         → 품질 게이트 통과 확인, 파일 배치

실행 규칙

Phase 1: Requirements (요구사항 분석)

사용자의 자연어 요청에서 스킬 요구사항을 추출합니다.

필수 수집 항목:

항목질문예시
목적"이 스킬이 해결할 문제는?""영업 제안서를 자동 생성하고 싶다"
타겟 플러그인"어느 플러그인에 배치할까?"moai-coworker
입력"사용자가 무엇을 입력하나?"회사명, 타겟 산업, 제품 정보
출력"어떤 산출물을 기대하나?"제안서 DOCX 파일
복잡도"스킬이 얼마나 복잡한가?"Standard (50-150줄)

출력물: 요구사항 요약. 확인이 필요한 항목은 현재 앱의 질문 기능 또는 대화로 묻고, 질문 기능이 없는 하위 실행은 누락 항목을 상위에 반환합니다.

Phase 1.5: Research (외부 자료 조사) ★ v1.6.0 신설

스킬 도메인의 공식 자료·표준 양식·베스트 프랙티스를 조사하여 SKILL.md의 정확성과 권위를 확보합니다.

조사 트리거 (다음 중 하나라도 해당하면 Phase 1.5 의무):

  • 한국 법규·표준 양식 관련 (세무·노무·계약·채용·의료 등)
  • 외부 라이브러리·SDK·API·CLI 활용
  • 글로벌 베스트 프랙티스 인용이 필요한 도메인 (B2B SaaS·HR·BI·DevOps 등)
  • 정량 수치·통계 데이터·시장 규모 인용

조사 절차:

  1. 현재 앱에서 사용 가능한 검색·문서 열람 기능으로 조사

    • 한국어 쿼리 1-2회: "<도메인> <핵심 키워드> <연도>" 형식 (예: "한국 채용절차법 NCS 2026")
    • 영어 쿼리 1-2회 (글로벌 베스트 프랙티스 인용 시): "<topic> best practice <year>" 형식
    • 검색 결과의 최신성 확인 (2년 이내 자료 우선)
  2. 라이브러리·SDK·CLI 관련 스킬일 때

    • 공식 문서와 릴리스 노트에서 현재 API·CLI와 폐기된 기능을 확인
    • Context7 MCP가 연결된 경우에는 보조 자료로 활용하고 원저작자 문서와 대조
  3. 도메인별 공식 출처 화이트리스트 (우선 인용):

    도메인1차 권장 출처
    한국 세무·재무국세청 nts.go.kr, 홈택스 hometax.go.kr, DART dart.fss.or.kr
    한국 노무·채용고용노동부 moel.go.kr, NCS ncs.go.kr, 한국노동연구원 kli.re.kr
    한국 의료·건강식약처 mfds.go.kr, 보건복지부 mohw.go.kr, 건강보험공단 nhis.or.kr
    한국 정부지원K-Startup k-startup.go.kr, BIZINFO bizinfo.go.kr
    한국 통계·시장KOSIS kosis.kr, 한국은행 ECOS ecos.bok.or.kr
    한국 법률국가법령정보센터 law.go.kr, 대법원 종합법률정보 glaw.scourt.go.kr
    글로벌 회계 표준K-IFRS, IFRS Foundation ifrs.org
    글로벌 채용 규제EEOC eeoc.gov, NYC Local Law 144, ISO 42001:2023
    글로벌 SaaS BP제품 공식 문서(HubSpot·Salesforce·Greenhouse 등) + 업계 리딩 블로그
  4. 출처 보존:

    • 조사 결과의 URL·발행일·핵심 인용 문장을 인메모리에 보존
    • Phase 3에서 SKILL.md ## 출처 섹션에 markdown hyperlink 형식으로 인용
    • 정량 수치는 출처 인라인 표기 또는 [추정] 태그 강제

산출물: research notes (인메모리, Phase 3 입력으로 전달)

금지:

  • 출처 없는 정량 수치 인용 (반드시 출처 명시 또는 [추정] 태그)
  • 한국 도메인 스킬에 한국 공식 출처 누락
  • 라이브러리·SDK 관련 스킬에서 공식 문서 확인 없이 도구 가용성만으로 API를 단정
  • 구버전 자료 인용 (3년 초과 시 최신 자료 재검색)

스킵 조건 (Phase 1.5 생략 가능):

  • 단순 포맷 변환·텍스트 처리 스킬 (도메인 지식 불필요)
  • 사용자가 명시적으로 --skip-research 플래그 지정
  • 기존 cowork 스킬의 minor 개선·트리거 키워드 조정만

Phase 2: Architecture (아키텍처 선택)

6개 에이전트 패턴 중 최적 패턴을 선택합니다.

패턴적용 시나리오스킬 예시
Pipeline순차 처리, 각 단계 출력이 다음 입력doc-docx, content-blog
Fan-out/Fan-in병렬 분석 후 결과 통합collab-ux-design, market-analysis
Expert Pool다 도메인 전문 지식 결합consult-brief, consult-startup
Producer-Reviewer생성 + 품질 검토 순환collab-sales-playbook, content-copywriting
Supervisor다수 전문 스킬 오케스트레이션moai-coworker:ai-diagnostic, project
Hierarchical Delegation복잡 작업 계층적 분해consult-startup

선택 기준: 스킬의 워크플로우 단계 수, 병렬성 여부, 품질 검증 필요성을 기준으로 판단합니다.

출력물: 선택된 패턴 + 근거 (1-2문장)

Phase 3: Skill Draft (스킬 초안 생성)

meta-skill-template 템플릿을 기반으로 SKILL.md 초안을 생성합니다.

필수 적용:

  1. meta-skill-template의 필수 섹션 구조 사용
  2. Frontmatter에는 name, description, 문자열 metadata.version을 포함하고 Agent Skills 공통 규격을 검사
  3. 트리거 키워드는 대상 플러그인의 실제 스킬 목록과 대조해 중복을 검사
  4. 사용 예시 최소 2개 포함
  5. 관련 스킬 섹션에 before/after/alternative 관계 명시
  6. ## 출처 섹션 의무: Phase 1.5에서 수집한 URL·인용을 markdown hyperlink로 명시 (Phase 1.5 적용 스킬)
  7. 정량 수치 인용 규칙: 모든 수치는 출처 인라인 표기 또는 [추정] 태그

참조: moai-coworker:meta-skill-tester (plugins/moai-coworker/skills/meta-skill-tester/SKILL.md §스코어링 루브릭 (품질 기준 single source) 참조: moai-coworker:meta-skill-template (plugins/moai-coworker/skills/meta-skill-template/SKILL.md (템플릿)

출력물: <target-plugin>/skills/<skill-name>/SKILL.md 초안

Phase 4: Test Generation (테스트 생성)

스킬 검증용 테스트 케이스를 생성합니다.

테스트 구성:

skill: <skill-name>
version: 0.1.0
test_cases:
  - id: TC-001
    name: "happy-path"
    prompt: "<대표적인 사용 프롬프트>"
    assertions:
      - type: format
        value: "<markdown|json|text|html>"
      - type: contains
        value: "<필수 포함 내용>"
      - type: not_contains
        value: "<금지 내용>"

  - id: TC-002
    name: "edge-case"
    prompt: "<경계 조건 프롬프트>"
    assertions:
      - type: handles_gracefully
        value: true

  - id: TC-003
    name: "complex-input"
    prompt: "<복잡한 입력 프롬프트>"
    assertions:
      - type: contains
        value: "<복잡한 입력에서 반드시 반영할 항목>"

출력물: <skill-dir>/tests/test-cases.yaml

Phase 5: Validation (품질 검증)

4차원 루브릭으로 스킬을 평가합니다.

차원가중치평가
Correctness30%목적 달성 여부
Completeness25%에지 케이스 커버
Clarity25%사용자 이해 가능성
Efficiency20%토큰 대비 품질

통과 기준: 실행 결과가 관측됐을 때 기존 스킬은 가중 평균 >= 0.70, 신규 스킬은 >= 0.75이며 모든 차원은 >= 0.50입니다. 실행하지 못한 검사는 NOT-RUN으로 표시합니다.

미달 시: Phase 3으로 돌아가서 부족한 차원을 보완합니다. 최대 3회 반복.

참조: moai-coworker:meta-skill-tester (plugins/moai-coworker/skills/meta-skill-tester/SKILL.md §스코어링 루브릭 (anchor 점수표 + 평가 절차)

Phase 6: Review (최종 검토)

배포 전 최종 체크리스트를 실행합니다.

체크리스트:

  • Frontmatter 형식 준수 (name, description, metadata.version과 공통 허용 필드)
  • 필수 섹션 모두 존재 (개요, 트리거, 워크플로우, 예시, 출력, 주의사항, 관련 스킬)
  • 트리거 키워드가 기존 스킬과 중복되지 않음
  • 수정한 스킬의 version, 양쪽 plugin.json, 마켓플레이스 버전을 같은 변경에서 갱신
  • 스킬 체인 관계가 프로젝트의 스킬 체인 정의와 일치 (해당 시)
  • 테스트 케이스가 생성됨
  • 실제 실행 결과를 바탕으로 기존 스킬 0.70 이상, 신규 스킬 0.75 이상 통과. 미실행 검사는 NOT-RUN
  • ## 출처 섹션 존재 (Phase 1.5 적용 스킬, --skip-research 미지정 시)
  • 정량 수치 모두 출처 또는 [추정] 태그 (Phase 1.5 적용 스킬)

배치: <target-plugin>/skills/<skill-name>/SKILL.md 에 최종 파일을 배치합니다.

사용 예시

예시 1: 신규 스킬 생성

"moai-coworker에 영업 제안서 자동 생성 스킬을 만들어줘. 회사명과 타겟 기업 입력하면 제안서 DOCX가 나오게"

예시 2: Vibe 갭 스킬 생성

"meta-skill-builder로 moai-coworker에 UX 디자인 분석 스킬을 만들어줘. Vibe Designing 기능 참고해서"

출력 형식

산출물위치설명
SKILL.md<plugin>/skills/<name>/SKILL.md완성된 스킬 정의
test-cases.yaml<plugin>/skills/<name>/tests/테스트 케이스
score-report인메모리루브릭 스코어 보고서

주의사항

  • 기존 스킬 수정이 아닌 신규 스킬 생성에만 사용합니다
  • 플러그인 디렉토리(moai-*)가 존재하는지 사전 확인이 필요합니다
  • 스킬을 생성·수정하면 해당 플러그인의 Claude·Codex 매니페스트와 마켓플레이스 버전을 함께 갱신합니다.
  • 트리거 키워드 중복 시 기존 스킬의 description을 확인하여 명확히 구분해야 합니다

한국어 예시 카피 작성 규칙 (슬롭 방지)

신규 스킬에 한국어 예시 카피를 넣을 때 AI 슬롭 패턴이 예시로 전염되지 않도록 아래 3종을 금지합니다. 이 규칙은 ai-slop-reviewer·korean-humanize 게이트가 슬롭으로 분류하는 패턴이 "좋은 예"로 등록되는 것을 원천 차단합니다.

#금지 패턴설명[나쁜 예] (슬롭)권장 예시
1대시 대비 헤드라인대시(—)로 문장을 분할하는 "X — Y" 구조 (대시 대비 헤드라인)[나쁜 예] "복붙에서 위임으로 — 목표만 주면"완결된 문장으로 작성
2조사·체언 종결 조각문조사(~은/에/로)나 체언으로 끝나는 파편문 (조사·체언 종결)[나쁜 예] "성공의 열쇠 — 자동화"서술어를 갖춘 완전문
3"A에서 B로" 전환 공식"X에서 Y로" 전환 공식 도입 (슬롭 상투문)[나쁜 예] "엑셀에서 노션으로"구체적 사례로 시작

예시 카피에는 이 슬롭 패턴을 넣지 마세요 — 새 스킬이 슬롭을 가르치는 원천이 되지 않도록 합니다.

관련 스킬

스킬관계설명
meta-skill-templatebefore템플릿 구조를 제공하는 기반 스킬
meta-skill-testerafter생성된 스킬의 테스트 실행 + 루브릭 스코어링
ai-slop-reviewerafter스킬 본문의 AI 패턴 검수 (선택)

실행 진입점

현재 앱에 이 스킬이 노출돼 있으면 자연어로 스킬 제작을 요청합니다. meta-skill-tester의 검증과 ai-slop-reviewer의 문체 검수는 각 스킬이 노출된 경우에만 연결합니다. 이 플러그인은 별도 /harness 명령을 제공하지 않습니다.


Source: revfactory/harness 6-Phase workflow (Apache 2.0) + MoAI adaptation

Changelog

  • 재정립 전 1.6.0 (2026-05-01): Phase 1.5 Research 신설 — 외부 자료 조사(WebSearch·Context7) 의무화, 도메인별 공식 출처 화이트리스트 추가, ## 출처 섹션 의무화 + 정량 수치 출처/[추정] 태그 강제
  • 재정립 전 1.5.x: skill-forge → meta-skill-builder 이름 변경
  • 이전: harness 6-Phase 워크플로우 흡수

SKILL.md Standard Template

새 스킬 작성 시 아래 구조를 출발점으로 사용합니다. 실제 작업에 필요 없는 섹션은 넣지 않습니다.


Frontmatter Schema

---
name: <skill-name>                          # 필수. 소문자 하이픈 (예: doc-docx)
description: |                              # 필수. 목적 + 트리거 키워드
  <스킬 목적을 서술형으로 작성>
  다음과 같은 요청 시 반드시 이 스킬을 사용하세요:
  - "<트리거 문장 1>"
  - "<트리거 문장 2>"
metadata:
  version: "0.1.0"                       # 사용자 메타데이터는 문자열 값
---

name과 description은 양쪽 호스트가 스킬을 찾을 때 쓰는 핵심 정보입니다. 버전은 metadata.version 문자열로 유지합니다. 설명은 1~1024자이며 이름은 디렉터리와 일치해야 합니다. user-invocable 같은 호스트별 필드는 공통 템플릿에 넣지 말고, 해당 호스트의 최신 문서와 실제 앱 동작을 확인한 뒤 결정합니다. 사용자 명령 진입점이 필요하다면 양쪽 호스트에서 각각 지원하는 방식을 확인합니다.

참고: OpenAI 스킬 작성, OpenAI 스킬 개념, Agent Skills 규격.

공통 형식

허용 최상위 필드는 name, description, license, compatibility, metadata, allowed-tools입니다. 추가 정보는 문자열 값의 metadata에 넣습니다.

  • 최상위 version, 호스트 전용 user-invocable
  • keywords: (비표준)
  • 본문 상단 > vX.Y.Z | ... 버전 배너

본문 구조 (필요한 섹션 선택)

# <Skill Name> — <한 줄 요약>

> <플러그인명> | <카테고리>

## 개요

스킬의 목적과 핵심 기능을 2-4문장으로 설명합니다.
어떤 문제를 해결하는지, 누가 사용하는지, 언제 사용하는지를 포함합니다.

## 트리거 키워드

<스킬 활성화 키워드를 공백으로 구분하여 나열>
예: 보고서 작성 리포트 생성 docx 워드 문서

## 워크플로우

단계별 실행 흐름을 번호와 함께 나열합니다:

1. [단계명] — 설명
2. [단계명] — 설명
3. [단계명] — 설명

## 실행 규칙

### 1단계: <단계명>

상세 실행 규칙을 작성합니다.

| 조건 | 동작 |
|------|------|
| 케이스 A | 결과 A |
| 케이스 B | 결과 B |

### 2단계: <단계명>
...

## 사용 예시

사용자가 복사-붙여넣기 할 수 있는 실제 프롬프트를 최소 2개 제공합니다.

**예시 1: 기본 사용**
> "<자연어 프롬프트>"

**예시 2: 고급 사용**
> "<자연어 프롬프트>"

## 출력 형식

스킬이 생성하는 산출물의 형식을 명시합니다.

| 산출물 | 형식 | 설명 |
|--------|------|------|
| <산출물1> | <포맷> | <설명> |

## 주의사항

- 스킬 사용 시 주의할 점
- 한계점 및 제약사항
- 대안 스킬 참조 (해당 시)

## 관련 스킬

| 스킬 | 관계 | 설명 |
|------|------|------|
| <연관 스킬> | <before/after/alternative> | <설명> |

복잡도 가이드

티어대략적인 범위권장 내용검증
Simple짧은 작업목적, 실행 단계, 예시실행 가능한 사례 확인
Standard여러 단계입력·출력, 오류 처리, 예시정상·경계 사례 확인
Complex여러 도구·서비스단계 경계, 승인, 실패·재개 절차실제 호스트에서 체인 검증

품질 체크리스트

작성 완료 후 반드시 확인:

  • name, description, metadata.version이 공통 규격을 만족함
  • skills-ref 표준 검사와 저장소의 스킬 계약 검사를 통과함
  • 작업을 실행하는 데 필요한 입력·단계·출력·실패 처리가 설명됨
  • 실제 사용 상황에 맞는 예시가 있음
  • 트리거 키워드가 다른 스킬과 중복되지 않음
  • 워크플로우 단계가 순차적으로 실행 가능함
  • 관련 스킬이 있다면 연결 관계를 명시함
  • 플러그인에 넣는 경우 양쪽 매니페스트와 버전을 확인함

Source: revfactory/harness skill-writing-guide (Apache 2.0) + MoAI adaptation

Skill Tester — 스킬 품질 검증 도구 (루브릭 + 체인 내장)

moai-coworker | revfactory/harness 테스트 방법론 기반 single source of truth for: 4차원 스코어링 루브릭, 스킬 체인 검증 프로토콜

개요

meta-skill-builder로 생성된 스킬 또는 기존 스킬을 검토합니다. 대상 호스트에서 실행할 수 있으면 스킬 사용 전후 결과를 비교하고, 실행하지 못한 검사는 별도로 표시합니다. 4차원 평가 기준과 체인 검증 절차를 이 문서에 담았습니다.

트리거 키워드

스킬 테스트 검증 A/B 테스트 baseline 회귀 테스트 체인 테스트 meta-skill-tester 품질 측정 루브릭 스코어링 4차원 평가

워크플로우

1. [로드]    → 대상 스킬의 tests/test-cases.yaml 로드
2. [선택]    → 테스트 모드 선택 (A/B | 회귀 | 체인 | 루브릭 단독)
3. [실행]    → 사용 가능한 대상 호스트에서 테스트 프롬프트 실행
4. [기록]    → 실행 환경, 입력, 실제 출력과 확인 가능한 측정값 기록
5. [스코어]  → 관측한 결과에만 4차원 루브릭 적용
6. [비교]    → 비교 실행이 있을 때만 baseline과 with-skill 비교
7. [보고]    → PASS / FAIL / NOT-RUN과 미확인 항목 기록

실행 규칙

테스트 모드

Mode 1: A/B 테스트 (신규 스킬 검증)

meta-skill-builder Phase 5에서 사용하는 기본 모드입니다.

절차:

  1. Baseline 실행: 대상 호스트에서 스킬 없이 동일 프롬프트 실행
  2. With-Skill 실행: 같은 호스트·모델·설정에서 스킬을 로드한 뒤 실행
  3. 두 실행의 입력, 출력, 도구 호출, 모델과 설정을 기록합니다. 실행할 수 없으면 NOT-RUN으로 보고합니다.
  4. 비교 측정:
메트릭측정 방법판정
토큰 사용량호스트가 사용량을 제공할 때만 input + output 토큰관측값과 차이 보고
출력 품질관측한 결과를 동일 루브릭으로 평가점수와 근거 보고
정확성실행한 assertion의 통과율사전 정의한 기준과 비교
완전성필수 출력 포함 여부누락 항목 보고

반복 실행 횟수는 결과 변동성과 판단 목적에 맞춰 정합니다. 한 번의 예시는 전체 호스트의 성능을 대표하지 않습니다.

Mode 2: 회귀 테스트 (기존 스킬 수정 후)

스킬 수정 시 기존 테스트 케이스가 여전히 통과하는지 확인합니다.

절차:

  1. 수정 전 실제 테스트 결과가 있으면 동일 호스트·설정의 baseline으로 로드
  2. 수정 후 동일 테스트 케이스 재실행
  3. 비교: 기존 통과 항목이 미통과로 변경되면 regression

회귀 판정:

변화판정
기존 통과 → 여전히 통과PASS
기존 통과 → 미통과REGRESSION (수정 롤백 필요)
기존 미통과 → 통과IMPROVEMENT
새로운 테스트 추가INFO (비교 불가)
이전 실행 결과 없음NOT-RUN (회귀 비교 불가)
Mode 3: 체인 테스트 (스킬 조합 검증)

여러 스킬이 순차적으로 연결되는 체인을 테스트합니다. 실제로 존재하고 실행 가능한 체인만 실행 대상으로 삼고, 나머지는 미실행으로 기록합니다.

3-1. Chain Definition Format
chain:
  name: "blog-publishing"
  description: "Blog post creation → AI slop review → optional media generation"
  steps:
    - skill: "moai-marketer:content-blog"
      output_type: "markdown"
      provides: ["blog_draft"]
    - skill: "moai-coworker:ai-slop-reviewer"
      input_from: ["blog_draft"]
      output_type: "markdown"
      provides: ["reviewed_draft"]
    - skill: "moai-media:media-higgsfield-image"
      input_from: ["reviewed_draft"]
      output_type: "image_url"
      optional: true
      provides: ["cover_image"]
3-2. Test Design Rules

Happy Path Test — 전체 체인을 대표 입력으로 실행하고 다음을 검증:

  • 각 단계 출력이 다음 단계 입력 스키마와 호환
  • 최종 출력이 문서화된 기대치와 일치
  • 단계 간 데이터 손실 없음

Failure Propagation Test — 각 단계 실패를 시뮬레이션:

  • 체인이 우아하게 정지하는가?
  • 어느 단계가 실패했는지 사용자에게 전달되는가?
  • 실패 지점에서 재개 가능한가?

Optional Step Test — 선택적 단계가 있는 체인:

  • 선택 단계를 건너뛰어도 체인이 완료되는가
  • 선택 단계가 실패해도 체인이 완료되는가
  • 선택 단계 출력 없이도 결과가 유의미한가

Output Compatibility Test — 각 단계 경계에서:

  • 출력 스키마가 다음 단계 기대 입력과 일치
  • 언어 일관성 (한국어 출력 → 한국어 입력)
  • 형식 일관성 (markdown → markdown)
3-3. Test Case Template
## Chain Test: <chain-name>

### TC-1: Happy Path
- Input: <대표 프롬프트>
- Expected Step 1 output: <설명>
- Expected Step 2 output: <설명>
- Expected Final output: <설명>
- Pass criteria: 모든 단계가 기대 출력 생성, 최종 결과 사용 가능

### TC-2: Step <N> Failure
- Input: <단계 N 실패 유발 프롬프트>
- Expected behavior: <체인 정지 / 건너뜀 / 재시도>
- Pass criteria: 사용자에게 전달, 데이터 손실 없음

### TC-3: Optional Step Skip
- Input: <선택 단계 트리거 없는 프롬프트>
- Expected behavior: <선택 단계 없이 체인 완료>
- Pass criteria: 최종 출력이 선택 단계 기여 없이도 유의미함
3-4. Known Chains
ChainStepsStatus
사업계획서(PPT)consult-strategy → doc-pptx → ai-slop-reviewer예시, 실행 기록 없음
블로그 발행content-blog → ai-slop-reviewer → (optional) media-higgsfield-image예시, 실행 기록 없음
제품 랜딩content-copywriting → marketing-landing-page → ai-slop-reviewer예시, 실행 기록 없음
3-5. 회귀 통합

체인 내 어떤 스킬이 수정되면:

  1. 해당 스킬을 포함하는 모든 체인 테스트 재실행
  2. 단계 경계 출력 호환성 집중 검증
  3. 출력 스키마 변경 시 다운스트림 스킬 동반 갱신
Mode 4: 루브릭 단독 (Standalone Scoring)

특정 스킬의 SKILL.md 본문만 검토할 때는 문서의 명확성·범위만 평가할 수 있습니다. 실제 출력의 정확성·완전성이나 토큰 효율은 실행 결과 없이 점수화하지 않습니다.

스코어링 루브릭 (4차원 가중 평균)

점수는 실행 결과와 평가 근거가 있을 때만 계산합니다. 실행하지 않은 검사는 NOT-RUN입니다.

차원 정의
차원가중치핵심 질문
Correctness (정확성)30%출력이 의도한 목적을 달성하는가?
Completeness (완전성)25%에지 케이스와 일반 변형을 다루는가?
Clarity (명확성)25%사용자가 이해하고 결과를 활용할 수 있는가?
Efficiency (효율성)20%출력 품질 대비 토큰 사용량이 적정한가?
Correctness — 30%
점수설명
1.0명시된 목적을 사실 오류 없이 완전히 달성. 모든 스킬 내 예시가 정확한 결과 산출.
0.75목적 달성하나 형식·스타일에서 경미한 편차. 사실 오류 없음.
0.50목적 대부분 달성하나 1-2개 핵심 측면 누락 또는 경미한 부정확성.
0.25목적 일부만 다룸. 큰 격차 또는 오류 존재.
Completeness — 25%
점수설명
1.0문서화된 모든 use case 처리. 에지 케이스 커버. 에러 경로 문서화. 적용 안 될 때 대체 스킬 명시.
0.75핵심 use case 처리. 대부분 에지 케이스 커버. 에러 처리 존재하나 불완전.
0.50주요 use case 동작. 에지 케이스 미커버. 에러 처리 최소.
0.25happy path만 동작. 에지 케이스 처리 없음. 에러 시 silent failure.
Clarity — 25%
점수설명
1.0재독 없이 실행 가능. 워크플로우 명확. 출력 형식 예측 가능. 예시가 복사·붙여넣기 사용 가능.
0.751회 독해 후 이해. 1-2 단계에서 미세한 모호성. 예시는 유용하나 변형 필요.
0.50섹션 재독 필요. 일부 단계 해석 여지. 예시는 있으나 추상적.
0.25워크플로우 혼란. 단계 해석 여지 큼. 구체적 예시 없음.
Efficiency — 20%
점수설명
1.0출력 품질 대비 토큰 사용 최적. 중복 지시 없음. 점진적 공개 잘 활용. 필요할 때만 로드.
0.75토큰 사용 합리적. 경미한 중복 가능. 점진적 공개 대체로 효과적.
0.50토큰 사용 필요 대비 높음. 일부 섹션 단축 가능. 점진적 공개 미활용.
0.25과도한 토큰 사용. 보일러플레이트 大. 점진적 공개 부재.
통과 기준
  • 최저 통과: 관측된 모든 차원과 assertion을 평가한 경우 가중 평균 >= 0.70
  • 단일 차원 floor: 어떤 차원도 0.50 미만이면 hard fail
  • 신규 스킬: 첫 평가에서 >= 0.75 필요. 실제 실행하지 않았다면 점수로 출시 판단을 대신하지 않음
가중 점수 계산
score = (correctness * 0.30) + (completeness * 0.25) + (clarity * 0.25) + (efficiency * 0.20)
평가 절차
  1. Self-evaluation: 스킬 작성자가 본 루브릭으로 self-score
  2. Peer evaluation: 두 번째 평가자가 독립 스코어링 (Complex tier 권장)
  3. Gap resolution: 차원별 점수 차이 > 0.15 시 토론·해결
  4. Final score: 모든 평가자 평균
스킬 Tier 통합
스킬 Tier필요 점수평가
Simple (<50줄)>= 0.70Self-evaluation
Standard (50-150줄)>= 0.70Self + 권장 peer
Complex (150줄+)>= 0.75Self + 필수 peer
Anti-Pattern Checks (boundary-verification 통합)

통과 점수 확정 전 다음을 확인:

  • 다른 스킬이 커버하는 기능과 중복하지 않음
  • 폐기된 필드/패턴 참조 없음
  • 설정 가능해야 할 값이 하드코딩되지 않음
  • 예시 출력이 실제(real)이며 fabricated 아님
  • 트리거가 명확한 우선순위 없이 다른 스킬과 중첩되지 않음

Test Case Format

각 스킬의 tests/test-cases.yaml 파일 형식:

skill: <skill-name>
version: 0.1.0
test_cases:
  - id: TC-001
    name: "happy-path"
    prompt: |
      <사용자 프롬프트>
    assertions:
      - type: contains
        value: "<출력에 포함되어야 할 문자열>"
      - type: not_contains
        value: "<출력에 포함되지 않아야 할 문자열>"
      - type: format
        value: "<markdown|json|text|html>"
    quality_threshold:
      correctness: 0.75
      completeness: 0.70
      clarity: 0.70
      efficiency: 0.60

  - id: TC-002
    name: "edge-case"
    prompt: |
      <경계 조건 프롬프트>
    assertions:
      - type: handles_gracefully
        value: true

Score Report Format

테스트 후 작성하는 리포트 형식이다. 아래 수치와 판정은 형식 설명용이며 실제 측정값이 아니다:

## Skill Test Report: <skill-name>

### Summary
- Mode: A/B Test
- Date: YYYY-MM-DD
- Host / model / configuration: <실제 실행 환경>
- Result: PASS / FAIL / NOT-RUN
- Evidence: <실행 명령 또는 앱 기록과 실제 출력 위치>
- Gaps: <실행하지 못한 검사>

### Scores

| Dimension | Baseline | With-Skill | Delta |
|-----------|----------|------------|-------|
| Correctness | 0.65 | 0.85 | +0.20 |
| Completeness | 0.60 | 0.80 | +0.20 |
| Clarity | 0.70 | 0.80 | +0.10 |
| Efficiency | 0.75 | 0.80 | +0.05 |
| **Weighted** | **0.67** | **0.81** | **+0.14** |

### Token Usage
- Baseline: XXXX tokens
- With-Skill: XXXX tokens
- Delta: -XX%

### Assertions
- TC-001: PASS (3/3 assertions)
- TC-002: PASS (2/2 assertions)

### Anti-Pattern Audit
- [x] 중복 없음
- [x] 하드코딩 없음
- [x] 모든 예시 real

### Recommendation
<APPROVE for release / NEEDS revision on [dimension]>

사용 예시

예시 1: 신규 스킬 A/B 테스트

"meta-skill-tester로 collab-sales-playbook 스킬 A/B 테스트해줘"

예시 2: 회귀 테스트

"content-blog 스킬 수정했는데 회귀 테스트해줘"

예시 3: 체인 테스트

"content-blog → ai-slop-reviewer 체인 테스트 실행해줘"

예시 4: 루브릭 단독 평가

"consult-gov-grant 스킬을 4차원 루브릭으로만 평가해줘"

출력 형식

산출물형식설명
Score Report마크다운4차원 루브릭 스코어 + assertion 결과 + anti-pattern audit
Test ResultsYAML테스트 케이스별 상세 결과

주의사항

  • A/B 테스트는 동일 모델, 동일 조건에서 실행해야 합니다
  • 토큰 사용량은 대상 호스트가 해당 실행의 값을 제공할 때만 기록합니다. 제공하지 않으면 미측정으로 표시합니다.
  • 자동화된 CI 통합은 추후 Phase 4에서 구현 예정입니다
  • 테스트 프롬프트에 민감 정보(실제 고객명 등)를 포함하지 마세요
  • 정적 문서 검토, 테스트 실행, 실제 데스크톱 앱 확인은 각각 구분해 보고합니다.

관련 스킬

스킬관계설명
meta-skill-builderbefore스킬 생성 후 테스트 실행
meta-skill-templatebefore템플릿 기반 스킬 구조 정의
ai-slop-revieweralternative텍스트 품질 검수 (비기능적)

실행 진입점

현재 앱에 이 스킬이 노출돼 있으면 자연어로 스킬 검증을 요청합니다. 이 플러그인은 별도 /harness 명령을 제공하지 않습니다.


Source: revfactory/harness skill-testing-guide + qa-agent-guide + Pipeline pattern (Apache 2.0) + MoAI adaptation

행사 기획

요청에 따라 references/event-organizer.md 또는 references/wedding-planner.md를 읽고 필요한 항목만 적용한다. 사용자가 제공한 날짜·지역·인원·예산·계약 자료가 계획의 기준이다. 장소와 업체의 실제 가격·할인·예약 가능 여부는 최신 견적이나 공식 안내를 확인하기 전까지 확정하지 않는다.

작성 순서

  1. 행사 목적, 원하는 방식, 참석자, 지역, 날짜 범위, 예산 상한과 우선순위를 정리한다. 미정 항목은 선택지와 확인 질문으로 남긴다.
  2. 준비 단계와 당일 진행 순서를 의존 관계에 맞춰 적는다. 사용자가 기한을 주지 않았다면 임의의 D-6개월 일정을 강제하지 않는다.
  3. 항목별 예산은 사용자가 준 견적과 계약 조건으로 계산한다. 견적이 없으면 예산 배분 초안과 비교할 항목을 제시하고 실거래가로 표시하지 않는다.
  4. 장소·식사·접근성·안전·날씨·장비·변경·취소 조건 중 해당 행사에 필요한 위험을 점검한다.
  5. 예약, 결제, 초대장 발송, 업체 연락은 사용자 요청과 실제 연결 도구·권한을 확인한 뒤 진행한다. 계획서와 실행 완료를 분리한다.

출력은 요청에 맞는 기획서, 준비 목록, 진행표, 견적 비교표 중 필요한 것만 만든다. 문체를 다듬을 때 가격·계약 조건과 미확인 표시를 보존한다. 허니문 일정은 moai-coworker:personal-travel, 계약서의 법적 검토는 moai-lawyer:legal-contract-review를 사용한다.

자기돌봄

사용자가 말한 피로와 부담을 있는 그대로 듣고, 가능한 작은 조정을 함께 찾는다. 증상만 보고 번아웃·우울증을 진단하거나 회복 기간과 업무 복귀 비율을 정하지 않는다. WHO는 번아웃을 직업 맥락의 현상으로 설명하며 질병으로 분류하지 않는다.

대화 순서

  1. 최근 부담, 쉬는 방식, 수면·식사·활동 변화, 일상 기능에 미치는 영향을 사용자가 편한 만큼만 묻는다. 원인과 감정을 대신 단정하지 않는다.
  2. 사용자가 통제할 수 있는 작은 선택지를 함께 고른다. 휴식, 업무·약속 조정, 믿을 만한 사람과의 대화 같은 방법은 개인 상황에 맞춰 제안한다. 특정 앱이나 화면 사용을 일률적으로 해롭다고 규정하지 않는다.
  3. 실행 계획은 사용자가 정한 수준과 속도로 만든다. 기간, 운동량, 업무 복귀 비율을 고정하지 않고 시도 후 어떤 변화가 있는지 확인한다.
  4. 어려움이 심해지거나 일상생활에 영향을 주면 전문적인 도움을 권한다. 미국 국립정신건강연구소의 안내는 증상이 지속되거나 악화될 때 의료 전문가와 상담하도록 권한다. 기간 하나만으로 진단하거나 도움 요청을 미루게 하지 않는다.

자해·자살 생각이나 즉각적인 위험이 드러나면 일반 루틴 조언보다 안전 확보와 긴급 지원을 우선한다. 한국에서는 자살예방상담전화 109가 상담 경로다. 즉각적 위험에는 현지 긴급 구조 서비스를 이용하도록 안내한다. 사용자의 지역이 한국이 아니면 해당 지역의 긴급 지원을 확인한다.

시간 계획이 주된 요청이면 moai-officer:productivity-time, 가벼운 습관 설계가 필요하면 moai-coworker:productivity-habit을 사용할 수 있다. 문장 후처리 과정에서도 사용자의 표현과 도움 요청 안내를 지우지 않는다.

여행 계획

references/travel-planner.md를 읽고 사용자의 출발지·목적지·날짜·인원·예산·관심사·이동 제약에 맞는 계획을 만든다. 숙소·식당·교통·관광지를 추천하면 여행 날짜에 유효한 공식 운영 정보와 예약 조건, 최근 가격을 조회하고 출처·조회일을 적는다. 조회하지 못한 항목은 추천 후보나 예산 확인 과제로 표시한다.

진행 순서

  1. 사용자 조건과 반드시 지킬 제약을 정리한다. 날짜가 없으면 계절·요일에 따른 운영 차이를 단정하지 않고 예시 동선으로 제시한다.
  2. 방문 후보의 위치·운영시간·휴무·예약 필요 여부를 실제 자료로 확인한다. 이동 시간과 환승은 확인 가능한 교통 정보로 잡고 일정에 여유를 둔다.
  3. 항공·숙소·교통·식사·활동 비용은 동일 날짜·인원·통화의 견적으로 비교한다. 자료가 없으면 항목별 예산 상한과 조회할 경로를 제시한다. 오래된 평균값이나 고정 비수기 할인율을 현재 가격으로 쓰지 않는다.
  4. 해외여행은 국적·목적지·경유지·여행 시점에 맞는 공식 입국·여권·비자·안전 정보를 확인한다. 확인 전에는 입국 가능 여부를 확정하지 않는다.
  5. 일정표에 확인한 사실, 예약 전 확인 사항, 비용 출처와 취소 조건을 구분한다. 예약·결제는 사용자의 요청과 실제 연결 도구·권한을 확인한 뒤에만 수행하고 결과를 읽어 확인한다.

최종 출력은 날짜별 동선, 비용표, 예약 우선순위와 대안으로 구성하되 사용자가 원한 범위만 담는다. 문체를 다듬을 때 운영시간·가격·출처를 보존한다. 개인 재무 계획은 moai-accountant:finance-household-budget, 웨딩 행사는 moai-coworker:personal-event를 사용한다.

일상 건강과 돌봄 계획

요청에 맞는 참고 문서만 읽는다. 개인의 질환, 장애, 임신, 알레르기, 복용 약, 섭식 문제, 아동 발달 우려가 관련되면 일반 정보와 개인에게 적용할 의료·돌봄 판단을 구분한다. 민감한 건강·가족·재산 정보를 필요한 만큼만 요청한다.

요청참고 문서
일반 운동 계획references/fitness-program.md
일반 식사·장보기 계획references/meal-planner.md
양육 활동·질문 정리references/parenting-guide.md
노년기 돌봄 선택지references/elderly-care-planning.md

진행 방법

  1. 목표, 현재 상황, 선호도, 안전상 제약과 실제 이용 가능한 시간·예산을 확인한다. 자료가 없으면 범용 선택지를 제안하고 맞춤 처방이라고 부르지 않는다.
  2. 활동·메뉴·돌봄 방식은 사용자가 선택할 수 있는 초안으로 만든다. 칼로리·운동 강도·발달 단계·요양 등급·의학적 효과를 임의로 정하지 않는다.
  3. 공식 지침이나 제도를 인용할 때는 대상, 버전, 조회일을 확인한다. WHO 신체활동 지침은 집단 권고이며 개인 질환별 운동 처방은 아니다.
  4. 통증, 새 증상, 만성질환, 성장·발달 우려, 영양 부족 가능성, 돌봄 안전 문제가 있으면 해당 의료·영양·돌봄 전문가에게 확인할 질문을 정리한다. 응급 위험에는 일반 계획을 중단하고 현지 긴급 서비스를 안내한다.
  5. 실제 신청·예약·지급·고객 연락은 사용자 요청과 연결 도구의 권한을 확인한 뒤 별도로 처리한다. 초안과 완료 상태를 구분한다.

정신건강 위기나 자해·자살 위험에는 일상 루틴 제안보다 즉각적인 안전 지원을 우선한다. 한국의 자살예방상담전화 109 및 현지 긴급 구조 서비스를 안내한다. 문체 검수 중에도 주의사항과 근거를 삭제하지 않는다.

개인 목표 계획

사용자가 원하는 결과와 이유, 사용할 수 있는 시간·자원·제약을 확인한다. 12주 계획, 만다라트, OKR은 요청하거나 유용할 때 고르는 도구다. 모든 목표를 12주·8칸·숫자 2~3개에 맞추지 않는다.

  1. 목표 정리: 사용자의 표현을 보존하고 달성 조건을 함께 정한다. 정량화하기 어려운 목표는 관찰 가능한 변화나 정성적 신호를 사용한다.
  2. 범위 설정: 현재 우선순위와 다른 의무를 고려해 감당할 수 있는 행동을 고른다. 목표 개수와 기한은 사용자가 결정한다.
  3. 계획: 필요한 자원, 첫 행동, 의존 관계, 방해 요인을 적는다. 일정과 수치 목표는 제공된 상황에서 가능한지 확인한다.
  4. 점검: 사용자가 선택한 주기로 진행과 부담을 돌아보고 목표나 행동을 조정한다. 실행 기록 없이 달성률을 계산하지 않는다.

출력은 목표, 확인 방법, 다음 행동, 미결정 사항과 점검 시점으로 구성한다. 앱이나 노션 대시보드 연결은 실제 사용 가능한 경우에만 제안하고 자동 추적을 약속하지 않는다. 습관 계획은 moai-coworker:productivity-habit, 회고는 moai-coworker:productivity-retro와 연결할 수 있다. 재무 목표의 구체적 계산은 moai-accountant:finance-wealth-roadmap을 사용한다.

습관 계획

사용자가 원하는 행동과 그 이유, 기존 일정, 건강·돌봄·업무 제약을 확인한다. 습관을 이어가지 못한 원인을 의지 부족이나 특정 심리 상태로 단정하지 않는다.

  1. 행동을 시작하기 쉬운 크기로 제안하고, 사용자가 편한 빈도와 상황을 고른다. 반드시 매일 해야 하는 것은 아니다.
  2. 도움이 된다면 이미 하는 행동이나 장소와 연결한다. 알림·앱 사용·기록은 사용자의 선호에 맞춘다.
  3. 시작을 어렵게 하는 실제 장애를 확인하고 환경 변경이나 더 작은 대안을 제시한다. 특정 방법의 성공률을 보장하지 않는다.
  4. 기록을 원하면 간단한 표나 체크리스트를 만든다. 연결되지 않은 달력이나 노션에 자동 저장된다고 말하지 않는다.
  5. 빠진 날은 실패로 평가하지 않고 다음에 다시 시작할 조건을 사용자가 정하게 한다. 부담이 커지면 계획을 줄이거나 쉬어도 된다.

출력에는 행동, 실행 상황, 조정 방법과 미확인 조건을 짧게 적는다. 치료가 필요한 중독·의존 문제는 습관 트래커로 해결한다고 말하지 않고 적절한 전문 지원을 안내한다. 목표 정리가 먼저 필요하면 moai-coworker:productivity-goal, 지난 시도의 복기는 moai-coworker:productivity-retro를 사용한다.

회고 정리

사용자가 돌아보려는 기간과 목적을 확인한다. 실제 경험이나 기록이 없으면 회고 결과를 대신 채우지 않고 질문 또는 빈 양식을 제공한다. 5분 회고, KPT, 키워드 방식은 선택지이며 모두에게 같은 형식을 강제하지 않는다.

선택할 수 있는 형식

  • 한 줄 회고: 이번 기간의 중요한 일과 다음에 살펴볼 일을 한두 문장으로 기록한다.
  • KPT: 유지할 일, 어려웠던 점, 시도할 일을 나눈다. 팀 회고라면 참여자별 의견과 합의된 행동을 구분한다.
  • 키워드 회고: 사용자가 고른 단어에 관련 경험과 근거를 붙인다.

실제 사용자가 말한 사실, 해석, 다음 시도를 분리한다. 다음 행동이 아직 정해지지 않았다면 반드시 하나를 만들어 넣지 않는다. 약속한 행동이나 성과를 자동 추적한다고 말하지 않고, 사용자가 원하는 기록 위치와 점검 주기를 제안한다.

가벼운 개인 회고는 여기서 다루고, 프로젝트 진행 상황을 근거로 보고하는 작업은 moai-coworker:collab-pm-report를 사용한다. 정신건강 상태를 진단하거나 업무 실패의 심리적 원인을 단정하지 않는다.

MCP servers 1

Sponsors

Details

Marketplace
modu-ai/moai-cowork
Source
plugins/moai-coworker
Category
범용 실무

More from modu-ai/moai-cowork

All 18