Night Market: Dựng môi trường build & dev
Hướng dẫn dựng lại môi trường phát triển của repo claude-night-market từ máy trắng và xác minh trong vòng một giờ.
Lập trìnhNâng cao★ 342⑂ 37Điểm AI 7/10Cập nhật lần cuối: 6 thg 10, 2026
Làm được gì
- Bảng toolchain theo đúng thứ tự cài (uv → Python 3.12 → GNU make 3.82+ → ruff/mypy/bandit/pre-commit) kèm lệnh kiểm tra từng mục.
- Chuỗi xác minh "giờ đầu tiên":
git clone→make validate-all→make -C plugins/leyline test→uv run pre-commit install, mỗi bước nêu rõ kết quả đầu ra thế nào là đạt. - Giải thích ba tầng phiên bản Python của repo: tooling gốc 3.12, từng plugin 3.9–3.12, còn hook chạy bằng Python hệ thống (macOS 3.9.6) ngoài venv — kèm quy tắc như dùng
timezone.utcthay vìdatetime.UTCvà phải bọc import thư viện ngoài. - Bảng "bẫy" đã từng làm hỏng môi trường: tag
setup-uv@v8không tồn tại, bandit 1.9 không hỗ trợ 3.9, binary ruff cũ trong.uv-toolsche PATH, pytest ở gốc bỏ qua test plugin,make skrills-buildkhông tìm thấy repo skrills. - Checklist tiêu chí hoàn tất và tập lệnh
rgđể tự kiểm tra lại khi số phiên bản trong tài liệu đã lỗi thời.
Phù hợp với ai
- Người mới tham gia claude-night-market (hoặc fork của nó) cần dựng môi trường local.
- Maintainer monorepo dùng uv + nhiều phiên bản Python + pre-commit, muốn học cách ghi chép bẫy môi trường.
- Nhóm từng vỡ CI vì hook script chạy bằng Python hệ thống chứ không phải venv.
Ví dụ sử dụng
- Máy mới: clone repo rồi yêu cầu "thiết lập môi trường dev" → cài theo bảng và chạy tới khi
make validate-allxanh. ruffbáo phiên bản khác CI → tra bẫy.uv-toolsvà chuyển sangmake lint/uv run ruff.- Commit bị lỗi
ModuleNotFoundErrortrong hook → áp dụng quy tắc tầng 3.9 và bọc import để sửa.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/athola/claude-night-market/HEAD/.claude/skills/night-market-build-and-env/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục .claude/skills/night-market-build-and-env từ repo GitHub athola/claude-night-market vào ~/.claude/skills/night-market-build-and-env/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/athola/claude-night-market.git /tmp/cnm && mkdir -p ~/.claude/skills && cp -r /tmp/cnm/.claude/skills/night-market-build-and-env ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và clone repo vào thư mục tạm:
git clone https://github.com/athola/claude-night-market.git /tmp/cnm - Tạo thư mục skill nếu chưa có:
mkdir -p ~/.claude/skills - Copy riêng skill này:
cp -r /tmp/cnm/.claude/skills/night-market-build-and-env ~/.claude/skills/ - Kiểm tra:
ls ~/.claude/skills/night-market-build-and-envphải thấy tệpSKILL.md. - Khởi động lại Claude Code, rồi yêu cầu ví dụ: "dựng và xác minh môi trường dev của night-market".
- Lưu ý: các lệnh trong skill giả định bạn đang ở trong repo claude-night-market và đã có
uvcùng GNU make 3.82+.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT