Lười Viết Commit Git? Đã Có AI Lumen Lo Hết, Tối Ưu Tận Răng Cho Dev Việt!

Lê Lân

19/06/2025

Hướng Dẫn Sử Dụng Lumen: Công Cụ AI Hỗ Trợ Viết Git Commit Cho Developer

Mở Đầu

Viết Git commit message rõ ràng và chuẩn chỉnh là một thách thức không nhỏ, đặc biệt với các developer không sử dụng tiếng Anh làm ngôn ngữ chính.

Trong phát triển phần mềm, commit message không chỉ giúp nhóm phát triển hiểu được thay đổi mà còn là chìa khóa cho việc quản lý lịch sử dự án hiệu quả. Tuy nhiên, việc tạo ra những commit message chuyên nghiệp và súc tích thường mất nhiều thời gian và công sức. Lumen là một công cụ hỗ trợ dựa trên trí tuệ nhân tạo, giúp tự động hóa quá trình này, từ đó nâng cao năng suất làm việc và giảm thiểu lỗi khi viết commit.

Bài viết này sẽ hướng dẫn bạn cách sử dụng Lumen, xử lý một số lỗi thường gặp, và giới thiệu một script Fish shell giúp tối ưu hóa quy trình làm việc với công cụ này.

Lumen Là Gì?

Lumen là một công cụ dòng lệnh (CLI) dùng AI để tự động phân tích sự thay đổi mã nguồn và sinh ra các commit message theo chuẩn, giúp bạn:

Tiết kiệm thời gian viết commit

Tăng độ chính xác và chuẩn chỉnh cho từng commit

Hỗ trợ đặc biệt cho dev không thông thạo tiếng Anh

Bạn có thể tìm hiểu và tải mã nguồn tại GitHub Lumen .

1. Cách Sử Dụng Lumen

1.1. Chức Năng Chính

Lumen có khả năng dựa trên phần khác biệt ( diff ) của mã nguồn để tạo ra commit message phù hợp với chuẩn commit convention (như Conventional Commits).

1.2. Lệnh Cơ Bản

Sau khi chỉnh sửa/ thêm mới tập tin trong dự án, bạn chạy:

lumen draft

Ví dụ, nếu bạn đã sửa đổi tập tin README.md :

lumen draft

Kết quả hiển thị sẽ là:

feat(README): Add test section

Lệnh trên chỉ hiển thị commit message được tạo mà chưa thực hiện git commit.

1.3. Commit Ngay Lập Tức

Nếu bạn muốn tạo commit luôn sau khi hỏi Lumen, có thể dùng kết hợp với git:

lumen draft | git commit -F -

Lệnh này sẽ lấy nội dung được tạo ra từ lumen và gửi thẳng tới git commit.

Lưu ý: Luôn kiểm tra và xác nhận nội dung commit trước khi gửi để tránh lỗi.

2. Xử Lý Lỗi Thường Gặp Khi Dùng Lumen

2.1. Lỗi Diff Trống

Khi chạy lệnh:

lumen draft

và nhận được lỗi:

error: diff (staged) is empty

Nguyên nhân là do Lumen mặc định sử dụng git diff --staged để lấy sự khác biệt, nhưng bạn chưa thêm tập tin vào khu vực staging ( git add ), dẫn đến diff trống.

2.2. Giải Pháp Sửa Mã Nguồn Lumen

Để Lumen lấy diff dựa trên khu vực làm việc (working tree) thay vì chỉ khu vực staged, bạn cần:

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

Mở file src/command/mod.rs

Tìm dòng chứa Diff::from_working_tree(true)

Thay đổi thành Diff::from_working_tree(false)

Mẫu diff sửa:

Trước	Sau
Diff::from_working_tree(true)	Diff::from_working_tree(false)

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

Sau khi biên dịch lại, lúc chạy lumen draft sẽ lấy diff từ thư mục làm việc trực tiếp, giúp lệnh hoạt động khi chưa stage file.

Việc tùy chỉnh này giúp linh hoạt khi bạn chưa muốn dùng git add nhưng vẫn muốn xem commit message.

3. Tối Ưu Công Việc Với Fish Shell Script

3.1. Vấn Đề

Đôi khi commit message được AI sinh ra có thể chứa lỗi hoặc không như mong muốn. Dùng commit trực tiếp có thể dẫn đến commit sai thông tin.

3.2. Giải Pháp: Xác Nhận Trước Khi Commit

Bạn có thể sử dụng công cụ gum ( https://github.com/charmbracelet/gum ) để thêm bước xác nhận thủ công trước khi commit.

Dưới đây là một hàm trong Fish shell giúp bạn:

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

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

Cài đặt lumen và gum

Thêm đoạn hàm aic vào file cấu hình Fish shell: ~/.config/fish/config.fish

Khi muốn commit, chạy lệnh:

aic

Review commit message hiển thị

Xác nhận commit (Yes/No)

4. Tổng Kết

Lumen là một công cụ hữu ích giúp tự động tạo ra commit message đúng chuẩn, tiết kiệm thời gian và công sức cho developer, đặc biệt là nhóm dùng tiếng Anh không phải ngôn ngữ mẹ đẻ.

Công cụ dễ dùng, tích hợp tốt với Git

Có thể sửa mã nguồn để xử lý diff theo ý muốn

Kết hợp Fish shell và gum giúp quy trình commit an toàn, hiệu quả

Giúp cải thiện chất lượng commit và nâng cao năng suất làm việc

Bạn hãy thử tích hợp Lumen vào workflow để trải nghiệm sự tiện lợi mà nó mang lại nhé!

Tham Khảo

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

Charmbracelet Gum: https://github.com/charmbracelet/gum

Conventional Commits: https://www.conventionalcommits.org/en/v1.0.0/

Git Official Documentation: https://git-scm.com/doc

June 10, 2024