neosql-mcp: Skill for Claude Code

Release

미배포 변경을 기준으로 버전을 추천하고, 사용자가 확정한 버전으로 npm version을 실행한 뒤 commit과 tag를 push한다. tag push가 .github/workflows/publish.yml을 트리거해 npm publish와 plugin 브랜치 전진을 자동으로 수행하므로, 이 스킬은 로컬에서 수동 publish를 하지 않는다.

스킬 실행 요청만으로 추천 버전을 확정하지 않는다. 사용자가 버전이나 증가 종류를 승인하거나 지정한 뒤에만 npm version과 push를 실행한다. 상세 배포 원칙은 docs/npm-publish.md의 "버전과 태그", "Plugin 릴리스" 절이 기준이다.

1. 상태 확인

아래를 한 번에 확인하고 문제가 있으면 멈춘다.

git status --short --branch
git fetch origin --tags
git log --oneline "$(git describe --tags --abbrev=0 --match 'v*')..HEAD"
node -p "require('./package.json').version"
npm view neosql-mcp version

• 브랜치가 main이 아니면 중단하고 확인한다. release tag는 main에서만 만든다.
• working tree가 clean이 아니면 중단한다. release commit에 섞이면 안 되는 변경을 대신 commit하거나 stash하지 않는다. 사용자에게 정리 여부를 묻는다.
• origin/main보다 뒤처져 있으면 중단한다. 먼저 pull이 필요한지 사용자와 확인한다.
• package.json 버전, 최신 v* tag, npm registry의 latest 세 값이 서로 다르면 왜 다른지 설명할 수 있어야 한다. 설명이 안 되면 추측해서 올리지 않는다.
• publish workflow가 v* tag push로 트리거되는지 .github/workflows/publish.yml에서 다시 확인한다. workflow가 바뀌어 있으면 이 스킬의 절차보다 workflow를 우선한다.

2. 변경 분석과 버전 추천

최신 v* tag 이후 HEAD까지의 commit을 조사한다. 제목만 보지 말고 필요한 diff를 본다. 이 패키지에서 사용자에게 배포되는 것은 dist/(즉 src/), README.md, LICENSE, npm-shrinkwrap.json, 그리고 plugins/neosql-mcp/다. 이 범위에 영향이 없는 변경(내부 문서, 테스트, CI)만 있으면 배포가 필요 없다고 말한다.

추천 기준. 최종 선택은 사용자에게 있다.

• patch X.Y.Z → X.Y.(Z+1): 오류 수정, 문구·문서 변경, README 변경, package.json 메타데이터 변경, 의존성 보안 업데이트, 동작이 같은 리팩터링. README와 package.json은 npm 페이지에 그대로 노출되므로 문서만 바뀌어도 publish 가치가 있다.
• minor X.Y.Z → X.(Y+1).0: 새 MCP tool, 새 CLI 옵션, 기존 tool의 입력·출력 확장, 새 MCP host 지원처럼 사용자가 체감하는 기능 추가. patch와 minor가 섞이면 minor.
• major X.Y.Z → (X+1).0.0: tool 이름·입력 스키마·응답 형식 변경, CLI 옵션 제거, 지원 Node 버전 상향, upstream 계약 변경처럼 기존 MCP host 설정이나 Desktop 버전과 호환이 깨질 때. 사용자는 호환성 파괴가 없어도 제품 판단으로 major를 고를 수 있다.
• commit type 접두어(feat/fix)는 참고일 뿐이다. docs:로 표시된 README 변경도 배포 대상이고, feat:로 표시된 내부 리팩터링은 patch일 수 있다.

다음을 한 번에 제시하고 응답을 기다린다.