Cổng Chất lượng Mã nguồn (Code Quality)
Một skill gộp bốn chế độ: dọn dẹp nợ kỹ thuật, lint bằng Ruff/Biome, quality gate cho Python và gate đa ngôn ngữ.
Lập trìnhTrung cấp★ 421⑂ 44Điểm AI 9/10Cập nhật lần cuối: 19 thg 9, 2026
Làm được gì
Skill tự chọn một trong bốn chế độ dựa trên câu lệnh của bạn:
- Cleanup: quét 9 nhóm nợ kỹ thuật (TODO cũ, import thừa, code chết, thiếu type hint, trùng lặp...) và xếp ưu tiên theo tác động/công sức.
- Linting: Ruff cho Python, Biome cho JS/TS; đọc
pyproject.tomlvàbiome.jsonđể giữ nguyên cấu hình sẵn có. - Python Quality Gate: chạy tuần tự ruff → ruff format → mypy → pytest → bandit, không dừng khi một bước fail, báo cáo theo file:line.
- Universal Quality Gate: tự nhận diện Python, Go, JavaScript, TypeScript, Rust, Shell qua file marker và chạy công cụ tương ứng (
--staged,--fix,-v).
Chỉ áp dụng sửa tự động khi bạn cho phép rõ ràng, sau đó xem git diff và chạy lại kiểm tra.
Phù hợp với ai
- Lập trình viên Python/JS muốn tự động hóa kiểm tra chất lượng trước khi commit.
- Nhóm làm monorepo nhiều ngôn ngữ cần một cổng chất lượng thống nhất.
- Người tiếp quản codebase cũ, cần bản đồ nợ kỹ thuật rõ ràng.
Ví dụ sử dụng
- "Tìm code chết và TODO cũ trong thư mục src" → chế độ Cleanup hỏi phạm vi rồi xuất báo cáo theo nhóm.
- "Chạy quality gate Python trước khi commit" → chạy đủ 5 bước và liệt kê lỗi theo mức ưu tiên.
- "Lint chỉ các file đã staged" →
run_quality_gate.py --stagednhận diện ngôn ngữ của file thay đổi và kiểm tra.
· · · 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/notque/vexjoy-agent/HEAD/skills/code-quality/code-quality/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 skills/code-quality/code-quality từ repo GitHub notque/vexjoy-agent vào ~/.claude/skills/code-quality/ 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/notque/vexjoy-agent.git /tmp/vexjoy-agent && mkdir -p ~/.claude/skills && cp -r /tmp/vexjoy-agent/skills/code-quality/code-quality ~/.claude/skills/code-quality⚠ Đâ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:
git clone https://github.com/notque/vexjoy-agent.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r vexjoy-agent/skills/code-quality/code-quality ~/.claude/skills/code-quality - Kiểm tra đã có thư mục
references/và scriptuniversal-quality-gate/scripts/run_quality_gate.py:ls -R ~/.claude/skills/code-quality - Cài công cụ cần thiết:
pip install ruff pytest mypy bandit; với JS/TS đảm bảo có Node.js để chạynpx @biomejs/biome. - Khởi động lại Claude Code và thử gõ: "chạy quality gate cho dự án Python này".
Xem mã nguồn trên GitHub ↗Giấy phép: MIT