- Soát phần đã git add trước khi nhờ AI viết thông điệp commit: công cụ AI đọc diff, nên khóa nằm trong diff cũng được gửi cho mô hình.
- Theo tài liệu git commit, thông điệp nên mở đầu bằng một dòng ngắn không quá 50 ký tự, một dòng trống, rồi phần mô tả.
- Xóa khóa ở commit sau không xóa nó khỏi lịch sử. Theo GitHub, việc đầu tiên khi lộ khóa là thu hồi hoặc đổi khóa.
- Lệnh xóa và viết lại lịch sử do AI gợi ý: chạy thử git clean -n trước, dùng --force-with-lease thay vì --force.
Code trong bài là Python, chỉ dùng thư viện chuẩn và lệnh git; phần kiểm tạo một kho Git thật trong thư mục tạm. Khóa trong ví dụ là chuỗi giả.
AI giúp được gì với Git
Ba việc AI làm tốt nhất với Git: viết thông điệp commit từ thay đổi, giải thích một lệnh hay một thông báo lỗi khó hiểu, và gợi ý cách gỡ xung đột khi gộp nhánh. Cả ba đều tiết kiệm thời gian thật. Nhưng cả ba đều cần bạn đọc lại, vì Git ghi nhớ mọi thứ: một thông điệp sai, một tệp nhạy cảm, một lần gộp nhầm, đều nằm lại trong lịch sử của kho.
Nếu bạn mới làm quen với Git, đọc trước bài Git và GitHub là gì. Bài này giả định bạn đã biết add, commit, push.
Trước khi commit: soát những gì đã add
Lỗi phổ biến nhất khi làm việc nhanh với AI là git add tất cả rồi commit. Tệp .env chứa khóa API, một dòng code AI viết sẵn kèm khóa mẫu mà bạn đã thay bằng khóa thật, khóa SSH riêng chép nhầm vào thư mục dự án, đều đi theo. Thêm một lý do mới: các công cụ AI sinh thông điệp commit hoạt động bằng cách đọc diff của phần đã add. Nếu diff có khóa, khóa được đưa vào yêu cầu gửi cho mô hình.
Vì vậy hãy soát trước. Đoạn Python dưới đây đọc phần đã git add bằng chính lệnh git, báo các tệp nhạy cảm như .env, id_rsa, tệp .pem, và mọi dòng thêm mới trông giống khóa bí mật, như gán API_KEY bằng một chuỗi dài hay một chuỗi bắt đầu bằng sk-. Nó cũng soát thông điệp commit theo hướng dẫn của Git.
"""Soát những gì sắp commit, trước khi để AI viết thông điệp commit hay đẩy lên GitHub.
1. Tệp nhạy cảm đã được git add: .env, khóa SSH riêng, tệp .pem, credentials.json.
2. Dòng thêm mới trông như khóa bí mật (API_KEY = "...", token, mật khẩu, chuỗi bắt đầu bằng sk-).
3. Thông điệp commit: theo tài liệu git commit, nên mở đầu bằng một dòng ngắn không quá 50 ký tự,
sau đó là một dòng trống rồi mới tới phần mô tả.
Chạy trong thư mục kho: python soat_truoc_commit.py "thông điệp commit". Chỉ dùng thư viện chuẩn và lệnh git.
"""
import fnmatch
import re
import subprocess
import sys
TEP_NHAY_CAM = [".env", ".env.*", "id_rsa", "id_ed25519", "*.pem", "credentials.json"]
GIONG_KHOA = re.compile(r"""(?ix)
(api[_-]?key|secret|token|password|mat_khau)\s*[:=]\s*["']?[A-Za-z0-9_\-./+]{12,}
| \bsk-[A-Za-z0-9_\-]{16,}""")
def git(*lenh, kho="."):
return subprocess.run(["git", "-C", kho, *lenh], capture_output=True, text=True, encoding="utf-8", check=True).stdout
def tep_da_add(kho="."):
return [t for t in git("diff", "--cached", "--name-only", "-z", kho=kho).split("\0") if t]
def dong_them(kho="."):
"""[(tệp, số dòng, nội dung)] cho mọi dòng được thêm trong phần đã git add."""
kq, tep, so = [], None, 0
for dong in git("diff", "--cached", "-U0", "--no-color", kho=kho).splitlines():
if dong.startswith("+++ "):
tep = dong[6:] if dong.startswith("+++ b/") else None
elif dong.startswith("@@"):
so = int(re.search(r"\+(\d+)", dong).group(1))
elif dong.startswith("+") and tep:
kq.append((tep, so, dong[1:]))
so += 1
return kq
def soat_thong_diep(td):
dong = td.splitlines()
loi = []
if not dong or not dong[0].strip():
return ["thông điệp rỗng"]
if len(dong[0]) > 50:
loi.append(f"dòng đầu dài {len(dong[0])} ký tự, nên không quá 50")
if len(dong) > 1 and dong[1].strip():
loi.append("cần một dòng trống sau dòng đầu")
return loi
def soat(kho=".", thong_diep=None):
bao = []
for t in tep_da_add(kho):
ten = t.rsplit("/", 1)[-1]
if any(fnmatch.fnmatch(ten, m) for m in TEP_NHAY_CAM):
bao.append(f"tệp nhạy cảm đã add: {t}")
for t, so, nd in dong_them(kho):
if GIONG_KHOA.search(nd):
bao.append(f"{t}:{so}: trông như khóa bí mật")
if thong_diep is not None:
bao += [f"thông điệp: {x}" for x in soat_thong_diep(thong_diep)]
return bao
if __name__ == "__main__":
ket_qua = soat(".", sys.argv[1] if len(sys.argv) > 1 else None)
print("\n".join(ket_qua) if ket_qua else "Không thấy vấn đề")
sys.exit(1 if ket_qua else 0)
Phần kiểm đi kèm tạo một kho Git trong thư mục tạm, add một tệp app.py có khóa giả ở dòng 2 và dòng 3, một tệp .env và một tệp README. Chương trình báo đúng ba điều: tệp .env, dòng 2 và dòng 3 của app.py; README không bị báo. Bạn có thể đặt chương trình này làm hook chạy trước mỗi lần commit để không phải nhớ.
Cách gốc rễ hơn: thêm .env vào .gitignore ngay khi tạo dự án, và đọc khóa từ biến môi trường, như bài giữ khóa API an toàn hướng dẫn.
Thông điệp commit
Phần Discussion trong tài liệu git commit viết: dù không bắt buộc, nên mở đầu thông điệp bằng một dòng ngắn, không quá 50 ký tự, tóm tắt thay đổi; tiếp theo là một dòng trống rồi phần mô tả kỹ hơn. Phần chữ tới dòng trống đầu tiên được Git coi là tiêu đề commit và dùng ở nhiều nơi, ví dụ khi chuyển commit thành email.
Thông điệp do AI viết hay mắc hai lỗi ngược nhau: quá chung chung, như "cập nhật code", hoặc quá dài, kể lại từng dòng thay đổi trong dòng đầu. Cách nhờ hiệu quả: dán diff kèm một câu bạn tự viết về lý do thay đổi, và yêu cầu dòng đầu dưới 50 ký tự nói thay đổi làm gì, phần mô tả nói vì sao. Mô hình đọc được code thay đổi thế nào, nhưng không biết vì sao bạn thay đổi; phần đó phải đến từ bạn. Chương trình soát ở trên báo khi dòng đầu quá 50 ký tự hoặc thiếu dòng trống.
Lỡ commit khóa rồi thì sao
Phản xạ tự nhiên là xóa khóa khỏi tệp rồi commit tiếp. Phần kiểm của bài làm đúng như vậy trong kho tạm: commit khóa giả, rồi commit thay bằng đọc từ biến môi trường. Lệnh git log -S tìm chuỗi khóa trong lịch sử vẫn thấy cả hai commit: commit thêm khóa và commit xóa khóa. Ai có bản sao của kho đều đọc được khóa.
Trang "Removing sensitive data from a repository" của GitHub nói rõ thứ tự: nếu dữ liệu nhạy cảm là một bí mật như mật khẩu, token, khóa, bước đầu tiên là thu hồi hoặc đổi nó; sau khi thu hồi, khóa không dùng được nữa, và điều đó có thể đã đủ giải quyết vấn đề. Viết lại lịch sử để xóa hẳn là việc phức tạp hơn nhiều, và theo trang này, dữ liệu vẫn có thể còn trong các bản sao, các fork, các pull request tham chiếu tới commit cũ. Nên đừng để AI dẫn bạn vào viết lại lịch sử trước; hãy vào trang quản lý khóa và thu hồi ngay.
Lệnh xóa và viết lại lịch sử
Khi bạn hỏi "làm sao dọn sạch thư mục" hay "làm sao bỏ commit vừa rồi", AI có thể đưa những lệnh mạnh. Ba lệnh cần chậm lại:
- git clean. Xóa các tệp chưa được Git theo dõi, những tệp này không có trong lịch sử nên xóa là mất. Tài liệu git clean ghi -n, hay --dry-run, chỉ cho thấy sẽ xóa gì mà không xóa; và mặc định Git từ chối xóa nếu thiếu -f. Luôn chạy -n trước. Phần kiểm của bài chạy git clean -n trong kho tạm: Git in "Would remove rac.tmp" và tệp vẫn còn.
- git reset --hard. Bỏ mọi thay đổi chưa commit trong thư mục làm việc. Nếu còn việc dở, lưu lại bằng git stash hay một commit tạm trước.
- git push --force. Ghi đè nhánh trên máy chủ. Tài liệu git push mô tả --force-with-lease bảo vệ nhánh từ xa bằng cách chỉ cho đẩy khi nhánh đó vẫn đúng như lần cuối bạn lấy về; nếu bạn cùng nhóm vừa đẩy thêm, lệnh từ chối thay vì xóa mất công của họ.
Bài AI viết lệnh terminal có thêm cách đọc lệnh trước khi chạy, áp dụng cho cả lệnh Git.
Gỡ xung đột khi gộp nhánh
Khi gộp nhánh bị xung đột, Git đánh dấu hai phiên bản trong tệp. Dán phần xung đột cho AI để nó giải thích hai bên khác nhau thế nào là cách dùng tốt. Nhưng đừng để nó chọn bên thay bạn: chỉ bạn biết thay đổi nào là đúng ý nhóm. Sau khi sửa, chạy lại chương trình và test trước khi commit phần gộp, vì một xung đột gỡ sai có thể biên dịch được mà vẫn chạy sai.
Ví dụ: đồ án nhóm trên GitHub
Nhóm bốn bạn làm đồ án trên một kho GitHub chung. Một bạn nhờ AI viết đoạn gọi API, dán khóa thật vào để thử, rồi git add tất cả và nhờ công cụ AI viết thông điệp commit. Thông điệp ra đẹp, commit được đẩy lên. Hôm sau, bạn khác chạy chương trình soát trên máy mình và đọc lại lịch sử thì thấy khóa. Cả nhóm làm theo thứ tự đúng: thu hồi khóa cũ trên trang của nhà cung cấp, tạo khóa mới cất trong .env, thêm .env vào .gitignore, rồi gắn chương trình soát làm hook trước mỗi commit. Một bạn đề xuất dùng git push --force để xóa commit cũ; nhóm bàn và quyết định không làm, vì khóa đã thu hồi, còn ghi đè lịch sử có thể làm mất commit của người khác.
- git add tất cả rồi commit mà không xem phần đã add.
- Để công cụ AI đọc diff có chứa khóa thật.
- Nghĩ rằng xóa khóa ở commit sau là đủ.
- Viết lại lịch sử trước khi thu hồi khóa đã lộ.
- Chạy git clean -f hay git reset --hard theo lời AI mà không chạy thử, không lưu việc dở.
- Dùng git push --force trên nhánh chung thay vì --force-with-lease.
Câu hỏi thường gặp
Thông điệp commit nên viết thế nào?
Dòng đầu ngắn không quá 50 ký tự, một dòng trống, rồi phần mô tả vì sao thay đổi.
Lỡ đẩy khóa API lên GitHub thì làm gì trước?
Thu hồi hoặc đổi khóa ngay; xóa khỏi tệp hay lịch sử không làm khóa hết hiệu lực.
git clean -n làm gì?
Chỉ cho thấy những tệp sẽ bị xóa, không xóa gì.
--force-with-lease khác --force thế nào?
Chỉ đẩy đè khi nhánh trên máy chủ vẫn như lần cuối bạn lấy về, tránh xóa công của người khác.
Học tiếp
Nếu bạn muốn học Python và AI bài bản cùng giảng viên, tham khảo khóa học AI của Big-O Coding.
Khóa AI – Introduction to Machine Learning: nền tảng Máy học từ thuật toán cơ bản đến Neural Networks và LLM, học bằng Python. Học thử buổi 1 miễn phí.


