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

Kiểm định chất lượng bình luận mã

Rà soát bình luận trong mã nguồn, phát hiện các câu mô tả lịch sử thay đổi dễ lỗi thời và viết lại thành bất biến hiện tại hoặc lý do thiết kế.

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

Làm được gì

  • Chỉ quét các tệp bạn chỉ định, tìm bình luận phụ thuộc vào một phiên bản cũ không được nêu rõ, ví dụ "now uses JWT", "fixed retry handling", "faster than before".
  • Danh sách từ khóa references/temporal-keywords.md chỉ là gợi ý ứng viên; skill vẫn đọc cú pháp bình luận và mã xung quanh trước khi kết luận, bỏ qua chuỗi ký tự và tên định danh.
  • Giữ nguyên header pháp lý, dấu mã sinh tự động, chú thích API/phiên bản bắt buộc và thông báo deprecation còn hữu ích.
  • Quy trình cho mỗi phát hiện: đọc hàm bao quanh → xác định sự thật bền vững (hành vi hay lý do) → viết lại hoặc xóa → báo cáo tệp:dòng, bản gốc, bản thay thế và bất biến suy ra.
  • Không bịa lý do chỉ từ hình dạng mã; nếu ý định mơ hồ thì giữ nguyên và nêu điểm mơ hồ. Chỉ sửa khi được yêu cầu.

Phù hợp với ai

  • Lập trình viên tiếp quản codebase cũ, cần đồng bộ bình luận với hành vi thực tế.
  • Trưởng nhóm muốn thêm mục "chất lượng bình luận" vào checklist review.
  • Bất kỳ ai muốn giảm nợ tài liệu, không phụ thuộc ngôn ngữ hay stack.

Ví dụ sử dụng

  1. "Rà soát bình luận trong thư mục src/auth" → đề xuất đổi "// now uses JWT" thành "// Token là JWT ký bằng RS256".
  2. Chỉ quét các tệp trong diff của Pull Request và xuất danh sách tệp:dòng để dán vào review.
  3. Với "// fixed the race condition", nếu không suy ra được lý do bền vững thì giữ nguyên và báo là ý định chưa rõ.

· · · 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/comment-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)
  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 skills/code-quality/comment-quality từ repo GitHub notque/vexjoy-agent vào ~/.claude/skills/comment-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/comment-quality ~/.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 mã nguồn: git clone https://github.com/notque/vexjoy-agent.git
  3. Tạo thư mục skill: mkdir -p ~/.claude/skills
  4. Sao chép cả thư mục (kèm tệp tham chiếu): cp -r vexjoy-agent/skills/code-quality/comment-quality ~/.claude/skills/
  5. Kiểm tra trong ~/.claude/skills/comment-quality/ có SKILL.md và references/temporal-keywords.md.
  6. Khởi động lại Claude Code, rồi yêu cầu kiểu "xem lại chất lượng bình luận của các tệp này". Lưu ý skill đặt user-invocable: false nên thường được gọi gián tiếp qua quy trình review.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT