feat: /changeset Claude Code 플러그인 추가

[yceffort-naver]

배경

현재 changeset 파일 생성은 pnpm changeset CLI를 통해 interactive하게 진행해야 합니다.
Claude Code 플러그인을 만들어 배포하면, 패키지 사용자들도 편리하게 changeset을 생성할 수 있습니다.

제안

Claude Code 플러그인으로 /changeset command를 만들어 배포합니다.

사용자 설치 방법

# 1. 마켓플레이스 등록 (한 번만)
/plugin marketplace add NaverPayDev/naverpay-plugins

# 2. 플러그인 설치
/plugin install changeset@naverpay-plugins

사용법

/naverpay-plugins:changeset

기능

1. git diff로 변경된 파일 확인
2. packages/ 내 변경된 패키지 자동 식별
3. 사용자에게 버전 타입(major/minor/patch) 질문
4. .changeset/*.md 파일 자동 생성

예시 출력

# .changeset/happy-dogs-dance.md

---
"@naverpay/react-pdf": patch
---

PDF 뷰어 스크롤 성능 개선

---

개발 가이드

1. 플러그인 구조

naverpay-plugins/
├── .claude-plugin/
│   ├── plugin.json          # 필수: 플러그인 메타데이터
│   └── marketplace.json     # 필수: 마켓플레이스 등록 정보
├── commands/
│   └── changeset.md         # /changeset command 정의
└── README.md

2. plugin.json 작성

{
  "name": "naverpay-plugins",
  "description": "NaverPay 개발 도구 모음",
  "version": "1.0.0",
  "author": {
    "name": "NaverPayDev"
  }
}

3. marketplace.json 작성

{
  "name": "naverpay-plugins",
  "owner": {
    "name": "NaverPayDev"
  },
  "plugins": [
    {
      "name": "changeset",
      "source": ".",
      "description": "변경된 패키지 감지 및 changeset 파일 생성",
      "version": "1.0.0"
    }
  ]
}

4. commands/changeset.md 작성

---
description: 변경된 패키지를 감지하고 changeset 파일을 생성합니다
allowed-tools: Bash(git diff:*), Bash(find:*), Read, Write, Glob, Grep
---

# Changeset Generator

## 지침

1. `git diff --name-only`로 변경된 파일 목록 확인
2. `packages/` 디렉토리 내 변경된 패키지 식별
3. 사용자에게 각 패키지별 버전 타입 질문 (major/minor/patch)
4. 변경 내용 요약 작성 요청
5. `.changeset/[random-name].md` 파일 생성

## 파일 형식

생성되는 changeset 파일 형식:

\`\`\`markdown
---
"@naverpay/package-name": patch
---

변경 내용 요약
\`\`\`

## 주의사항

- 변경된 패키지가 없으면 changeset 생성 불필요 안내
- `skip-detect-change` 레이블 사용 시 changeset 불필요

5. 로컬 테스트

# 플러그인 디렉토리에서 테스트
claude --plugin-dir ./naverpay-plugins

# 또는 심볼릭 링크로 테스트
ln -s $(pwd)/naverpay-plugins ~/.claude/plugins/naverpay-plugins

6. 배포

# GitHub에 push하면 배포 완료
git push origin main

7. 배포 확인

⚠️ npm 같은 중앙 registry/웹사이트는 없습니다.
GitHub 리포지토리 자체가 마켓플레이스 역할을 합니다.

• 배포 확인: https://github.com/NaverPayDev/naverpay-plugins
• 설치 확인: /plugin marketplace list

---

참고 자료

• Claude Code Plugins 문서
• Anthropic 공식 플러그인 예제
• Agent Skills 스펙

체크리스트

• 플러그인 리포지토리 생성 (NaverPayDev/naverpay-plugins)
• .claude-plugin/plugin.json 작성
• .claude-plugin/marketplace.json 작성
• commands/changeset.md 작성
• 로컬 테스트 (claude --plugin-dir)
• README.md 작성
• GitHub에 push
• 설치 테스트 (/plugin marketplace add, /plugin install)

[yceffort-naver]

cc @NaverPayDev/frontend

[github-actions]

@yceffort-naver 님, 이슈에 assignee, label 을 작성해 주세요.

[yceffort-naver]

@Ohjaeyeop @NaverPayDev/frontend

배경

현재 조직에서 Claude Code를 표준 AI 코딩 도구로 사용하고 있습니다. 개발자들이 반복적으로 사용하는 작업(예: changeset 생성)에 대해 각자 프롬프트를 작성하거나 매번 설명하는 비효율이 발생하고 있습니다.

목표

조직에서 만든 스킬과 커맨드를 원격 리포지토리에 올려, AI를 사용하는 개발자들에게 일괄 배포합니다. 이를 통해 다음과 같은 성과를 얻을 수 있지 않을까

• 표준화: 모든 개발자가 동일한 커맨드 사용
• 효율화: 프롬프트를 별도로 작성하거나 반복 입력하는 수고 감소
• 품질 향상: 검증된 프롬프트를 공유하여 일관된 결과물 확보

제안 방식: Claude Code Plugin (Commands)

기존에는 MCP(Model Context Protocol) 서버로 구현하려 했으나, 방향을 전환하여 Claude Code 플러그인 마켓플레이스를 활용한 Commands 방식을 제안합니다.

MCP vs Commands 비교

항목	MCP	Commands (Plugin)
구현 복잡도	높음 (Node.js 서버 구현 필요)	낮음 (마크다운 파일만 작성)
배포 방식	npm 패키지	GitHub 리포지토리
설치 방법	config.json 수동 수정	/plugin install 명령어
유지보수	런타임 의존성 관리 필요	파일 수정만으로 업데이트
개발 속도	느림	빠름

Commands를 선택한 이유

1. 낮은 진입 장벽: 마크다운만 잘 작성하면 되어 빠르게 시도 가능
2. 빠른 검증: 복잡한 서버 구현 없이 아이디어를 빠르게 테스트
3. 쉬운 유지보수: 프롬프트 수정 시 마크다운 파일만 업데이트
4. 조직 표준과 부합: 이미 Claude Code를 표준으로 사용 중

MCP 대비 단점

1. 플랫폼 제한: Claude Code에서만 사용 가능 (Claude Desktop, VS Code, Cursor 등 미지원)
2. 중앙 레지스트리 부재: npm처럼 검색 가능한 공식 마켓플레이스 웹사이트 없음
3. 복잡한 로직 구현 한계: 외부 API 호출, DB 연동 등 고급 기능은 MCP가 더 적합
4. 생태계가 아직 별로임: MCP 대비 상대적으로 새로운 방식

첫 번째 적용: /changeset 커맨드

changeset 파일 생성을 첫 번째 커맨드로 전환합니다.

현재 방식:

• pnpm changeset # interactive CLI, 매번 수동 입력
• 내지는 웹에서 수동으로 입력 ㅠ.ㅠ

개선 후:

• /naverpay-plugins:changeset # AI가 변경사항 분석 후 자동 생성

향후 확장 계획

changeset 커맨드 검증 후, 조직에서 자주 사용하는 작업들을 순차적으로 추가 해볼 수도 있습니다.

• /pr-review: PR 코드 리뷰
• /commit: 커밋 메시지 생성

결론?

MCP는 강력하지만 구현 복잡도가 높습니다. (그리고 귀차나) Commands는 마크다운만으로 빠르게 만들 수 있어, 가볍고 빠르게 검증해볼 수 있습니다. 조직에서 Claude Code를 표준으로 사용하고 있으므로 플랫폼 제한 문제도 없습니다.

먼저 Commands 방식으로 시작하고, 추후 외부 API 연동 등 고급 기능이 필요한 경우 MCP로 전환을 검토해보는건 어떨까요

[boxersb]

@yceffort-naver 좋은것 같습니다! 그런데, Claude Code 지금 쓸 수 있나요? 아직 형님분들만 쓰고 계시는것 같아서,,

[Ohjaeyeop]

https://github.com/NaverPayDev/naverpay-plugins