Cổng Chất Lượng Mã (Code Quality)

Kỹ năng chất lượng mã với bốn chế độ: dọn dẹp nợ kỹ thuật, lint bằng ruff/biome, cổng chất lượng Python và cổng đa ngôn ngữ.

Lập trìnhTrung cấp★ 445⑂ 51Điểm AI 9/10Cập nhật lần cuối: 3 thg 11, 2026

Làm được gì

Kỹ năng chọn một trong bốn chế độ dựa trên yêu cầu của bạn:

Dọn dẹp: quét 9 nhóm nợ kỹ thuật (TODO cũ, import không dùng, mã chết, thiếu type hint, hàm deprecated, đặt tên thiếu nhất quán, độ phức tạp cao, mã trùng lặp, thiếu docstring) theo quy trình 3 pha SCOPE → SCAN → REPORT, xếp ưu tiên Quick Wins → Important → Polish.
Lint: Ruff cho Python, Biome cho JS/TS; đọc pyproject.toml và biome.json trước để giữ nguyên cấu hình dự án.
Cổng chất lượng Python: chạy lần lượt ruff check, ruff format --check, mypy, pytest (kèm coverage), bandit; chạy hết dù có bước thất bại và báo lỗi theo file:line.
Cổng chất lượng đa ngôn ngữ: tự nhận diện Python, Go, JavaScript, TypeScript, Rust, Shell qua các marker (go.mod, Cargo.toml, package.json...) và chạy công cụ tương ứng, hỗ trợ --staged, --fix, --lang.

Kỹ năng không sửa luật lint hay bỏ qua test chỉ để cho qua, và chỉ tự động sửa khi bạn cho phép rõ ràng.

Phù hợp với ai

Lập trình viên làm monorepo nhiều ngôn ngữ cần chuẩn lint thống nhất
Dev Python muốn chạy ruff/mypy/bandit/pytest một lượt trước khi mở PR
Trưởng nhóm cần báo cáo nợ kỹ thuật có cơ sở cho codebase cũ

Ví dụ sử dụng

"Tìm import thừa và mã chết trong module này" → chế độ dọn dẹp, báo cáo ưu tiên Quick Wins
"Chạy cổng chất lượng Python trước khi commit" → chạy đủ 5 bước và tóm tắt trạng thái từng công cụ
"Chỉ lint các file đã staged" → chạy script cổng đa ngôn ngữ với --staged như một bước pre-commit

· · · 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.

↓ 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 AI 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.
Tải mã nguồn: git clone https://github.com/notque/vexjoy-agent.git /tmp/vexjoy-agent
Tạo thư mục kỹ năng: mkdir -p ~/.claude/skills
Sao chép kỹ năng: cp -r /tmp/vexjoy-agent/skills/code-quality/code-quality ~/.claude/skills/code-quality
Kiểm tra bằng ls ~/.claude/skills/code-quality xem có SKILL.md và thư mục references không.
Cài công cụ cần thiết: Python dùng pip install ruff mypy bandit pytest; JS/TS kiểm tra bằng npx @biomejs/biome --version.
Khởi động lại Claude Code rồi thử yêu cầu "code quality check" hoặc "run ruff" để kích hoạt kỹ năng.

Xem mã nguồn trên GitHub ↗Giấy phép: MIT