Grinda KMS 기여 플러그인 가이드

1 설치

Claude Code에서 3줄

/plugin marketplace add FINGU-GRINDA/grindaai-kms-astro
/plugin install kms-contribute@grinda-kms
/reload-plugins

⚠️ /reload-plugins 를 꼭 실행하세요. 안 하면 다음 단계에서 Unknown command: /kms-setup 이 뜹니다.

2 최초 1회 셋업

환경 셋업

/kms-setup

OS(macOS/Windows)를 자동 감지해 필요한 것만 단계별로 안내합니다. GitHub 계정이 없어도 가입부터 도와줍니다:

GitHub 가입 → gh 설치 → gh auth login → 레포 초대 → 클론

👤 사람만 할 수 있는 단계(가입·브라우저 인증·초대)는 정확한 안내로 멈추고, 나머지는 자동 처리합니다. 레포 접근 초대는 레포 주인(chlee@grinda.ai)에게 FINGU-GRINDA/grindaai-kms-astro 콜라보레이터 초대를 요청하세요.

3 사용

그냥 말하면 됩니다

이렇게 말하면	이렇게 동작
“이 회의록 KMS에 정리해줘” (+내용)	영역 판단 → 노트 생성 → 규약 적용 → PR
“이거 일단 raw로 넣어줘”	원본 그대로 보존 (증류는 나중)
“이 raw 증류해서 정리해줘”	요점을 위키 노트로 다듬고 링크 연결
“결제 재시도 규칙 KMS 어디 있어?”	위키를 읽고 답변
“이 폴더 끊긴 링크 고쳐줘”	정합성 검사·수정

✨ 파일명·제목·frontmatter·위키링크·발행 게이트 같은 규약은 플러그인이 자동 적용합니다.

🛡️ 안전

이렇게 지킵니다

기본은 비공개 — publish: true 를 넣을 때만 팀에 공개됩니다.
자격증명은 절대 묻지 않음 — 인증은 공식 gh auth login 브라우저 플로우만.
비밀번호·토큰·키·IP·개인정보는 위키에 쓰지 않습니다.

🔧 문제 해결

막히면

Unknown command: /kms-setup → /reload-plugins 먼저 실행

셋업이 꼬였을 때 → /kms-setup 다시 실행 (진단 후 미완료 단계만 재안내)