Claude Skill MartKhám phá skillCâu dùng ngayHọc qua videoDùng terminalSkill là gì?
Về danh sách

Hợp đồng kiến trúc Night Market

Ghi lại các quyết định thiết kế trọng yếu, bất biến và điểm yếu đã biết của repo claude-night-market để tham chiếu khi đánh giá một thay đổi thiết kế.

Lập trìnhNâng cao32933Điểm AI 7/10Cập nhật lần cuối: 16 thg 8, 2026

Kỹ năng này làm gì

Đây là "hợp đồng kiến trúc" của repo claude-night-market.

  • 6 quyết định trọng yếu: mỗi plugin phải tự chứa và cài độc lập (không có thư viện dùng chung ở gốc), hook phải tương thích Python 3.9 của hệ thống, marketplace.json là nguồn phiên bản duy nhất, description skill giới hạn 160 ký tự, bộ nhớ tập thể qua GitHub Discussions, và bảng phân loại 3 vai trò của skill.
  • Bảng bất biến: nêu rõ cơ chế thực thi (workflow CI, script ratchet, guard test) và hậu quả nếu vi phạm.
  • 5 điểm yếu đã biết: tràn ngân sách khám phá skill xảy ra âm thầm, mdbook chưa ghim phiên bản, một số tài liệu bị ghi đè mỗi chu kỳ...
  • Tóm tắt 17 ADR kèm bộ lệnh shell để kiểm chứng lại các con số dễ thay đổi.

Mọi khẳng định đều trích dẫn ADR, mã commit hoặc đường dẫn file thực thi nên có thể xác minh trực tiếp.

Phù hợp với ai

  • Người đóng góp hoặc tự vận hành fork của claude-night-market
  • Người quản lý monorepo nhiều plugin và muốn quy định rõ "chỗ nào dùng chung, chỗ nào phải nhân bản"
  • Người muốn học từ các sự cố thực tế của hệ sinh thái hook/skill Claude Code

Ví dụ sử dụng

  1. Muốn gom tiện ích trùng lặp của 3 plugin thành module chung → kỹ năng dẫn ADR-0001 và các commit 054e2679/29961cd2 đã bị revert để giải thích lý do từ chối.
  2. Thêm một Stop hook mới → kiểm tra 5 quy tắc: đọc payload JSON từ stdin, không dùng đường dẫn tương đối, timeout subprocess phải nhỏ hơn ngân sách trong hooks.json...
  3. Nâng phiên bản lên 1.9.16 → nhắc dùng update_versions.py thay vì sửa tay và liệt kê các manifest cần đồng bộ.

· · · 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-architecture-contract/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)
  1. Tải tệp ZIP bằng nút bên dưới.
  2. Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
  3. Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Tải ZIP
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-architecture-contract từ repo GitHub athola/claude-night-market vào ~/.claude/skills/night-market-architecture-contract/ 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 && mkdir -p ~/.claude/skills && cp -r claude-night-market/.claude/skills/night-market-architecture-contract ~/.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.

  1. Mở terminal.
  2. Tải repo: git clone https://github.com/athola/claude-night-market.git
  3. Tạo thư mục skill: mkdir -p ~/.claude/skills
  4. Sao chép kỹ năng: cp -r claude-night-market/.claude/skills/night-market-architecture-contract ~/.claude/skills/
  5. Khởi động lại Claude Code và thử yêu cầu "kiểm tra hợp đồng kiến trúc" để xác nhận kỹ năng đã nạp.
  6. Lưu ý: các ADR, script và test được trích dẫn chỉ tồn tại trong repo claude-night-market; hãy chạy Claude Code ngay trong thư mục repo đã clone nếu muốn dùng các lệnh xác minh.