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에 정리해줘” (+내용)	알맞은 위치에 형식 맞춰 정리 → 팀 위키에 등록
“이거 일단 raw로 넣어줘”	원본 그대로 보존 (증류는 나중)
“이 raw 증류해서 정리해줘”	요점을 위키 노트로 다듬고 링크 연결
“결제 재시도 규칙 KMS 어디 있어?”	위키를 읽고 답변
“팀 위키 최신 글로 업데이트해줘”	새로 올라온 글을 받아옵니다 (몇 개 반영됐는지 알려줌)
“이 폴더 끊긴 링크 고쳐줘”	정합성 검사·수정

✨ 제목·정렬·링크 같은 형식 규칙은 플러그인이 알아서 맞춰줍니다 — 규칙을 몰라도 됩니다. 내용을 쓰거나 찾기 전에 늘 최신 상태로 맞춰두고, 방금 올라온 팀원 글을 바로 보고 싶으면 “최신으로 업데이트해줘”라고만 하면 됩니다.

🤝 알아서 챙겨줌

시키지 않아도, 먼저 물어봐 줍니다

설치돼 있으면 두 가지를 먼저 물어봐 줍니다. 항상 물어보고 “네”라고 할 때만 실행해요 — 몰래 저장하거나 보내는 일은 없습니다.

이럴 때	이렇게 물어봐 줍니다
남길 만한 결론·결정·정리가 쌓이면	“방금 정리한 ○○, 팀 위키에 남겨둘까요?”
팀 위키에 새 글이 올라와 있으면	“새 글 N개가 올라왔어요 — 받아둘까요?”

🔕 귀찮게 하지 않습니다. 단발 질문·잡담엔 안 뜨고, 한 번 “아니오·나중에”라고 한 건 그 대화에서 다시 묻지 않아요. 남길 게 없으면 아무 말도 없습니다.

🛡️ 안전

이렇게 지킵니다

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

🔄 플러그인 업데이트

플러그인 코드를 최신으로

스킬·커맨드 등 플러그인 자체를 새 버전으로 올릴 때 (위 “최신 내용 업데이트”는 위키 문서, 이건 플러그인 코드 — 별개):

/plugin marketplace update grinda-kms
/plugin update kms-contribute@grinda-kms
/reload-plugins

🔧 문제 해결

막히면

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

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