moai-core — 프로젝트·라우터·AI 슬롭 + MCP 4커넥터 셋업

moai-core

cowork-plugins 전체의 기반이 되는 코어 플러그인입니다. 다른 플러그인을 사용하기 전에 반드시 먼저 설치하세요.

무엇을 하는 플러그인인가

moai-core는 cowork-plugins 마켓플레이스의 모든 도메인 플러그인이 공유하는 인프라를 제공합니다. 프로젝트별 작업 지침(CLAUDE.md)을 자동 생성하는 /project init 마법사, 모든 텍스트 산출물의 마지막 단계에서 AI 패턴을 다듬어주는 ai-slop-reviewer, 버그·기능 요청을 GitHub Issues로 바로 등록하는 feedback 스킬, Drive·Notion·Higgsfield·OpenAI 4커넥터 인증·환경변수·트러블슈팅 통합 가이드 mcp-connector-setup을 포함한 총 8개 스킬이 포함되어 있습니다.

ai-slop-reviewer는 모든 한국어 텍스트 산출물(블로그·뉴스레터·계약서·사업계획서·이메일 등)의 체인 마지막 단계에서 호출되어, 과장된 수식어·기계적 접속어·모호한 일반화 같은 AI 글쓰기 패턴을 진단하고 사람 톤으로 다듬어줍니다.

/project init 한 번이면 설치된 moai-* 플러그인을 자동 감지해 산출물별 스킬 체인을 설계하고, 200라인 이내의 CLAUDE.md를 프로젝트 루트에 생성합니다.

설치

마켓플레이스 (권장)

Cowork에서 modu-ai/cowork-plugins 마켓플레이스를 추가합니다.
moai-core 옆의 + 버튼을 눌러 설치합니다.

수동

GitHub 저장소를 클론한 뒤 ~/.claude/plugins/에 배치합니다.

핵심 스킬 (8개)

스킬	용도	자동 호출 트리거
`project`	프로젝트 초기화·상태·API 키·카탈로그 관리 (`/project init`, `/project status`, `/project apikey`, `/project catalog`)	“프로젝트 초기화”, “CLAUDE.md 만들어줘”
`ai-slop-reviewer`	텍스트 산출물의 AI 패턴 진단·수정	“AI 티 나는 부분 고쳐줘”, “사람이 쓴 것처럼 수정해줘”
`feedback`	버그 리포트·기능 요청을 GitHub Issues로 자동 등록	“/project feedback”, “버그 신고”, “기능 요청”
`ai-diagnostic`	AI 시스템 진단, 성능 모니터링, 오류 분석	“AI 동작이 이상해”, “성능 체크해줘”
`mcp-connector-setup`	Drive·Notion·Higgsfield·OpenAI 4커넥터 인증·환경변수·트러블슈팅. Windows MAX_PATH·한글 파일명 30자·`computer://` 링크 오류 대응. 모두의 커머스 캠프 Day 1 S4 셋업 합격 기준(4커넥터 모두 1회 호출 성공)	“MCP 커넥터 연결”, “Drive 인증 방법”, “Higgsfield 키 발급”, “Windows MAX_PATH 오류”
`skill-builder`	새 스킬 생성, 기존 스킬 수정, 스킬 템플릿 관리 (v1.5.x: skill-forge 후속)	“새 스킬 만들어줘”, “스킬 템플릿 제공해줘”, “/harness”
`skill-template`	스킬 구조 템플릿, 프롬프트 엔지니어링 가이드	“스킬 구조 알려줘”, “템플릿 참고할게”
`skill-tester`	스킬 테스트, 검증, 품질 보증	“이 스킬 테스트해줘”, “검증 프로세스 설계해줘”

`/project init` 흐름 (3분)

flowchart TD
    A["① Interview
업무 맥락 수집"] --> B["② Detect
플러그인 감지"]
    B --> C["③ Chain Design
체인 설계"]
    C --> D["④ Confirm
승인"]
    D --> E["⑤ Generate
CLAUDE.md 생성"]
    E --> F["⑥ APIKey
키 등록"]
    F --> G["⑦ First Run
첫 작업 예시"]

    style A fill:#eaeaea,stroke:#6e6e6e,color:#09110f
    style G fill:#e6f0ef,stroke:#144a46,color:#09110f

Interview — 최대 3개 질문으로 이번 프로젝트의 업무 맥락 수집 (이름·회사는 묻지 않음)
Detect — 설치된 moai-* 플러그인 자동 감지
Chain Design — 산출물별 스킬 체인 설계 (예: 사업계획서 → strategy-planner → docx-generator → ai-slop-reviewer)
Confirm — AskUserQuestion으로 체인 설계 최종 승인
Generate — CLAUDE.md 자동 생성 (200라인 이내)
APIKey — 선택된 플러그인이 요구하는 키만 프로젝트 격리 저장
First Run — 첫 작업 예시 3개 제안

`ai-slop-reviewer` 이해하기

AI가 작성한 글에는 공통된 패턴이 있습니다.

과장된 수식어(“혁신적인”, “획기적인”, “업계 최고의”)
기계적 접속어(“첫째”, “둘째”, “마지막으로"가 과하게 반복)
모호한 일반화(“많은 사람들은…”)
불필요한 요약 반복

ai-slop-reviewer는 이러한 패턴을 진단하고, 수정 텍스트를 제시하며, 주요 변경사항을 리포트로 남깁니다. cowork-plugins의 모든 텍스트 스킬 체인은 이 단계로 종료하는 것이 권장됩니다.

대표 체인

(도메인 스킬)
  → (포맷 변환 스킬, 예: docx-generator)
  → ai-slop-reviewer   ← 필수

코드·데이터·차트 같은 비텍스트 산출물은 ai-slop-reviewer를 스킵합니다.

빠른 사용 예

/project init

이 블로그 글에서 AI 티 나는 부분 고쳐줘.

MCP 커넥터 4개 연결 방법 알려줘 — Drive·Notion·Higgsfield·OpenAI

→ mcp-connector-setup 🆕

`mcp-connector-setup`

“모두의 커머스 3일 마스터 캠프” Day 1 S4 (14:00–14:50) 셋업 시간에 수강생이 Drive·Notion·Higgsfield·OpenAI 4커넥터를 Cowork에 연결하는 단계별 가이드입니다. 합격 기준은 4커넥터 모두 인증 성공 + 1회 호출 성공입니다 (PDF §4.4 ③).

트러블슈팅 커버리지:

Windows MAX_PATH (260자 제한) 오류
한글 파일명 30자 초과 오류
computer:// 링크가 열리지 않는 경우
API 키 만료·rate limit·OAuth 토큰 갱신
Higgsfield Secret Key 발급 절차 (워크스페이스 사전 비용 충전 1.5배 권장)

다음 단계

빠른 시작 — 실제 프로젝트 초기화 전 과정
Cowork 플러그인 사용