Bí Kíp “Tắm Trắng” Git Commit Message Bằng AI: Quẳng Gánh Lo Tiếng Anh Đi Mà Vui Sống!

Lê Lân

11/07/2025

Hướng Dẫn Sử Dụng Lumen: Công Cụ AI Hỗ Trợ Viết Git Commit Chuẩn Cho Nhà Phát Triển

Mở Đầu

Việc viết Git commit message rõ ràng và chuẩn mực là một bước quan trọng trong quá trình phát triển phần mềm, giúp nhóm dễ dàng theo dõi thay đổi và phối hợp hiệu quả. Tuy nhiên, với nhiều nhà phát triển, đặc biệt là những người không dùng tiếng Anh làm ngôn ngữ chính, việc tạo commit message đúng chuẩn có thể trở nên khá khó khăn và tốn thời gian.

Lumen là một công cụ ứng dụng trí tuệ nhân tạo (AI), giúp tự động tạo ra các commit message dựa trên các thay đổi trong mã nguồn. Công cụ này giúp đơn giản hóa workflow, tăng tính nhất quán và chất lượng của các commit message trong các dự án mã nguồn mở hoặc nội bộ. Bài viết này sẽ giới thiệu chi tiết cách sử dụng Lumen, giải quyết các lỗi thường gặp, đồng thời cung cấp một đoạn script Fish shell để tối ưu hóa quy trình làm việc.

Cách Sử Dụng Lumen

Tổng Quan Về Chức Năng

Lumen hoạt động dựa trên phân tích sự khác biệt trong mã nguồn ( git diff ), sau đó tự động gợi ý nội dung commit message theo đúng cấu trúc chuẩn như:

feat(README): Add test section

Cách Thực Hiện Cơ Bản

Mở terminal và điều hướng vào thư mục dự án Git.

Chạy lệnh:

lumen draft

Ví dụ, nếu bạn vừa sửa đổi file README.md và chạy lệnh trên, Lumen sẽ phân tích thay đổi và trả về commit message phù hợp nhưng chưa thực hiện commit.

Thực Hiện Commit Tự Động

Để kết hợp việc tạo commit message và thực hiện commit ngay lập tức, bạn có thể chạy:

lumen draft | git commit -F -

Giải thích: Lệnh này vừa lấy nội dung commit do Lumen tạo, vừa truyền trực tiếp cho git commit với option -F - (đọc message từ stdin).

Lưu ý rằng commit message chỉ được tạo dựa trên những thay đổi đã được stage ( git add ). Nếu chưa stage, Lumen sẽ không phát hiện ra các thay đổi.

Giải Quyết Các Vấn Đề Thường Gặp

Lỗi `error: diff (staged) is empty`

Khi chạy lumen draft , nếu bạn gặp thông báo lỗi:

error: diff (staged) is empty

Điều này nghĩa là Lumen đang sử dụng git diff --staged để so sánh thay đổi, nhưng bạn chưa thêm thay đổi vào vùng stage ( git add ), làm cho diff rỗng.

Cách Sửa Lỗi

Bạn có thể chỉnh sửa code nguồn của Lumen để chuyển sang dùng git diff trên thư mục làm việc (working tree) thay vì diff staged.

Các bước thực hiện:

Tải về mã nguồn Lumen từ https://github.com/jnsahaj/lumen .

Mở file src/command/mod.rs , tìm dòng chứa Diff::from_working_tree(true) (khoảng dòng 45).

Thay đổi tham số từ true thành false :

- git_entity: GitEntity::Diff(Diff::from_working_tree(true)?),
+ git_entity: GitEntity::Diff(Diff::from_working_tree(false)?),

Lưu file và biên dịch lại Lumen.

Bây giờ chạy lumen draft sẽ lấy diff trên thư mục làm việc mà không cần phải stage file trước.

Việc này giúp tránh phải mất thời gian gọi git add trước khi tạo commit message, tăng tính tiện lợi trong quá trình phát triển cá nhân.

Tối Ưu WorkFlow Với Fish Shell Script

Vấn Đề Cần Giải Quyết

Khi sử dụng Lumen tự động tạo commit message, đôi khi AI có thể sinh ra nội dung chưa chính xác hoặc bạn muốn kiểm tra lại trước khi commit thực sự.

Giải Pháp: Thêm Bước Xác Nhận Với Gum

Bạn có thể sử dụng công cụ gum để thêm hộp thoại xác nhận trước khi thực hiện commit.

Script Fish Shell Tự Động Tạo và Xác Nhận Commit

function aic
    set RESULT (lumen draft)
    echo $RESULT
    echo "Committing..."
    gum confirm "是否提交代码？" && git commit -a -m "$RESULT" || echo "已取消提交"
end

Hướng Dẫn Sử Dụng

Cài đặt lumen và gum trên hệ thống của bạn.

Thêm đoạn function trên vào file cấu hình Fish shell (thường là ~/.config/fish/config.fish ).

Khi sửa mã nguồn, chỉ cần chạy lệnh aic để:

Lumen tự động tạo commit message

Hiển thị message đó trên màn hình

Hỏi bạn xác nhận có muốn commit ngay không

Nếu chọn đồng ý, chạy lệnh git commit -a -m "message" để commit

Nếu không, hủy bỏ mà không commit

Phương pháp này giúp bạn chủ động kiểm soát nội dung commit, tránh commit nhầm hoặc chứa lỗi do AI tạo ra.

Kết Luận

Lumen là một giải pháp tuyệt vời dành cho các nhà phát triển, đặc biệt là những người không dùng tiếng Anh thường xuyên, muốn viết commit message chuẩn, rõ ràng và tiết kiệm thời gian. Việc kết hợp Lumen với các công cụ hỗ trợ như Fish shell và Gum sẽ giúp bạn tối ưu hóa quy trình làm việc, tăng tính chính xác và hiệu quả khi thao tác với Git.

Nên trải nghiệm và tùy chỉnh công cụ để phù hợp nhất với workflow và thói quen phát triển cá nhân hoặc nhóm của bạn.

Tham Khảo

Lumen - GitHub Repository: https://github.com/jnsahaj/lumen

Gum - GitHub Repository: https://github.com/charmbracelet/gum

Git Documentation: https://git-scm.com/docs

Fish Shell Documentation: https://fishshell.com/docs/current/index.html

Các bài viết về tạo commit message hiệu quả trên medium & dev.to