AI Skill MartKhám phá skillLệnhChương trìnhHọcSkill là gì?
 
← Về danh sách

Kiểm tra chất lượng comment

Rà soát comment trong code để phát hiện các từ mang tính thời điểm như "mới", "hiện tại", "đã cải thiện" và viết lại thành mô tả code làm gì và tại sao.

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

Làm được gì

  • Quét comment trong .go, .py, .js, .ts, .md, .txt để tìm từ chỉ thời gian (new, old, now, latest), hoạt động phát triển (added, fixed, refactored), chuyển trạng thái (migrated, deprecated) và so sánh tương đối (better than, instead of).
  • Loại bỏ dương tính giả: header bản quyền/giấy phép, marker @generated, tên biến hay chuỗi ký tự.
  • Chạy theo 4 pha SCAN → ANALYZE → REWRITE → REPORT, mỗi pha có điều kiện "cổng" phải đạt mới đi tiếp.
  • Bác bỏ bản viết lại chỉ xoá từ mà không thêm thông tin; yêu cầu câu comment cụ thể, giải thích WHAT/WHY.
  • Xuất báo cáo có đường dẫn file, số dòng, nội dung hiện tại, đề xuất và lý do; chỉ tự động sửa khi người dùng cho phép rõ ràng.

Phù hợp với ai

  • Lập trình viên tiếp nhận codebase cũ đầy comment kể lịch sử thay đổi
  • Tech lead muốn chuẩn hoá quy ước comment cho cả nhóm
  • Người dọn dẹp README và tài liệu của dự án Go/Python/JS/TS

Ví dụ sử dụng

  1. "Rà soát comment trong thư mục src/auth" → nhận đề xuất đổi // giờ dùng JWT thành // Xác thực request bằng JWT đã ký.
  2. "Tìm comment lỗi thời và tự sửa" → quét toàn bộ rồi áp dụng Edit sau khi các đề xuất qua checklist chất lượng.
  3. Dọn README: đổi "đã cải thiện ở bản mới nhất" thành mô tả hành vi thực tế để tài liệu không bị lỗi thời.

· · · 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 AI 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 && mkdir -p ~/.claude/skills && cp -r 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. Clone repo: git clone https://github.com/notque/vexjoy-agent.git
  3. Tạo thư mục skill: mkdir -p ~/.claude/skills
  4. Copy skill: cp -r vexjoy-agent/skills/code-quality/comment-quality ~/.claude/skills/
  5. Kiểm tra thư mục references/ đã được copy: ls ~/.claude/skills/comment-quality
  6. Khởi động lại Claude Code và yêu cầu kiểu "review comments trong thư mục này". Muốn sửa tự động thì nói rõ "tự động sửa giúp tôi".
Xem mã nguồn trên GitHub ↗Giấy phép: MIT