나이트마켓 빌드 & 환경 구축
uv 기반 claude-night-market 개발 환경을 맨바닥에서 1시간 내에 재구성하고 검증하는 온보딩 가이드 스킬.
개발·코딩중급★ 330⑂ 33AI 점수 7/10마지막 업데이트: 2026. 8. 24.
무엇을 해주나
uv를 중심으로 한 툴체인 설치 순서를 필수/선택으로 구분한 표로 제시하고, 각 도구의 검증 명령(uv --version,uv run ruff --version등)을 함께 알려줍니다.- 클론 →
make validate-all→ 단일 플러그인 테스트 →pre-commit install로 이어지는 "첫 1시간 검증 시퀀스"를 성공 출력 형태까지 설명합니다. - 루트 툴링은 Python 3.12, 플러그인은 3.9~3.12, 훅은 호스트 시스템 파이썬 3.9라는 3단 버전 계층과 그 이유를 정리합니다.
setup-uv@v8태그 미존재,.uv-tools의 낡은 ruff가 PATH를 가리는 문제, bandit 1.9의 3.9 미지원, 루트 pytest가 플러그인 테스트를 건너뛰는 이유 등 실제로 반복된 함정과 가드 스크립트를 표로 제공합니다.- 마지막에 체크리스트 형태의 Exit Criteria와, 문서 내용이 낡았을 때 다시 확인할
rg명령 목록을 남깁니다.
이런 분께 추천
- claude-night-market 저장소에 새로 합류해 환경을 처음 세팅하는 개발자.
- uv + 멀티 패키지 모노레포(플러그인별 pyproject) 구조를 다루는 파이썬 개발자.
- Claude Code 훅이 프로젝트 가상환경이 아니라 시스템 파이썬으로 실행되는 문제에 부딪힌 사람.
- 온보딩 문서를 어떤 밀도로 써야 하는지 좋은 예시를 찾는 팀 리드.
활용 예시
- "새 노트북에 이 저장소 개발 환경 세팅해줘" → uv 설치, Python 3.12,
make validate-all, pytest, pre-commit까지 순서대로 실행하고 각 단계 출력이 정상인지 판정합니다. - "커밋할 때마다 bandit 훅 설치가 실패한다" → bandit 1.9+가 시스템 3.9를 지원하지 않으므로
.pre-commit-config.yaml이rev: 1.8.6으로 핀되어야 한다는 함정 항목으로 안내합니다. - "내 로컬 ruff 결과가 CI와 다르다" →
.uv-tools의 낡은 바이너리 섀도잉을 지적하고make lint또는uv run ruff사용을 권합니다.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/athola/claude-night-market/HEAD/.claude/skills/night-market-build-and-env/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 athola/claude-night-market 의 .claude/skills/night-market-build-and-env 폴더를 내 ~/.claude/skills/night-market-build-and-env/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/athola/claude-night-market.git /tmp/claude-night-market && mkdir -p ~/.claude/skills && cp -r /tmp/claude-night-market/.claude/skills/night-market-build-and-env ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 클론합니다:
git clone https://github.com/athola/claude-night-market.git - 스킬 폴더 위치를 확인합니다:
ls claude-night-market/.claude/skills/night-market-build-and-env - 개인 스킬 디렉터리를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r claude-night-market/.claude/skills/night-market-build-and-env ~/.claude/skills/ - Claude Code를 재시작하고
/skills또는 스킬 목록에서night-market-build-and-env가 보이는지 확인합니다. - 이 스킬은 claude-night-market 저장소 안에서 쓸 때 가장 효과적입니다. 저장소 루트로 이동한 뒤 "개발 환경을 처음부터 세팅해줘"라고 요청하세요.
- 다른 프로젝트에서 참고만 하려면, SKILL.md의 표와 함정 목록을 자기 저장소 기준으로 수정해 두는 것을 권합니다.
GitHub에서 원본 보기 ↗라이선스: MIT