Back to search
moai-cowork
SkillGitHubIncomplete
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/modu-ai--moai-cowork)HTML
<a href="/listings/modu-ai--moai-cowork"><img src="/api/listings/modu-ai--moai-cowork/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 160 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "moai-cowork",
- "owner": {
- "name": "modu-ai",
- "email": "email@mo.ai.kr"
- },
- "metadata": {
- "description": "'MoAI-Cowork, 모두의 코워크' AI 코워커 패밀리 — 코워커(범용 실무·라이프스타일)·작가(출판)·스토리(웹툰/웹소설/IP)·마케터(캠페인/콘텐츠)·미디어(이미지/영상/오디오 생성)·셀러·사무관(오피스 문서)·데이터 애널리스트(공공데이터/시각화)·법무·재무세무·인사채용·CS매니저·컨설턴트·커리어코치·튜터(전문가)·디자이너(브랜드 디자인 시스템)·PM(진입 허브). 각 AI 코워커는 슬래시 명령 없이 자연어 요청만으로 동작하며, PM의 /project 단일 명령이 진입을 라우팅합니다(update·evolve·doctor 하위 모드 지원). Claude Code에서 `claude plugin marketplace add modu-ai/moai-cowork`로 한 번에 등록하세요.",
- "version": "1.2.8",
- "language": "ko",
- "license": "Apache-2.0",
- "displayName": "MoAI-Coworker"
- },
- "plugins": [
- {
- "name": "moai-coworker",
- "source": "./plugins/moai-coworker",
- "version": "1.2.28",
- "description": "실무 범용 코어 AI 코워커 — 브랜드·제안서·보고·협상·프로세스 등 비즈니스 실무와 목표·습관·회고·여행·웰니스·행사기획을 돕습니다. 전문 영역은 해당 분야 플러그인으로 연결합니다. 이런 분께 추천: 1인 사업자·스타트업 운영자.",
- "displayName": "🧑💼 코워커",
- "category": "범용 실무"
- },
- {
- "name": "moai-writer",
- "source": "./plugins/moai-writer",
- "version": "1.5.14",
- "description": "출판·텍스트 전담 AI 코워커 — 도서 기획·집필·퇴고·제안서·출판사 조사와 한국어 윤문을 돕습니다. 공개 맞춤법 검사기는 이용 조건과 원고 공개 범위를 확인한 뒤 사용자 주도로 사용합니다. 스토리/IP 창작은 별도 moai-story 플러그인이 담당합니다. 이런 분께 추천: 작가·1인 출판인·실용서 저자.",
- "displayName": "✍️ 작가",
- "category": "창작·출판"
- },
- {
- "name": "moai-story",
- "source": "./plugins/moai-story",
- "version": "1.2.5",
- "description": "스토리/IP 창작 전담 AI 코워커 — 웹툰 제작 체인(기획→캐릭터→회차→식자→작화→QC)·웹소설 연재(기획→집필)·영상 시나리오·콘티·표지·IP 사업화 스킬. 플랫폼 제출 규격은 현재 공고를 확인합니다. 이미지는 앱 도구로 생성하고, Higgsfield 요청은 공식 연결을 확인합니다. 자연어 요청 시 매칭 스킬이 자동 호출됩니다. 이런 분께 추천: 웹툰/웹소설 창작자·시나리오 작가·IP 콘텐츠 기획자.",
- "displayName": "📖 스토리 크리에이터",
- "category": "창작·IP"
- },
- {
- "name": "moai-marketer",
- "source": "./plugins/moai-marketer",
- "version": "1.2.24",
- "description": "마케팅 전담 AI 코워커 — 캠페인 기획·퍼포먼스 분석·키워드 리서치·그로스 실험·리텐션, 블로그·뉴스레터·SNS 콘텐츠 스킬. Meta Ads·게시 채널 MCP 연동. 일반 이미지는 ChatGPT 기본 도구를 확인하고, 전문 미디어 제작은 연결된 도구와 moai-media 스킬을 활용합니다. 이런 분께 추천: 마케터·콘텐츠 크리에이터·1인 브랜드.",
- "displayName": "📣 마케터",
- "category": "마케팅"
- },
- {
- "name": "moai-media",
- "source": "./plugins/moai-media",
- "version": "3.3.16",
- "description": "미디어 생성 전담 AI 코워커 — 이미지·영상·오디오 생성 스킬. ChatGPT 기본 이미지 도구, 별도 API 키로 정확한 GPT Image 2.5 생성, Higgsfield 공식 연결의 이미지·영상·제품 촬영, ElevenLabs 오디오, Gemini·Midjourney·NotebookLM 프롬프트 작업을 지원합니다. Higgsfield 3D·설명 영상 완성은 현재 연결에 제출·조립 도구가 있을 때만 진행합니다.",
- "displayName": "🎬 미디어 크리에이터",
- "category": "미디어 생성"
- },
- {
- "name": "moai-seller",
- "source": "./plugins/moai-seller",
- "version": "1.4.33",
- "description": "이커머스 셀러 전담 AI 코워커 — 스마트스토어·아임웹·카페24 MCP 연동과 상세페이지·마켓플레이스·광고·CRM 등 커머스 실무 스킬. VOC·채널 메시지는 moai-cs(CS매니저)로 이관. 자연어 요청 시 매칭 스킬이 자동 호출됩니다. 이런 분께 추천: 온라인 셀러·이커머스 운영자.",
- "displayName": "🛒 셀러",
- "category": "이커머스"
- },
- {
- "name": "moai-officer",
- "source": "./plugins/moai-officer",
- "version": "1.3.9",
- "description": "사무 문서 전담 AI 코워커 — 한국형 오피스 문서(HWPX·DOCX·XLSX·PPTX·PDF)·HTML 리포트/슬라이드 생성, 공문서 파싱, 노션 템플릿·생산성 루틴 스킬. kordoc MCP 연동. 공공데이터 조회·데이터 분석은 moai-analyst로, 라이프스타일은 moai-coworker로 분리. 자연어 요청 시 매칭 스킬이 자동 호출됩니다. 이런 분께 추천: 사무직·기획자·자영업 운영자.",
- "displayName": "📄 사무관",
- "category": "문서·오피스"
- },
- {
- "name": "moai-analyst",
- "source": "./plugins/moai-analyst",
- "version": "1.3.7",
- "description": "데이터·공공데이터 분석 전담 AI 코워커 — 데이터 프로파일링·시각화, 공공데이터 조회(부동산·경매·주식·KOSIS·건축물대장·DART 전자공시) 스킬 7종. KOSIS 통계·건축HUB·DART MCP 연동. 자연어 요청 시 매칭 스킬이 자동 호출됩니다. 이런 분께 추천: 데이터 애널리스트·사무직·기획자·자영업 운영자.",
- "displayName": "📊 데이터 애널리스트",
- "category": "데이터·분석"
- },
- {
- "name": "moai-lawyer",
- "source": "./plugins/moai-lawyer",
- "version": "1.4.18",
- "description": "법무 전담 AI 코워커 — 계약 검토·NDA 트리아지·컴플라이언스 점검·법령/판례 리서치·국내외 특허/상표 선행조사·식약처 안전 기준 스킬. 국가법령정보 MCP(korean-law)로 인용을 검증하고, 특허/상표 공식 데이터 MCP(moai-mcp-ip)로 한국·미국·일본·유럽 DB를 조회합니다. 이런 분께 추천: 1인 사업자·스타트업 운영자. ※ 법률 자문 대체가 아닌 참고 자료입니다.",
- "displayName": "⚖️ 법무 담당",
- "category": "전문직"
- },
- {
- "name": "moai-accountant",
- "source": "./plugins/moai-accountant",
- "version": "1.3.9",
- "description": "재무·세무 전담 AI 코워커 — 재무제표 분석·결산 관리·차이 분석·IR, 개인 세금 절약·가계 예산·투자 입문·보험 적합성 스킬. OpenDART 전자공시 MCP 연결을 지원합니다. 사업자·재무 담당자·개인 재테크 입문자를 위한 참고 자료이며 세무사·회계사 자문을 대체하지 않습니다.",
- "displayName": "💰 재무·세무 담당",
- "category": "전문직"
- },
- {
- "name": "moai-recruiter",
- "source": "./plugins/moai-recruiter",
- "version": "2.0.9",
- "description": "인사·채용 전담 AI 코워커(고용주 편) — 채용 공고 분석·이력서 스크리닝·오퍼레터/근로계약서·성과평가·People Ops를 돕습니다. 구직자 편은 moai-career(커리어코치)로 분리되었습니다. 이런 분께 추천: 채용 담당자·인사 실무자.",
- "displayName": "🤝 인사·채용 담당",
- "category": "전문직"
- },
- {
- "name": "moai-cs",
- "source": "./plugins/moai-cs",
- "version": "1.2.9",
- "description": "고객지원·CRM 전담 AI 코워커 — 티켓 분류·응답 초안·에스컬레이션·지식베이스와 VOC 분석·채널 메시지까지 고객 접점 실무 스킬을 제공합니다. 자연어 요청 시 매칭 스킬이 자동 호출됩니다. 이런 분께 추천: 온라인 셀러·CS 담당자·1인 사업자.",
- "displayName": "🎧 CS매니저",
- "category": "고객지원"
- },
- {
- "name": "moai-consultant",
- "source": "./plugins/moai-consultant",
- "version": "1.2.8",
- "description": "경영·창업 컨설팅 전담 AI 코워커 — 사업계획서·비즈니스 모델·시장 분석(TAM/SAM/SOM)·경영 진단 브리프·정부 지원사업 탐색·상권분석 보고서 작성. 예비 창업자·소상공인·스타트업 운영자를 위한 스킬을 제공합니다.",
- "displayName": "💼 컨설턴트",
- "category": "경영 자문"
- },
- {
- "name": "moai-career",
- "source": "./plugins/moai-career",
- "version": "1.2.7",
- "description": "구직자 편 커리어 코칭 전담 AI 코워커 — 이력서·포트폴리오 첨삭, 면접 준비, 이직 전략까지 커리어 전환 실무 스킬. 인사채용(고용주 편)과 구분되는 구직자 관점입니다. 이런 분께 추천: 이직 준비자·취업 준비생·주니어 직장인.",
- "displayName": "🧭 커리어코치",
- "category": "커리어"
- },
- {
- "name": "moai-tutor",
- "source": "./plugins/moai-tutor",
- "version": "1.3.5",
- "description": "교육 전담 AI 코워커 — 커리큘럼 설계·학습 자료·평가 문항 제작·강좌 운영 매뉴얼·논문 검색/작성·연구 보조 스킬. 강사와 학습자 양쪽 워크플로우를 지원합니다. 이런 분께 추천: 강사·교육 기획자·대학원생·연구자.",
- "displayName": "🎓 튜터",
- "category": "전문직"
- },
- {
- "name": "moai-designer",
- "source": "./plugins/moai-designer",
- "version": "1.4.73",
- "description": "브랜드 디자인 시스템과 DESIGN.md, 디자인 토큰, 로고·비주얼, 모션 랜딩 제작을 돕는 스킬. Claude Design 핸드오프를 읽고 공식 Higgsfield 연결 또는 앱 이미지 도구로 브랜드 이미지 작업을 진행합니다.",
- "displayName": "🎨 디자이너",
- "category": "디자인"
- },
- {
- "name": "moai-pm",
- "source": "./plugins/moai-pm",
- "version": "1.7.0",
- "description": "프로젝트 초기화 허브 AI 코워커 — /project로 진입합니다. Claude Cowork 프로젝트 초기화(전 직원 지침 설정 + .claude/agents/ 커스텀 에이전트 + AGENTS.md 워크플로우 생성 + 재귀적 자가 개선)를 담당하며 AI 코워커 플러그인 패밀리의 진입을 라우팅합니다. 비개발자도 자연어 한마디로 프로젝트를 시작할 수 있습니다. 이런 분께 추천: 비개발자·프로젝트 시작자.",
- "displayName": "🚀 PM",
- "category": "프로젝트 허브"
- },
- {
- "name": "moai-threads-poster",
- "source": "./plugins/moai-threads-poster",
- "version": "2.0.7",
- "description": "Threads·Instagram(Meta) 자율 발행 전담 AI 코워커 — 직접 Graph API 연결 MCP(월정액 없음)로 텍스트·이미지·비디오 2단계 발행. 세션 안에서 직접 발행. 예약·정기 발행은 사용 중인 앱의 지원 여부를 확인합니다. Facebook 개인 계정은 API 미지원(정책)이라 복붙만 지원합니다. 자연어 요청 시 매칭 스킬이 자동 호출됩니다. 이런 분께 추천: 1인 브랜드·콘텐츠 크리에이터·Threads/Instagram 정기 운영자.",
- "displayName": "📸 SNS 크리에이터",
- "category": "소셜미디어"
- }
- ]
- }
README.md · README · 245 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 모두의 코워크 (MoAI-Cowork) — 한국 실무 AI 코워커 패밀리
- > **비개발자도 한마디면 시작.** Claude Cowork와 ChatGPT Work 양쪽에서 쓰는, 한국 실무에 맞춘 AI 코워커(전문가) 패밀리입니다.
- PM이 프로젝트 성격과 필요한 맥락을 확인하고, 업무에 맞는 전문 스킬과 진행 순서를 구성합니다. 설치·자료 접근·지침 적용·실제 실행 여부는 현재 앱에서 각각 확인합니다.
- - **두 환경을 위한 패키지** — Claude와 OpenAI용 공통 `plugin.json`·`mcp.json`과 호환 매니페스트(`.claude-plugin` / `.codex-plugin`)를 제공합니다. ChatGPT Work와 로컬 Codex는 서로 다른 실행 환경이므로 설치 경로와 사용 가능한 기능을 따로 확인하세요.
- - **한국 실무 설계** — 한국어 문서·말투·업무 규격(한글·HWPX·스마트스토어·공공데이터 등)에 맞췄습니다.
- - **자연어로 업무 요청** — 목표와 자료를 설명하면 현재 사용할 수 있는 스킬을 업무에 맞게 선택하도록 안내합니다.
- - **결과물은 여러분 것** — 상업적 사용 제한 없음. [LICENSE-OUTPUT.md](./LICENSE-OUTPUT.md)
- ---
- ## MoAI-Cowork가 무엇인가요?
- MoAI-Cowork(모두의 코워크)는 **비개발자도 AI와 함께 실무를 풀 수 있게 만든 AI 코워커 패밀리**입니다.
- 
- "AI 코워커"는 한 가지 일에 깊이 특화된 전문가 AI입니다. 거대한 AI 하나가 모든 걸 다루는 게 아니라, 마케터·작가·셀러·법무 담당·디자이너처럼 **직무별로 나뉜 전문가 AI**가 각자의 영역을 맡습니다. 마치 회사에 부서가 있고 부서마다 담당자가 있는 것과 같습니다.
- ### 왜 만들었나요?
- AI 도구는 강력하지만 "어떻게 시작하지?"에서 막히는 분이 많습니다.
- - 영문 메뉴와 개발자 중심 인터페이스가 익숙하지 않은 분
- - "뭘 입력해야 할지"를 매번 고민하게 되는 분
- - 한국 실무 맥락(한글 문서, 스마트스토어, 공공데이터, 한국어 말투)을 잘 다루는 도구를 찾는 분
- MoAI-Cowork는 하고 싶은 일과 가진 자료를 설명하는 것으로 시작합니다. PM이 필요한 정보를 질문하고, 프로젝트 기준과 스킬·역할·업무 순서를 정리합니다. [온라인 강의실](https://cowork.mo.ai.kr/learn/)에서 개념과 가상 실습을 함께 배울 수 있습니다.
- ### 핵심 특징
- | 특징 | 설명 |
- |------|------|
- | **직무별 전문가 AI** | 코워커(범용)·작가·마케터·미디어·셀러·법무·재무·디자이너 등 각자의 영역을 맡은 코워커 패밀리 |
- | **PM 허브가 진입 안내** | "새 프로젝트 시작해줘"로 목적을 파악하고 알맞은 코워커를 배치 |
- | **두 앱의 환경 구분** | 같은 업무 기준을 사용하며 설치·파일 접근·도구 지원은 앱별로 확인 |
- | **자연어 진입** | 목표·자료·완료 기준을 설명하고 필요한 스킬을 선택 |
- | **한국 실무 정합** | 한국어 경어체, 한글 오피스 문서, 스마트스토어·공공데이터 등 국내 실무 규격 대응 |
- ---
- ## 어떻게 동작하나요?
- 처음에는 PM으로 프로젝트 기준을 준비합니다. 이후에는 이번 업무의 새 자료와 바뀐 조건을 제공하고 결과를 확인합니다.
- ### ① 최초 1회 — PM이 프로젝트를 준비합니다
- "새 프로젝트 시작해줘"라고 말하면 PM이 목적과 산출물을 **인터뷰**로 묻습니다. 그 답에서 필요한 일을 **감지**해 알맞은 코워커와 스킬을 의존성에 맞춰 순차·병렬로 이은 **워크플로우**으로 조립합니다. 확인을 받으면 프로젝트 규칙 파일을 생성합니다.
- 
- 마지막 "지침 생성" 단계에서 만들어지는 것은 다음과 같습니다.
- - 프로젝트 지침 초안과 지원되는 로컬 지침 파일 — 로컬 정본 생성과 앱 Projects에 적용하는 단계를 구분합니다
- - 프로젝트 전용 커스텀 에이전트와 스킬 체인 설계
- - 필요한 경우 외부 서비스 API 키 안내
- 이 단계가 끝나면 "어떤 일을, 어떤 순서로, 어떤 품질 기준으로 만들지"가 한 번에 정리됩니다.
- ### ② 이후 매번 — 새 자료와 결과 기준을 알려 주세요
- 스킬 이름을 모두 외울 필요는 없습니다. 원하는 결과와 자료를 제공하고, 현재 사용할 수 있는 스킬로 업무를 진행하도록 요청합니다. 의존하는 작업은 순차로, 독립된 작업은 지원되는 경우 병렬로 진행하며 결과를 합쳐 검토합니다.
- 
- 그림은 업무 분업의 개념도입니다. 실제 별도 에이전트가 실행되는지, 어떤 파일을 만들 수 있는지는 현재 환경에서 확인합니다.
- > PM은 직접 일하지 않습니다. **누가 이 일에 맞는지 찾아 팀을 꾸리는 안내자** 역할만 합니다.
- ---
- ## AI 코워커 명단
- 
- 전부 `modu-ai/moai-cowork` 마켓플레이스 하나에서 설치합니다. 정확한 최신 로스터는 [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json)이 정본이고, 아래는 역할 요약입니다.
- | 직무 | 플러그인 | 역할 |
- |---|---|---|
- | 🚀 **PM (진입 허브)** | `moai-pm` | `/project` 라우터 — 프로젝트 성격 파악 → 알맞은 코워커 배치 |
- | 🧑💼 코워커 | `moai-coworker` | 범용 실무·라이프스타일 (협업·생산성·개인 일정) |
- | ✍️ 작가 | `moai-writer` | 출판 기획·집필·한글 윤문·맞춤법 |
- | 📖 스토리 크리에이터 | `moai-story` | 웹툰·웹소설·IP·스토리보드 |
- | 📣 마케터 | `moai-marketer` | 캠페인·콘텐츠·광고·SEO·메타광고 |
- | 🎬 미디어 크리에이터 | `moai-media` | 이미지·영상·오디오 생성 (Higgsfield·Midjourney·Gemini 등) |
- | 🛒 셀러 | `moai-seller` | 커머스 운영 (스마트스토어·쿠팡·D2C·상세페이지·광고) |
- | 📄 사무관 | `moai-officer` | 오피스 문서 (한글·워드·엑셀·PPT·PDF·노션) |
- | 📊 데이터 애널리스트 | `moai-analyst` | 공공데이터·실거래가·경매·주식·통계 조회·시각화 |
- | ⚖️ 법무 담당 | `moai-lawyer` | 계약 검토·컴플라이언스·특허·부동산 실명 |
- | 💰 재무·세무 담당 | `moai-accountant` | 재무제표·세무·투자·보험·예산 |
- | 🤝 인사·채용 담당 | `moai-recruiter` | 채용·이력서 검토·성과평가·인사 운영 |
- | 🎧 CS매니저 | `moai-cs` | 고객응대·VOC·채널 메시지·티켓 분류 |
- | 💼 컨설턴트 | `moai-consultant` | 전략·시장분석·정부지원금·스비즈365 |
- | 🧭 커리어코치 | `moai-career` | 이력서·면접·포트폴리오·커리어 전환 |
- | 🎓 튜터 | `moai-tutor` | 학습 자료·평가·논문·교육과정 |
- | 🎨 디자이너 | `moai-designer` | 브랜드·로고·디자인 시스템·Claude Design 연동 |
- | 📸 SNS 크리에이터 | `moai-threads-poster` | 소셜 발행 (Threads·Instagram) |
- 코워커별 상세 소개는 [AI 코워커](https://cowork.mo.ai.kr/moai-agents/)에서 볼 수 있습니다.
- ---
- ## 시작하기 — 현재 앱에서 설치 경로 확인
- **Claude Cowork**와 **ChatGPT Work** 중 사용할 환경을 정하고 계정·조직이 제공하는 플러그인 설치 경로를 확인합니다. 외부 서비스 연결 없이 가상 메모로 첫 실습을 시작할 수도 있습니다.
- 
- ### 1. 마켓플레이스 등록 (최초 1회)
- 마켓플레이스는 설치할 수 있는 코워커 목록입니다. 사용하는 앱의 경로로 등록합니다.
- - **Claude Cowork**: 현재 사용자 지정의 플러그인 화면에서 마켓플레이스 추가 또는 지원되는 패키지 경로를 확인합니다. 저장소 추가가 제공되면 `modu-ai/moai-cowork`를 지정합니다.
- - **ChatGPT Work**: Plugins에서 제공되는 설치 경로를 확인합니다. MoAI가 공용 목록에 없으면 사용자 지정 마켓플레이스나 조직 배포를 지원하는지 확인합니다. 모든 개인 계정에 GitHub 가져오기가 있다고 가정하지 않습니다.
- 
- > 앱별 정확한 클릭 경로와 잘 안 될 때 대처법은 [플러그인 설치와 관리](https://cowork.mo.ai.kr/plugins/install/) 1절에 정리해 두었습니다.
- ### 2. 코워커(플러그인) 설치
- 현재 앱에서 제공하는 플러그인 경로로 필요한 코워커를 설치합니다. 외부 서비스 연결은 플러그인 설치와 별도로 인증하며, 설치 후 현재 작업에 기능이 노출되는지 확인합니다.
- - **먼저 `moai-pm`** — "새 프로젝트 시작해줘"로 프로젝트를 초기화하고 나머지 코워커를 배치하는 진입 허브입니다.
- - **함께 권장 `moai-coworker`** — 텍스트 산출물 검수 등 범용 실무 코어를 담습니다.
- - 그 다음엔 진행할 작업에 맞는 직무 코워커를 골라 추가하면 됩니다. 예: 마케팅·콘텐츠 작업은 `moai-marketer`, 법무·문서 작업은 `moai-lawyer`·`moai-officer`.
- 
- > 처음에는 할 업무의 역할 하나부터 선택하거나 PM으로 계획을 구성합니다. 추천 기능과 실제 설치·실행된 기능을 구분합니다. 위 사진은 웹 탐색 화면이며 MoAI 설치 성공을 증명하는 사진은 아닙니다.
- ### 3. 프로젝트 시작
- 사용하는 앱에서 프로젝트를 열고 "온라인 클래스 런칭 준비 프로젝트 시작해줘"처럼 목적을 말합니다. `/project`가 현재 앱에서 제공되면 그 진입점도 사용할 수 있습니다.
- PM은 기존 자료와 필요한 맥락을 확인하고, 전문 스킬·역할·순차/병렬 워크플로우를 설계합니다. 실제 답과 대기 질문은 `.moai/config.json`·`.moai/context.md`에 보존합니다.
- | 프로젝트 환경 | 지침 적용 |
- |---|---|
- | ChatGPT 계정의 Projects / Work | 해당 Project의 지침·파일 경로로 적용하고 새 대화에서 읽기와 스킬 노출을 확인 |
- | 로컬 / Synced Work | 연결된 폴더와 실행 위치를 확인한 뒤 실제 지원되는 지침 경로로 적용 |
- | Claude Projects / Cowork | 현재 앱의 Project 지침 또는 허용된 폴더 경로로 적용하고 새 작업에서 확인 |
- | 로컬 Codex / Claude Code | 지원되는 `AGENTS.md` 발견 또는 `CLAUDE.md` import 경로를 확인 |
- 로컬 파일을 만든 상태와 Project에서 읽힌 상태를 따로 기록합니다. 하위 에이전트는 현재 호스트가 지원하고 분업이 허용된 경우에 생성·호출합니다. 대표 업무를 실행해 산출물까지 검증한 뒤 작업 완료를 판단합니다. 적용 경로는 [OpenAI 프로젝트 지침](https://learn.chatgpt.com/docs/agent-configuration/agents-md)과 [Claude 프로젝트 안내](https://support.claude.com/en/articles/9517075-what-are-projects)를 참고하세요.
- 단계별 전체 가이드는 [빠른 시작](https://cowork.mo.ai.kr/getting-started/quick-start/)을 보세요.
- ---
- ## 문서 사이트 — 무엇이 어디에 있나
- 문서 사이트 [cowork.mo.ai.kr](https://cowork.mo.ai.kr)는 비개발자(10~60대)를 위한 한국어 Claude Cowork·ChatGPT Work 실무 가이드입니다. 목차의 진실 출처(SSOT)는 [`www/data/menu/main.yaml`](www/data/menu/main.yaml)이고, 아래는 그 요약입니다.
- | 섹션 | 무엇을 다루나 | 링크 |
- |------|---------------|------|
- | **시작하기** | 빠른 시작 · 핵심 개념 · 데스크톱 앱 설치 · 첫 작업 | [getting-started](https://cowork.mo.ai.kr/getting-started/) |
- | **온라인 강의실** | 6개 수업 · 한국어 그림 · 실제 화면 · 가상 실습 · 모범 결과 · 확인 문제 | [learn](https://cowork.mo.ai.kr/learn/) |
- | **내 프로젝트 업무** | 자료와 지침 · 전문 스킬 · 순차·병렬 흐름 · 검토와 반복 | [workflows](https://cowork.mo.ai.kr/workflows/) |
- | **플러그인 설치·운용** | 설치와 관리 · 전문가 에이전트 이해 · 팀 구성 패턴 · MCP 연동 · Higgsfield 설정 · 라이선스 · 오픈소스 크레딧 | [plugins](https://cowork.mo.ai.kr/plugins/) |
- | **AI 코워커 소개** | 코워커별 역할 · 스킬 · 외부 서비스 연동 상세 | [moai-agents](https://cowork.mo.ai.kr/moai-agents/) |
- | **쿡북** | 스킬 체이닝 · 베스트 프랙티스 · 자동화 레시피 · 실무 시나리오 | [cookbook](https://cowork.mo.ai.kr/cookbook/) |
- | **도움말** | 요금제 · 계정 · 대화 관리 · 개인화 · 사용량 · 문제 해결 · 출처 표기 | [help](https://cowork.mo.ai.kr/help/) |
- | **릴리스 노트** | 버전별 변경 이력 | [releases](https://cowork.mo.ai.kr/releases/) |
- 처음에는 시작하기 또는 온라인 강의실을 따라가고, 실제 업무는 프로젝트 흐름과 업무별 실습으로 이어집니다. 개발자 설정은 [고급 문서](https://cowork.mo.ai.kr/advanced/)에 분리했습니다.
- ### 자주 찾는 문서
- - **MCP 연동** — AI 코워커가 외부 서비스와 실제로 연결되는 통로입니다. [개요](https://cowork.mo.ai.kr/plugins/mcp/) · [설치와 설정](https://cowork.mo.ai.kr/plugins/mcp/install/) · [문제 해결](https://cowork.mo.ai.kr/plugins/mcp/troubleshooting/)
- - **실전 트랙** — 역할·도메인별 표준 워크플로우 모음입니다. [실전 트랙](https://cowork.mo.ai.kr/cookbook/tracks/)
- - **프로젝트 레시피** — 처음부터 끝까지 따라 하는 실전 프로젝트입니다. [프로젝트](https://cowork.mo.ai.kr/cookbook/projects/)
- - **출처와 저작권** — [오픈소스 크레딧](https://cowork.mo.ai.kr/plugins/open-source/) · [출처 표기 안내](https://cowork.mo.ai.kr/help/attribution/)
- ---
- ## 자주 묻는 질문(FAQ)
- **Q. Claude Cowork와 ChatGPT Work 중 어느 쪽에 설치해야 하나요?**
- 둘 다 지원합니다. 평소 쓰는 쪽에 설치하세요. 같은 마켓플레이스를 양쪽 매니페스트(`.claude-plugin` / `.codex-plugin`)로 제공하며, 규칙 파일도 각 앱에 맞게(`CLAUDE.md` / `AGENTS.md`) 생성됩니다.
- **Q. 두 앱을 동시에 쓸 수 있나요?**
- 두 환경에서 사용할 수 있도록 패키지를 제공합니다. 각 계정에서 지원되는 설치 경로와 기능을 확인해 사용하세요.
- **Q. 사용 비용이 드나요?**
- 플러그인 자체는 무료(Apache-2.0)입니다. Claude·ChatGPT 구독이나 사용량은 각 서비스 정책을 따르고, 일부 코워커는 외부 서비스(Higgsfield, ElevenLabs 등) 연동을 위해 API 키가 필요할 수 있습니다.
- **Q. 제가 만든 결과물은 누구 것인가요?**
- 여러분 것입니다. 상업적 사용에 제한이 없습니다 — [LICENSE-OUTPUT.md](./LICENSE-OUTPUT.md).
- **Q. 한국어를 잘하나요?**
- 네. 한국 실무 문서·경어체·업무 규격에 맞춰 설계됐습니다.
- **Q. 개발(코딩) 작업도 도와주나요?**
- 이 마켓플레이스는 비개발 실무 중심입니다. 코딩 작업은 각 데스크톱 앱(Claude Cowork·ChatGPT Work) 자체 기능으로, 개발 환경 셋업은 별도 MoAI-ADK 또는 현재 개발 도구로 안내합니다.
- **Q. 스킬 이름을 외워야 하나요?**
- 이름을 모두 외울 필요는 없습니다. 목표와 자료를 설명하고 현재 사용할 수 있는 스킬을 확인하도록 요청하세요.
- ---
- ## 저장소 구조
- ```
- modu-ai/moai-cowork/
- ├── .claude-plugin/marketplace.json # Claude 마켓 매니페스트 (정본 로스터)
- ├── plugins/ # 마켓 플러그인 소스 (설치명 = 디렉터리명)
- │ ├── moai-pm/ # 프로젝트 허브 (/project)
- │ │ ├── plugin.json / mcp.json # 공통 패키지
- │ │ ├── .claude-plugin/ # Claude Cowork 매니페스트
- │ │ └── .codex-plugin/ # ChatGPT Work(Codex) 매니페스트
- │ ├── moai-coworker/ # 범용 실무
- │ ├── moai-designer/ # 디자이너
- │ ├── moai-threads-poster/ # 소셜 포스터 (Threads/Instagram)
- │ └── ... # 전문가·크리에이티브 코워커
- ├── www/ # 문서 사이트 (cowork.mo.ai.kr, Hugo)
- │ ├── content/
- │ │ ├── getting-started/ # 시작하기
- │ │ ├── learn/ # 온라인 강의실 · 실습 · 강사 안내
- │ │ ├── workflows/ # 프로젝트 업무 흐름
- │ │ ├── advanced/ # 고급 설정과 검증
- │ │ ├── plugins/ # 플러그인 설치·운용 (mcp/ 포함)
- │ │ ├── moai-agents/ # AI 코워커 소개
- │ │ ├── cookbook/ # 쿡북 (tracks/·projects/·guides/·templates/)
- │ │ ├── help/ # 도움말 (office/·attribution 포함)
- │ │ └── releases/ # 릴리스 노트 (archive/ 포함)
- │ ├── static/infographics/ # 문서용 한국어 인포그래픽
- │ ├── data/menu/main.yaml # 목차 SSOT
- │ └── hugo.toml
- ├── README.md
- └── LICENSE
- ```
- > 이 저장소는 **마켓플레이스 + 문서**만을 다룹니다. MoAI-ADK 개발 환경(에이전트/규칙/스킬 설정 등)은 별도 관리되며 `.gitignore`로 이 저장소에서 제외됩니다.
- ---
- ## 라이선스
- [Apache License 2.0](./LICENSE) — 상업적 사용·수정·재배포 자유. 저작권 고지와 변경 사항 표시가 필요합니다.
- 이 플러그인으로 **만든 산출물은 여러분 것**이며 상업적 사용에 제한이 없습니다 — [LICENSE-OUTPUT.md](./LICENSE-OUTPUT.md).
- 제3자 저작물 고지는 [NOTICE](./NOTICE), 이름·로고 사용 규칙은 [TRADEMARKS.md](./TRADEMARKS.md)를 보세요.
plugins/moai-writer/skills/korean-humanize/references/sanitize_text.py · Bundled script · 167 lines · 1 finding marked
- #!/usr/bin/env python3
- """텍스트 위생 — 결정적 전처리, LLM 콜 0.
- 윤문 **전에** 입력을 한 번 정돈해, 이후의 변경률·diff·글자 수가 모두 같은
- 기준을 쓰게 한다. 눈에 보이지 않는 문자가 섞여 있으면 사람이 보기엔 똑같은
- 글이 코드에겐 다른 글이 되고, 그러면 변경률 게이트가 헛돈다.
- 하는 일:
- 1. 제로폭 문자 제거 (U+200B~U+200D, U+FEFF, U+2060)
- 2. 양방향 제어 문자 제거 (U+202A~U+202E, U+2066~U+2069)
- 3. 특수 공백을 보통 공백으로 (U+00A0, U+2000~U+200A, U+202F, U+205F, U+3000)
- 4. 한글 NFD → NFC 정규화 (자모 분리 표기를 완성형으로)
- 5. 줄 끝 공백 제거, CRLF → LF
- **[중요] 이것은 AI 워터마크 제거 기능이 아니다.** 목적은 측정 기준을 하나로
- 맞추는 것이고, 부수 효과로 일부 비가시 문자가 사라질 뿐이다. 탐지 회피
- 도구로 쓰거나 그렇게 소개하지 않는다. macOS 파일명처럼 NFD가 정상인
- 맥락도 있으므로, 정규화는 **본문 텍스트에만** 적용한다.
- 사용:
- python3 sanitize_text.py --input in.txt --output out.txt
- python3 sanitize_text.py --input in.txt --report # 무엇이 바뀌는지만
- cat in.txt | python3 sanitize_text.py # stdin → stdout
- 종료 코드: 0 성공, 2 입출력 오류.
- """
- from __future__ import annotations
- import argparse
- import json
- import os
- import re
- import sys
- import tempfile
- import unicodedata
- from typing import Any
- # 제로폭 — 붙여넣기로 흘러드는 대표적 비가시 문자.
- # **U+200D(ZWJ)와 U+200C(ZWNJ)는 지우지 않는다.** ZWJ는 👩💻 같은 이모지
- # 결합 시퀀스의 접착제라 지우면 한 글자가 둘로 쪼개진다. ZWNJ도 일부 문자
- # 체계에서 의미를 가진다. 순수 잡음인 셋만 제거한다.
- ZERO_WIDTH = ""
- # 양방향 제어 — 표시 순서를 바꿔 눈속임이 가능하다.
- BIDI_CONTROL = ""
- Dismissed after review: Contains 9 bidirectional-override character(s), which make text display in a different order from how it's read
- Line 45 on GitHub
- # 특수 공백 — 보통 공백으로 접는다. U+3000(전각 공백)도 포함.
- SPECIAL_SPACES = (
- " "
- " "
- )
- _ZERO_WIDTH_RE = re.compile(f"[{ZERO_WIDTH}]")
- _BIDI_RE = re.compile(f"[{BIDI_CONTROL}]")
- _SPACE_RE = re.compile(f"[{SPECIAL_SPACES}]")
- # 자릿수 구분자 보호. 숫자 사이의 비분리 공백은 "10 000원"처럼 표기의 일부라
- # 보통 공백으로 접으면 표기가 바뀐다(감사에서 재현됨). 접기 전에 빼두고
- # 접은 뒤 되돌린다.
- _DIGIT_NBSP_RE = re.compile("(?<=\\d)[\u00a0\u202f\u2007](?=\\d)")
- _NBSP_PLACEHOLDER = "\x00NBSP\x00"
- # 줄 끝 공백 — **정확히 두 칸은 마크다운 강제 개행**이므로 남긴다.
- # 한 칸, 셋 칸 이상, 탭이 섞인 것만 잡음으로 보고 지운다.
- _TRAILING_WS_RE = re.compile(r"(?<![ \t])[ \t]$|[ \t]{3,}$|\t[ \t]*$", re.MULTILINE)
- def sanitize(text: str) -> tuple[str, dict[str, Any]]:
- """정돈된 텍스트와 무엇을 몇 개 고쳤는지 리포트를 함께 돌려준다."""
- original = text
- report: dict[str, Any] = {}
- hits = _ZERO_WIDTH_RE.findall(text)
- if hits:
- report["zero_width_removed"] = len(hits)
- text = _ZERO_WIDTH_RE.sub("", text)
- hits = _BIDI_RE.findall(text)
- if hits:
- report["bidi_control_removed"] = len(hits)
- text = _BIDI_RE.sub("", text)
- text, guarded_n = _DIGIT_NBSP_RE.subn(_NBSP_PLACEHOLDER, text)
- hits = _SPACE_RE.findall(text)
- if hits:
- report["special_spaces_folded"] = len(hits)
- text = _SPACE_RE.sub(" ", text)
- if guarded_n:
- report["digit_separators_preserved"] = guarded_n
- text = text.replace(_NBSP_PLACEHOLDER, "\u00a0")
- if "\r\n" in text or "\r" in text:
- report["crlf_normalized"] = text.count("\r\n") + text.count("\r")
- text = text.replace("\r\n", "\n").replace("\r", "\n")
- normalized = unicodedata.normalize("NFC", text)
- if normalized != text:
- report["nfc_normalized"] = True
- report["nfc_char_delta"] = len(text) - len(normalized)
- text = normalized
- stripped = _TRAILING_WS_RE.sub("", text)
- if stripped != text:
- report["trailing_whitespace_lines"] = len(_TRAILING_WS_RE.findall(text))
- text = stripped
- report["changed"] = text != original
- report["chars_before"] = len(original)
- report["chars_after"] = len(text)
- report["note"] = (
- "측정 기준을 하나로 맞추는 전처리다. AI 워터마크 제거 기능이 아니며, "
- "탐지 회피 목적으로 쓰지 않는다."
- )
- return text, report
- def main(argv: list[str] | None = None) -> int:
- ap = argparse.ArgumentParser(description="korean-humanize 텍스트 위생")
- ap.add_argument("--input", help="입력 파일 (생략 시 stdin)")
- ap.add_argument("--output", help="출력 파일 (생략 시 stdout)")
- ap.add_argument("--report", action="store_true", help="본문 대신 변경 리포트만 출력")
- args = ap.parse_args(argv)
- try:
- if args.input:
- with open(args.input, encoding="utf-8") as fh:
- raw = fh.read()
- else:
- raw = sys.stdin.read()
- except OSError as exc:
- print(f"읽기 실패: {exc}", file=sys.stderr)
- return 2
- cleaned, report = sanitize(raw)
- if args.report:
- print(json.dumps(report, ensure_ascii=False, indent=2))
- return 0
- try:
- if args.output:
- # **원자적 쓰기.** 입력=출력으로 부르는 것이 정상 사용법이라
- # (SKILL.md Phase 1), 쓰는 도중 중단되면 원본이 잘린 채 남는다.
- # 같은 디렉터리 임시 파일에 다 쓰고 교체한다.
- d = os.path.dirname(os.path.abspath(args.output)) or "."
- fd, tmp = tempfile.mkstemp(dir=d, prefix=".sanitize-", suffix=".tmp")
- try:
- with os.fdopen(fd, "w", encoding="utf-8") as fh:
- fh.write(cleaned)
- fh.flush()
- os.fsync(fh.fileno())
- os.replace(tmp, args.output)
- except BaseException:
- if os.path.exists(tmp):
- os.unlink(tmp)
- raise
- if report["changed"]:
- print(json.dumps(report, ensure_ascii=False), file=sys.stderr)
- else:
- sys.stdout.write(cleaned)
- except OSError as exc:
- print(f"쓰기 실패: {exc}", file=sys.stderr)
- return 2
- return 0
- if __name__ == "__main__":
- sys.exit(main())
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.