Viết commit message với AI: để lịch sử Git không còn 'fix', 'ok'

Viết commit message với AI: vì sao diff chỉ cho AI thấy đổi gì chứ không phải vì sao, cách tách commit, viết thân giải thích và mô tả pull request mà không bịa.

Commit message tốt cho người đọc sau biết một thay đổi làm gì và vì sao. AI viết được phần "làm gì" từ diff, nhưng "vì sao" chỉ có trong đầu bạn, nên bạn phải đưa nó vào. Bạn có hay commit "fix" rồi quên mất mình sửa gì không? Cùng mình xem nhé!

Một buổi tối làm xong tính năng, và lịch sử Git để lại gì?

Ở bài trước, mình làm cho app sổ chi tiêu (bot Telegram) tính năng sửa tin nhắn: người dùng sửa một tin đã gửi thì khoản chi tương ứng được cập nhật. Tính năng chạy, có test. Nhưng nếu bạn làm cả việc đó trong một buổi tối và commit theo kiểu "xong một chút thì lưu", thì sáng hôm sau lịch sử sẽ trông rất khó đọc.

Để bạn làm lại được mà không cần mở bài trước, mình dựng hai kho Git nhỏ bằng một script. Cả hai kho ghi lại đúng một chuỗi thay đổi, chỉ khác cách đặt tên commit. Kho thứ nhất, lon-xon, là kiểu commit mà ai cũng từng làm. Kho thứ hai, gon-gang, là cùng chuỗi thay đổi nhưng được tách và đặt tên cho đúng. Script dùng một bot tí hon (hai dòng code) và một file spec, vì mục đích chỉ là có thứ để commit. Nội dung thật của bot không quan trọng ở bài này.

tao-lich-su.ts
// Dựng hai kho Git tạm (trong thư mục tạm của hệ điều hành) cho cùng một buổi tối làm tính năng "sửa tin nhắn":
// một kho commit lộn xộn, một kho commit gọn có phần thân giải thích. Chạy: node tao-lich-su.ts <thư-mục-đích>
import { execFileSync } from "node:child_process";
import { mkdirSync, rmSync, writeFileSync } from "node:fs";
import { join } from "node:path";

const dich = process.argv[2];
if (!dich) throw new Error("Cách dùng: node tao-lich-su.ts <thư-mục-đích>");

const SPEC_V12 = "# Spec sổ chi tiêu v1.2\n\n- Gửi \"cà phê 25k\" thì bot ghi một khoản chi.\n";
const SPEC_V13 = SPEC_V12.replace("v1.2", "v1.3") + "- Sửa một tin nhắn đã gửi thì khoản chi tương ứng được cập nhật, không ghi thêm.\n";
const NHAN_TIN = 'bot.on("message:text", handleMessage);\n';
const BOT = {
  goc: NHAN_TIN,
  saiBoLoc: NHAN_TIN + 'bot.on("edited_message.text", handleEdit);\n',
  dungBoLoc: NHAN_TIN + 'bot.on("edited_message:text", handleEdit);\n',
  // Tìm khoản chi theo message_id của tin được sửa, không lấy khoản cuối cùng.
  timTheoId: NHAN_TIN + 'bot.on("edited_message:text", handleEdit); // tìm khoản chi theo message_id\n',
};
const TEST = 'test("sửa tin nhắn thì cập nhật khoản chi, không ghi thêm", () => {});\n';
const GHI_CHU = "# Kiểm chứng code AI viết\n\nChạy thử, biên dịch, rồi test. Tìm tên hàm trong code thư viện.\n";

type Buoc = { message: string; files: Record<string, string> };

// Cùng một chuỗi thay đổi, ghi lại theo hai cách.
const LON_XON: Buoc[] = [
  { message: "fix", files: { "src/bot.ts": BOT.saiBoLoc } },
  { message: "sửa lại", files: { "src/bot.ts": BOT.dungBoLoc } },
  { message: "ok", files: { "src/bot.test.ts": TEST } },
  { message: "update", files: { "spec.md": SPEC_V13, "README.md": "# Sổ chi tiêu\n\nXem spec.md.\n" } },
  { message: "fix tiếp", files: { "src/bot.ts": BOT.timTheoId } },
  { message: "xong", files: { "docs/kiem-chung.md": GHI_CHU } },
];

const GON_GANG: Buoc[] = [
  { message: "docs(spec): thêm yêu cầu v1.3, sửa tin nhắn thì cập nhật khoản chi", files: { "spec.md": SPEC_V13 } },
  {
    message: [
      "feat(bot): cập nhật khoản chi khi người dùng sửa tin nhắn",
      "",
      'Telegram gửi tin nhắn được sửa như một update riêng ("edited_message"), nên handler',
      '"message:text" không nhận được. Trước đây bot bỏ qua và khoản chi giữ số tiền cũ.',
      "",
      "Tìm khoản chi theo message_id của tin được sửa, không theo thứ tự: người dùng có thể",
      "sửa một tin cũ chứ không chỉ tin cuối cùng.",
    ].join("\n"),
    files: { "src/bot.ts": BOT.timTheoId },
  },
  { message: "test(bot): thêm test cho việc sửa tin nhắn", files: { "src/bot.test.ts": TEST } },
  { message: "docs: ghi lại cách kiểm chứng code AI viết", files: { "docs/kiem-chung.md": GHI_CHU } },
];

function dungKho(ten: string, cacBuoc: Buoc[]): void {
  const thuMuc = join(dich, ten);
  rmSync(thuMuc, { recursive: true, force: true });
  mkdirSync(join(thuMuc, "src"), { recursive: true });
  mkdirSync(join(thuMuc, "docs"), { recursive: true });
  const git = (...args: string[]) => execFileSync("git", ["-c", "user.name=Minh", "-c", "user.email=minh@example.com", ...args], { cwd: thuMuc, stdio: "pipe" });
  git("init", "-q");
  // Commit đầu tiên của cả hai kho giống nhau: spec v1.2 và bot chưa biết sửa tin nhắn.
  writeFileSync(join(thuMuc, "spec.md"), SPEC_V12);
  writeFileSync(join(thuMuc, "src/bot.ts"), BOT.goc);
  git("add", "-A");
  git("commit", "-q", "-m", "chore: khởi tạo kho với bot ghi khoản chi");
  for (const buoc of cacBuoc) {
    for (const [file, noiDung] of Object.entries(buoc.files)) writeFileSync(join(thuMuc, file), noiDung);
    git("add", "-A");
    git("commit", "-q", "-m", buoc.message);
  }
}

dungKho("lon-xon", LON_XON);
dungKho("gon-gang", GON_GANG);
console.log(`Đã dựng 2 kho trong ${dich}: lon-xon (7 commit gồm commit khởi tạo) và gon-gang (5 commit gồm commit khởi tạo)`);

Bạn cần Git và Node.js 22.18 trở lên (Node chạy thẳng file .ts từ bản đó). Chạy với một thư mục tạm bất kỳ, rồi in lịch sử của cả hai kho:

Dựng hai kho rồi xem lịch sử
mkdir kho-thu
node tao-lich-su.ts kho-thu
git -C kho-thu/lon-xon log --oneline --reverse
git -C kho-thu/gon-gang log --oneline --reverse
Kết quả (mã commit của bạn sẽ khác)
Đã dựng 2 kho trong kho-thu: lon-xon (7 commit gồm commit khởi tạo) và gon-gang (5 commit gồm commit khởi tạo)
51a41fd chore: khởi tạo kho với bot ghi khoản chi
99eb9b4 fix
1d6e8b2 sửa lại
92a5c51 ok
d83be22 update
888f25b fix tiếp
3afd503 xong
bdcb713 chore: khởi tạo kho với bot ghi khoản chi
751fc5a docs(spec): thêm yêu cầu v1.3, sửa tin nhắn thì cập nhật khoản chi
ace7b00 feat(bot): cập nhật khoản chi khi người dùng sửa tin nhắn
be310ee test(bot): thêm test cho việc sửa tin nhắn
d7e2605 docs: ghi lại cách kiểm chứng code AI viết

Bảy dòng đầu là của lon-xon, năm dòng sau là của gon-gang. Cả hai cùng bắt đầu bằng một commit khởi tạo giống hệt nhau.

Lịch sử lộn xộn làm khó ai, và khi nào?

Nhìn thì chỉ là chuyện thẩm mỹ, nhưng cái giá xuất hiện đúng lúc bạn cần đến lịch sử. Giả sử một tháng sau có người (có thể chính bạn) đọc dòng thứ hai của file src/bot.ts và thắc mắc: vì sao handler này lại có ghi chú "tìm khoản chi theo message_id"? Cách tra là git blame, lệnh cho biết mỗi dòng được commit nào sửa lần cuối:

Ai sửa dòng 2 của bot.ts, và vì sao?
git -C kho-thu/lon-xon blame -L2,2 -- src/bot.ts
git -C kho-thu/gon-gang blame -L2,2 -- src/bot.ts
Kết quả
888f25b2 (Minh 2026-11-12 09:03:41 +0700 2) bot.on("edited_message:text", handleEdit); // tìm khoản chi theo message_id
ace7b00b (Minh 2026-11-12 09:03:41 +0700 2) bot.on("edited_message:text", handleEdit); // tìm khoản chi theo message_id

Dòng đầu trỏ tới commit 888f25b, tức "fix tiếp". Dòng sau trỏ tới ace7b00. Cả hai đều tìm ra đúng commit, nhưng khi mở từng commit ra bằng git show, bạn thấy hai chuyện rất khác nhau. Với "fix tiếp", bạn chỉ có đoạn diff và phải tự đoán vì sao. Với ace7b00, bạn đọc được thế này:

Đọc cả message của commit
git -C kho-thu/gon-gang show -s --format=%B ace7b00
Kết quả
feat(bot): cập nhật khoản chi khi người dùng sửa tin nhắn

Telegram gửi tin nhắn được sửa như một update riêng ("edited_message"), nên handler
"message:text" không nhận được. Trước đây bot bỏ qua và khoản chi giữ số tiền cũ.

Tìm khoản chi theo message_id của tin được sửa, không theo thứ tự: người dùng có thể
sửa một tin cũ chứ không chỉ tin cuối cùng.

Đây mới là thứ người đọc sau cần: vấn đề là gì, vì sao chọn cách này. Tài liệu của chính Git cũng nói như vậy về phần thân của commit message: nó nên giải thích vấn đề mà thay đổi giải quyết, và vì sao cách giải quyết đó tốt hơn. Bạn có thể đọc nguyên văn trong hướng dẫn gửi patch của Git. Cùng tài liệu đó khuyên viết dòng mô tả như đang ra lệnh cho code ("make xyzzy do frotz", chứ không phải "I changed xyzzy"). Với tiếng Việt, mình áp dụng đơn giản là bắt đầu bằng một động từ: thêm, sửa, cập nhật, bỏ.

Kiểm tra commit bằng máy

Nhìn bằng mắt thì hai kho khác nhau rõ rệt, nhưng nếu muốn nhắc nhở cả nhóm (hoặc nhắc chính mình lúc 11 giờ đêm), bạn cần một thứ kiểm tra tự động. Mình viết một script nhỏ đọc lịch sử một kho Git và chấm từng commit theo vài quy tắc. Các quy tắc này do mình tự đặt cho bài này. Dự án thật nên dùng công cụ có sẵn như commitlint, hoặc đặt quy tắc theo thỏa thuận của nhóm bạn.

kiem-commit.ts
// Kiểm tra các commit trong một kho Git theo vài quy tắc đơn giản. Chạy: node kiem-commit.ts <đường-dẫn-kho>
// Đây là bộ quy tắc mình tự đặt cho bài này, không phải tiêu chuẩn của Git hay của Conventional Commits.
import { execFileSync } from "node:child_process";

export const MAX_SUBJECT = 72;
const KIEU = /^(feat|fix|docs|test|refactor|chore|perf|build|ci|style)(\([\w-]+\))?!?: \S.*/;
// Dòng tiêu đề chỉ có một từ chung chung thì không nói gì về thay đổi.
const MO_HO = /^(fix|update|ok|xong|sửa|sửa lại|fix tiếp|wip|test|tmp)$/i;

export type Commit = { hash: string; subject: string; body: string };

export function checkCommit({ subject, body }: Commit): string[] {
  const problems: string[] = [];
  if (MO_HO.test(subject.trim())) problems.push("tiêu đề mơ hồ, không nói đã đổi gì");
  else if (!KIEU.test(subject)) problems.push("không theo dạng kiểu(phạm vi): mô tả");
  if (subject.length > MAX_SUBJECT) problems.push(`tiêu đề dài ${subject.length} ký tự (tối đa ${MAX_SUBJECT})`);
  // Thay đổi thêm tính năng hoặc sửa lỗi nên nói vì sao; docs/test thường không cần.
  if (/^(feat|fix)[(:!]/.test(subject) && body.trim() === "") problems.push("thiếu phần thân giải thích vì sao");
  return problems;
}

export function readCommits(repo: string): Commit[] {
  const raw = execFileSync("git", ["log", "--reverse", "--format=%h%x00%s%x00%b%x01"], { cwd: repo, encoding: "utf8" });
  return raw.split("\x01").map((chunk) => chunk.trim()).filter(Boolean).map((chunk) => {
    const [hash, subject, body = ""] = chunk.split("\x00");
    return { hash, subject, body };
  });
}

if (import.meta.main) {
  const repo = process.argv[2];
  if (!repo) throw new Error("Cách dùng: node kiem-commit.ts <đường-dẫn-kho>");
  let withProblems = 0;
  const commits = readCommits(repo);
  for (const commit of commits) {
    const problems = checkCommit(commit);
    if (problems.length) withProblems++;
    console.log(`${problems.length ? "✗" : "✓"} ${commit.hash} ${commit.subject}${problems.map((p) => `\n    - ${p}`).join("")}`);
  }
  console.log(`\n${commits.length} commit, ${withProblems} commit có vấn đề`);
}

Chạy trên cả hai kho:

Chấm hai kho
node kiem-commit.ts kho-thu/lon-xon
node kiem-commit.ts kho-thu/gon-gang
Kết quả
✓ 51a41fd chore: khởi tạo kho với bot ghi khoản chi
✗ 99eb9b4 fix
    - tiêu đề mơ hồ, không nói đã đổi gì
✗ 1d6e8b2 sửa lại
    - tiêu đề mơ hồ, không nói đã đổi gì
✗ 92a5c51 ok
    - tiêu đề mơ hồ, không nói đã đổi gì
✗ d83be22 update
    - tiêu đề mơ hồ, không nói đã đổi gì
✗ 888f25b fix tiếp
    - tiêu đề mơ hồ, không nói đã đổi gì
✗ 3afd503 xong
    - tiêu đề mơ hồ, không nói đã đổi gì

7 commit, 6 commit có vấn đề
✓ bdcb713 chore: khởi tạo kho với bot ghi khoản chi
✓ 751fc5a docs(spec): thêm yêu cầu v1.3, sửa tin nhắn thì cập nhật khoản chi
✓ ace7b00 feat(bot): cập nhật khoản chi khi người dùng sửa tin nhắn
✓ be310ee test(bot): thêm test cho việc sửa tin nhắn
✓ d7e2605 docs: ghi lại cách kiểm chứng code AI viết

5 commit, 0 commit có vấn đề

Sáu trên bảy commit của kho đầu bị báo, vì tiêu đề không nói gì. Kho sau đạt hết. Mình cũng viết bốn test cho checkCommit (tiêu đề mơ hồ bị báo, feat thiếu thân bị báo, docs thì không, tiêu đề quá dài bị báo) và cả bốn đều xanh khi chạy bằng node --test.

Ngoài cách đặt tên, còn một khác biệt nữa giữa hai kho mà script không đo được: kho thứ hai có bốn commit, mỗi commit một việc. Điều đó đến từ cách làm, không từ cách viết. Bạn nên tách commit theo ý nghĩa, không theo thời điểm bạn nhớ ra: một commit cho spec, một cho tính năng, một cho test, một cho tài liệu. Khi đã lỡ làm lẫn trong một lần, git add -p cho phép bạn chọn từng đoạn thay đổi để đưa vào từng commit. Lợi ích thực tế là nếu một commit gây lỗi, bạn hoàn tác đúng một việc bằng git revert mà không kéo theo mấy việc khác.

Nhờ AI viết message: AI thấy gì và không thấy gì?

Giờ đến phần chính. Khi bạn nhờ AI viết commit message, thứ nó đọc được thường là phần thay đổi (git diff). Diff cho biết các dòng nào bị thêm, bị xóa. Nó không cho biết vì sao bạn làm vậy. Mình sẽ cho bạn thấy sự khác nhau bằng một thay đổi mới: người dùng báo bot dừng nhận tin sau một lỗi, và mình thêm một dòng bot.catch để lỗi chỉ được ghi lại.

Trước hết là chỗ AI vấp. Nếu bạn chỉ dán diff, câu trả lời bạn nhận được sẽ là phần "đổi gì". Mình viết tay một ví dụ về kiểu câu trả lời đó, vì mình không chạy mô hình ở bài này:

Ví dụ minh họa: AI chỉ nhận diff
feat(bot): thêm bot.catch để xử lý lỗi

Message này đúng theo nghĩa đen, nhưng đọc xong bạn vẫn không biết đã xảy ra chuyện gì với bot. Còn nếu bạn đưa thêm ý định của mình (một hai câu về vì sao), AI có chất liệu để viết phần thân. Script dưới đây dựng prompt từ các thay đổi đã git add, kèm ý định, rồi bạn dán prompt đó vào công cụ AI nào bạn dùng:

tao-prompt.ts
// Dựng prompt nhờ AI viết commit message từ các thay đổi đã `git add`. Không gọi AI: chỉ in prompt để bạn dán vào công cụ bạn dùng.
// Chạy: node tao-prompt.ts <đường-dẫn-kho> "<ý định của bạn: vì sao đổi>"
import { execFileSync } from "node:child_process";

export const MAX_DIFF_CHARS = 12_000;

const git = (repo: string, ...args: string[]) => execFileSync("git", args, { cwd: repo, encoding: "utf8" }).trim();

export function buildPrompt(repo: string, intent: string): string {
  const diff = git(repo, "diff", "--staged");
  if (!diff) throw new Error("Chưa có gì được git add: không có thay đổi nào để mô tả.");
  if (!intent.trim()) throw new Error("Thiếu ý định: diff chỉ cho thấy ĐỔI GÌ, AI không thể đoán VÌ SAO bạn đổi.");
  const files = git(repo, "diff", "--staged", "--stat");
  const recent = git(repo, "log", "-5", "--format=- %s");
  const cut = diff.length > MAX_DIFF_CHARS;
  return [
    "Viết commit message bằng tiếng Việt cho các thay đổi dưới đây.",
    "Quy tắc:",
    "- Dòng đầu: kiểu(phạm vi): mô tả ngắn, tối đa 72 ký tự, không dấu chấm cuối. Kiểu là feat, fix, docs, test, refactor hoặc chore.",
    "- Cách một dòng trống, rồi phần thân (2 đến 5 dòng) giải thích VÌ SAO đổi và vì sao chọn cách này, không kể lại từng dòng code.",
    "- Chỉ dùng thông tin có trong diff và trong ý định của mình. Không nhắc test, benchmark hay tác dụng nào mà diff không cho thấy.",
    "- Nếu diff gồm nhiều việc không liên quan nhau, đừng viết một message chung: nói rõ nên tách thành mấy commit và tách thế nào.",
    "",
    "Tiêu đề các commit gần đây (để giữ cùng phong cách):",
    recent,
    "",
    `Ý định của mình: ${intent.trim()}`,
    "",
    "Các file đổi:",
    files,
    "",
    cut ? `Diff (đã cắt còn ${MAX_DIFF_CHARS} ký tự đầu, vì dài quá; hãy tách commit nhỏ hơn):` : "Diff:",
    cut ? diff.slice(0, MAX_DIFF_CHARS) : diff,
  ].join("\n");
}

if (import.meta.main) {
  const [repo, ...intent] = process.argv.slice(2);
  if (!repo) throw new Error('Cách dùng: node tao-prompt.ts <đường-dẫn-kho> "<ý định>"');
  console.log(buildPrompt(repo, intent.join(" ")));
}

Mình có ba lý do cho cách dựng này. Một là script từ chối chạy nếu bạn không đưa ý định, vì thiếu nó thì kết quả chỉ là "đổi gì". Hai là prompt kèm năm tiêu đề commit gần nhất, để AI viết cùng phong cách với dự án của bạn thay vì tự chọn một kiểu. Ba là prompt dặn AI chỉ dùng thông tin có trong diff và ý định, và nếu diff chứa nhiều việc thì nói rõ nên tách, thay vì cố gộp.

Để thử, bạn thêm một dòng vào src/bot.ts của kho gon-gang, rồi git add và chạy script:

Tạo một thay đổi mới rồi dựng prompt
printf 'bot.catch((err) => console.error(err.error));\n' >> kho-thu/gon-gang/src/bot.ts
git -C kho-thu/gon-gang add src/bot.ts
node tao-prompt.ts kho-thu/gon-gang "Lúc xử lý tin nhắn bị lỗi thì bot dừng nhận tin luôn. Thêm bot.catch để lỗi chỉ được ghi lại, bot vẫn chạy."
Kết quả: prompt sẵn sàng để dán
Viết commit message bằng tiếng Việt cho các thay đổi dưới đây.
Quy tắc:
- Dòng đầu: kiểu(phạm vi): mô tả ngắn, tối đa 72 ký tự, không dấu chấm cuối. Kiểu là feat, fix, docs, test, refactor hoặc chore.
- Cách một dòng trống, rồi phần thân (2 đến 5 dòng) giải thích VÌ SAO đổi và vì sao chọn cách này, không kể lại từng dòng code.
- Chỉ dùng thông tin có trong diff và trong ý định của mình. Không nhắc test, benchmark hay tác dụng nào mà diff không cho thấy.
- Nếu diff gồm nhiều việc không liên quan nhau, đừng viết một message chung: nói rõ nên tách thành mấy commit và tách thế nào.

Tiêu đề các commit gần đây (để giữ cùng phong cách):
- docs: ghi lại cách kiểm chứng code AI viết
- test(bot): thêm test cho việc sửa tin nhắn
- feat(bot): cập nhật khoản chi khi người dùng sửa tin nhắn
- docs(spec): thêm yêu cầu v1.3, sửa tin nhắn thì cập nhật khoản chi
- chore: khởi tạo kho với bot ghi khoản chi

Ý định của mình: Lúc xử lý tin nhắn bị lỗi thì bot dừng nhận tin luôn. Thêm bot.catch để lỗi chỉ được ghi lại, bot vẫn chạy.

Các file đổi:
src/bot.ts | 1 +
 1 file changed, 1 insertion(+)

Diff:
diff --git a/src/bot.ts b/src/bot.ts
index ce0837d..7fe7e26 100644
--- a/src/bot.ts
+++ b/src/bot.ts
@@ -1,2 +1,3 @@
 bot.on("message:text", handleMessage);
 bot.on("edited_message:text", handleEdit); // tìm khoản chi theo message_id
+bot.catch((err) => console.error(err.error));

Với prompt đó, một câu trả lời tốt trông như dưới đây. Đây là ví dụ minh họa do mình viết tay, không phải kết quả của một lần chạy cụ thể, để bạn biết mình mong đợi gì:

Ví dụ minh họa: AI nhận diff và ý định
fix(bot): không dừng nhận tin khi xử lý một tin nhắn bị lỗi

Khi handler ném lỗi, bot dừng và không nhận tin nhắn nào nữa. Thêm bot.catch
để lỗi chỉ được ghi ra console, các tin nhắn sau vẫn được xử lý.

Dòng đầu cho biết việc làm, thân cho biết vì sao. Nhưng đừng dán nguyên văn. Trước khi commit, mình đọc lại và hỏi: mỗi câu trong message có đúng với diff không? Chẳng hạn nếu AI viết thêm "đã thêm test cho trường hợp này", mà diff không có file test nào, thì đó là lời bịa, và bạn phải xóa nó. Message là bản ghi lâu dài về thay đổi của bạn, nên người chịu trách nhiệm cho từng chữ trong đó là bạn, không phải công cụ.

Mô tả pull request cũng cùng nguyên tắc

Pull request mô tả cho cả một nhánh thay vì một commit, và người đọc là reviewer đang có ít thời gian. Mình dùng một khung bốn mục khi nhờ AI viết nháp:

Khung mô tả pull request
## Vì sao
Vấn đề gì, ai gặp, bằng chứng (đường dẫn lỗi, ảnh chụp).

## Đổi gì
Hai đến bốn gạch đầu dòng, nói ở mức khái niệm, không chép lại diff.

## Kiểm tra thế nào
Lệnh đã chạy và kết quả thật. Nếu chưa chạy cái gì thì ghi rõ chưa chạy.

## Cần reviewer để ý
Chỗ mình chưa chắc, quyết định có thể tranh luận, thay đổi ảnh hưởng chỗ khác.

Mục thứ ba là nơi AI dễ bịa nhất, vì nó có thể viết "đã chạy toàn bộ test và đều xanh" dù chưa ai chạy. Quy tắc của mình là mục đó do mình điền từ kết quả thật, hoặc nếu để AI điền thì mình chạy lại lệnh và so với những gì nó viết. Với pull request ở dự án làm việc nhóm, đây là chỗ reviewer tin vào bạn nhất, nên cũng là chỗ sai lầm đắt nhất.

Ghi nhớ gì khi làm cùng AI

Nếu phải tóm lại thành vài thói quen, thì mình giữ ba cái. Thứ nhất, tách commit theo việc trước khi nhờ AI viết, vì một diff chứa ba việc không liên quan thì không message nào hay được. Thứ hai, luôn đưa ý định vào prompt, ngay cả khi chỉ là một câu. Thứ ba, đọc lại mọi câu trong kết quả và xóa những gì không có trong diff. Ba thói quen đó mất chưa tới một phút mỗi commit.

Nếu bạn lỡ có một nhánh lộn xộn như lon-xon và nó chỉ của riêng bạn, chưa ai dùng chung, bạn có thể đặt lại tên commit bằng git rebase -i hoặc git commit --amend. Mình không chạy hai lệnh đó trong bài này, và bạn chỉ nên làm với nhánh chưa chia sẻ, vì sửa lịch sử đã đẩy lên chung sẽ làm người khác khó chịu.

Có thay đổi rồi, ai sẽ review nó?

Giờ mỗi commit của app sổ chi tiêu kể được một câu chuyện, và pull request mô tả được vì sao nó tồn tại. Nhưng có một câu hỏi chưa ai trả lời: trước khi gộp, ai đọc đoạn code đó và nhìn ra chỗ bạn không thấy? Nhờ AI làm người review đầu tiên có ích đến đâu, và làm sao để dùng nó mà vẫn giữ được khả năng đọc code của chính mình, là việc của các bài viết sau.

Bạn theo dõi cả hành trình ở Làm side project cùng AI. Nếu đang ôn phỏng vấn, các câu hỏi về cách dùng AI khi lập trình và về pull request có trong ngân hàng câu hỏi phỏng vấn.

Nhận bài tiếp theo qua email.

Một email mỗi tuần, chỉ khi có điều đáng đọc. Không spam.