Chia việc cho Claude Code thành từng phần nhỏ, commit sau mỗi phần để giữ chất lượng

Tóm tắt nhanh
Nên chia việc cho Claude Code thành các phần đủ nhỏ để bạn xem hết thay đổi trong một lượt, giao từng phần, xong thì dừng và commit. Phiên làm việc quá dài có thể làm đầy ngữ cảnh và khiến chất lượng giảm, còn phạm vi rõ giúp Claude Code làm tốt hơn và giúp bạn kiểm tra dễ hơn.
Câu trả lời ngắn: đừng giao Claude Code cả một dự án hay cả một báo cáo trong một phiên dài. Hãy chia thành từng phần nhỏ, giao một phần, xem kết quả, rồi commit trước khi sang phần kế tiếp. Làm vậy chất lượng giữ ổn hơn và bạn luôn có một mốc an toàn để quay lại.
Lý do nằm ở chỗ Claude Code làm việc dựa trên ngữ cảnh, tức là toàn bộ những gì đã nói, đã đọc, đã sửa trong phiên. Phiên càng kéo dài, ngữ cảnh càng đầy. Khi nó đầy, chất lượng kết quả có thể giảm. Giao cả cục nghe tiện, nhưng cái tiện đó thường đổi bằng việc bạn phải đọc một đống thay đổi lẫn lộn, khó biết chỗ nào đúng, chỗ nào sai.
Bài này đi sâu hơn video ngắn bên dưới: vì sao phiên dài làm giảm chất lượng, chia thế nào cho vừa, câu giao việc mẫu, ba tình huống đời thật, và những lỗi người mới hay mắc. Bài đứng ở khâu "chia nhỏ để giữ chất lượng" trong series giao việc rõ, kiểm tra kỹ. Các khâu như viết câu giao việc, đọc lại thay đổi hay viết file hướng dẫn dự án đã có bài riêng, mình chỉ nhắc khi cần.
I.Bản chất: vì sao phiên dài làm giảm chất lượng
A.Ngữ cảnh là bộ nhớ làm việc, và nó có giới hạn
Hãy hình dung Claude Code như một đồng nghiệp mới có một cái bàn làm việc. Mọi thứ đang cần dùng đều phải nằm trên bàn: yêu cầu của bạn, các file đã mở, kết quả chạy lệnh, những lần sửa đi sửa lại. Bàn có diện tích cố định. Khi bàn chất đầy giấy tờ, đồng nghiệp đó vẫn làm việc được, nhưng dễ nhầm giấy này với giấy kia, dễ bỏ sót một dặn dò từ đầu buổi.
Phiên làm việc với Claude Code cũng vậy. Mỗi câu bạn gõ, mỗi file nó đọc, mỗi đoạn lỗi nó xem đều chiếm chỗ trong ngữ cảnh. Kéo dài đủ lâu thì chỗ trống còn lại ít dần. Theo dữ kiện của tập video, phiên quá dài có thể làm đầy ngữ cảnh và khiến chất lượng kết quả giảm. Mình không nói được chính xác lúc nào thì giảm, vì nó phụ thuộc vào độ phức tạp của việc và cách bạn làm. Điều chắc chắn là nguy cơ có thật và tăng theo độ dài phiên.
B.Giảm chất lượng trông như thế nào
Nó hiếm khi báo lỗi to. Dấu hiệu hay gặp là những thứ nhỏ:
- Nó quên một ràng buộc bạn đã nói từ đầu, ví dụ định dạng ngày hay quy ước đặt tên.
- Nó sửa lại phần đã chốt, làm hỏng thứ vốn đang chạy tốt.
- Câu trả lời dài hơn nhưng ít cụ thể hơn.
- Nó lặp lại một cách làm đã thử và đã thất bại.
Vì những dấu hiệu này âm thầm, bạn dễ bỏ qua và chỉ phát hiện khi mọi thứ đã chồng lên nhau. Lúc đó sửa rất tốn công.
C.Phạm vi rõ cũng quan trọng không kém độ dài phiên
Ngoài chuyện ngữ cảnh đầy, còn một lý do thứ hai: Claude Code làm tốt nhất khi phạm vi nhiệm vụ được giới hạn rõ. Nếu bạn nói "làm cho xong báo cáo", nó phải tự đoán báo cáo gồm những gì, làm đến đâu thì dừng. Đoán nhiều thì lệch nhiều. Nếu bạn nói "chỉ sửa bộ lọc ngày, chưa sửa xuất Excel", ranh giới đã rõ, nó có ít chỗ để đoán và ít lý do để lan sang file khác.
D.Commit là mốc, không chỉ là lưu
Trong cách làm này, commit không đơn thuần là lưu file. Mỗi commit là một mốc hoàn tất: phần này đã xong, đã xem, đã chấp nhận. Có mốc thì bạn quay lại được khi phần sau làm hỏng. Cũng nhờ mốc mà bạn biết rõ "đến đây là ổn", khỏi phải nhớ trong đầu.
II.Làm thế nào: chia nhỏ và chốt từng phần
- Chọn phần nhỏCắt việc lớn thành phần mà bạn xem hết thay đổi được trong một lượt
- Nói rõ phạm viGhi cả điều cần làm lẫn điều chưa làm trong câu giao việc
- Để Claude Code làmGiao đúng một phần, chưa giao phần sau
- Xem lại thay đổiĐọc hết thay đổi của phần đó, chạy thử nếu được
- CommitXong và ổn thì commit một lần cho phần đó
- Giao phần kế tiếpChỉ sau khi đã có mốc, mới giao việc tiếp theo
A.Tiêu chí chia: đủ nhỏ để xem hết trong một lượt
Đây là mẹo của mình, không phải quy tắc chính thức: một phần đủ nhỏ khi bạn xem hết thay đổi của nó trong một lượt mà không phải cuộn mệt. Nếu xem xong bạn vẫn không dám chắc nó đúng hay sai, phần đó còn quá to.
Có vài cách tự hỏi để cắt:
- Phần này có thể mô tả bằng một câu không? Nếu cần ba câu nối bằng chữ "và", hãy tách.
- Phần này có chạy thử độc lập được không? Phần nào kiểm tra được riêng thì nên là một phần.
- Nếu phần này hỏng, mình bỏ nó đi có ảnh hưởng phần khác không? Phần càng ít dính nhau càng dễ chia.
Không có con số cứng như "tối đa bao nhiêu dòng". Việc quen tay thì phần có thể to hơn, việc lạ hoặc nhạy cảm thì nên cắt nhỏ hơn.
B.Câu giao việc có hai vế: làm gì và chưa làm gì
Chi tiết hay bị bỏ qua nhất ở video là chữ nhấn "nói rõ cả phần chưa làm". Khi bạn chỉ nói điều cần làm, Claude Code có thể tốt bụng làm luôn phần "tiện thể". Nghe thì có lợi, nhưng nó phá ranh giới và làm thay đổi trở nên khó xem. Nên thêm vế thứ hai:
Chỉ sửa bộ lọc ngày trong màn hình báo cáo. Chưa sửa phần xuất Excel, chưa đụng đến các màn hình khác. Làm xong thì dừng lại, tóm tắt bạn đã đổi những file nào, rồi chờ mình xem.Câu này có ba phần: phạm vi làm, phạm vi chưa làm, và điều kiện dừng. Bạn có thể lưu nó thành mẫu rồi chỉ thay tên phần việc.
C.Xong phần nào, dừng và commit phần đó
Sau khi Claude Code báo xong, bạn đọc lại thay đổi (cách đọc kỹ mình đã nói ở một tập khác trong series). Nếu ổn, commit. Bạn có thể tự gõ lệnh git, hoặc nhờ Claude Code tạo commit với thông điệp mô tả đúng phần vừa làm. Dù cách nào, nguyên tắc là một phần xong thì có một commit, không gộp nhiều phần vào một commit.
Thông điệp commit nên nói đúng phạm vi, ví dụ "Sửa bộ lọc ngày của báo cáo". Sau này nhìn lại lịch sử, bạn thấy từng bước rõ ràng.
D.Khi nào mở phiên mới
Chia phần chưa chắc đã cần mở phiên mới, nhưng hai việc này đi cùng nhau rất tự nhiên. Sau khi commit một phần, bạn có một điểm cắt sạch. Nếu phần vừa rồi kéo dài, nhiều lần sửa qua lại, đó là lúc hợp lý để bắt đầu phiên mới cho phần tiếp theo. Claude Code có các lệnh để dọn hoặc nén ngữ cảnh như /clear và /compact, bạn có thể thử khi thấy phiên đã nặng. Điều cần nhớ: phiên mới thì nó không còn nhớ chuyện cũ, nên những quy ước quan trọng nên nằm trong file CLAUDE.md của dự án để lần nào nó cũng đọc lại. Cách viết file này có một tập riêng trong series.
III.Dùng vào việc thật
A.Chủ shop làm báo cáo doanh thu có bộ lọc ngày và xuất Excel
Bối cảnh: chị Lan bán hàng online, có một trang báo cáo doanh thu nhỏ do thuê người làm. Chị muốn thêm bộ lọc theo ngày và nút xuất Excel. Nếu giao một câu "thêm lọc ngày và xuất Excel", Claude Code sẽ sửa cả hai cùng lúc, chị khó biết lỗi nằm ở đâu.
Chị chia làm hai lượt. Lượt đầu:
Trong trang báo cáo doanh thu, hãy thêm bộ lọc theo khoảng ngày (từ ngày, đến ngày). Chỉ làm bộ lọc ngày. Chưa làm nút xuất Excel, chưa đổi cách tính tổng doanh thu. Khi xong, liệt kê các file đã sửa và nói mình nên bấm thử thế nào để kiểm tra. Rồi dừng lại.Kết quả: một thay đổi gọn, tập trung vào phần lọc. Chị thử chọn vài khoảng ngày, so với số liệu mình biết. Chỗ cần kiểm tra kỹ: ngày đầu và ngày cuối có được tính vào không, và khi không chọn ngày thì báo cáo hiển thị thế nào. Ổn thì commit, rồi mới giao lượt hai: xuất Excel dựa trên dữ liệu đã lọc.
B.Kế toán dọn bảng tính đối chiếu công nợ
Bối cảnh: anh Hùng là kế toán, nhờ Claude Code viết một đoạn script xử lý file đối chiếu công nợ: chuẩn hoá tên khách hàng, gộp các dòng trùng, rồi tính số dư. Ba việc này dễ dính vào nhau, nên anh tách.
Viết script đọc file công nợ trong thư mục data. Việc duy nhất ở bước này: chuẩn hoá tên khách hàng (bỏ khoảng trắng thừa, thống nhất chữ hoa chữ thường). Chưa gộp dòng trùng, chưa tính số dư. Ghi kết quả ra một file mới, không sửa file gốc. Xong thì dừng và cho mình xem 10 dòng đầu trước và sau khi chuẩn hoá.Kết quả: script nhỏ, anh đọc hết được và so sánh trước/sau. Chỗ cần kiểm tra: những tên gần giống nhau có bị gộp nhầm không, và file gốc có còn nguyên không. Với dữ liệu tài chính thật, anh nên thử trên bản sao, vì dữ liệu nhạy cảm cần cẩn trọng, mình có một tập riêng về chuyện này. Ổn thì commit rồi mới sang bước gộp dòng trùng.
C.Dev mới sửa lỗi hiển thị rồi mới thêm tính năng
Bối cảnh: bạn Minh mới đi làm, được giao một lỗi hiển thị ngày sai múi giờ và đồng thời có yêu cầu thêm một cột mới vào bảng. Bạn muốn làm một lèo cho nhanh. Nhưng nếu lỗi múi giờ chưa chốt mà đã thêm cột, khi có gì lệch bạn không biết do đâu.
Chỉ sửa lỗi hiển thị ngày sai múi giờ trong bảng đơn hàng. Chưa thêm cột mới, chưa refactor gì khác. Nếu bạn thấy chỗ khác cũng có lỗi tương tự, hãy báo cho mình biết chứ đừng tự sửa. Xong thì dừng, tóm tắt thay đổi.Kết quả: một thay đổi nhỏ, đúng phạm vi, kèm danh sách chỗ nghi ngờ khác để bạn quyết định sau. Chỗ cần kiểm tra: chạy thử với dữ liệu ở đầu và cuối ngày, vì lỗi múi giờ hay lộ ra ở sát nửa đêm. Commit xong, bạn mới giao việc thêm cột. Nếu cột mới làm hỏng gì, bạn quay về đúng mốc trước đó.
IV.Góc nhìn khách quan
A.Điểm mạnh thật sự
Chia nhỏ giúp ba việc cùng lúc. Một là giữ ngữ cảnh gọn, nên kết quả ổn định hơn. Hai là bạn kiểm tra được: thay đổi nhỏ thì đọc hết, đọc hết thì mới dám tin. Ba là có đường lui: mỗi commit là một mốc, sai ở phần nào thì quay lại phần đó chứ không phải làm lại từ đầu.
Điểm đáng giá nhất là nó đổi cách bạn làm việc với AI: từ "giao rồi cầu may" sang "giao, xem, chốt, giao tiếp", giống cách bạn làm với một đồng nghiệp mới.
Phần nào bạn không xem hết được trong một lượt thì chưa nên coi là xong.
Ông T
B.Giới hạn và rủi ro
Cách này không miễn phí. Bạn phải bỏ thêm công suy nghĩ để chia việc ngay từ đầu, và phải ngồi xem từng lượt thay vì bỏ đi pha cà phê. Với việc thật sự nhỏ, chia nhỏ hơn nữa chỉ làm chậm thêm.
Vài rủi ro cần lưu ý:
- Chia sai chỗ: cắt đôi hai thứ dính chặt vào nhau thì phần đầu có thể chạy không nổi nếu thiếu phần sau. Khi đó hãy gộp lại cho hợp lý.
- Tốn lượt dùng: nhiều lượt giao việc nghĩa là nhiều lần Claude Code đọc lại file và ngữ cảnh. Với gói có giới hạn lượt dùng, bạn sẽ thấy chi phí này, dù cũng có thể bù lại bằng việc ít phải sửa lại.
- Commit không thay cho kiểm tra: commit chỉ là mốc. Nếu bạn commit mà chưa xem thì mốc đó chứa lỗi.
- Quyền truy cập file: dù phạm vi hẹp, Claude Code vẫn làm việc trong thư mục dự án của bạn. Đừng mở nó trong thư mục chứa dữ liệu nhạy cảm không liên quan.
Commit thường xuyên chỉ có ích khi dự án đã dùng git. Nếu chưa, hãy khởi tạo git và commit trạng thái hiện tại trước khi giao phần đầu tiên. Đừng đưa file chứa mật khẩu, khoá truy cập hay dữ liệu khách hàng thật vào commit.
C.Khi nào nên chọn cách khác
Nếu việc chỉ là một thay đổi nhỏ trong một file, bạn không cần chia gì cả, cứ giao thẳng. Nếu bạn chỉ muốn hỏi đáp, tìm hiểu ý tưởng hay soạn nội dung ngắn, một công cụ chat như ChatGPT cũng đủ, không cần dựng quy trình commit. Nếu bạn quen làm việc ngay trong trình soạn code, các công cụ như Cursor hay GitHub Copilot cũng có cách làm việc theo từng thay đổi nhỏ. Còn với việc lớn, nhiều file, cần chạy lệnh và sửa nhiều bước, cách chia phần của bài này phát huy tác dụng nhất. Nguyên tắc chia nhỏ khá chung nên có thể áp dụng cho các công cụ AI khác, bạn chỉ cần xem công cụ đó có chỗ để bạn kiểm tra từng thay đổi hay không.
V.Lỗi hay gặp và cách tránh
A.Giao cả cục rồi mới tính chia
Bạn giao "làm cả báo cáo", để nó chạy rất lâu, rồi mới thấy kết quả lộn xộn. Lúc đó chia lại là quá muộn. Cách tránh: chia ngay từ câu giao việc đầu tiên, và ghi rõ điều kiện dừng.
B.Chỉ nói điều cần làm, quên nói điều chưa làm
Nếu bạn chỉ viết "sửa bộ lọc ngày", Claude Code có thể sửa luôn xuất Excel vì thấy liên quan. Cách tránh: thêm một câu như "chưa sửa xuất Excel, chưa đụng đến màn hình khác". Vế này ngắn nhưng giữ được ranh giới.
C.Commit gộp nhiều phần, hoặc không commit
Làm xong ba phần mới commit một lần thì mất đúng cái bạn cần: mốc để quay lại. Ngược lại, không commit gì thì mọi thay đổi trộn vào nhau. Cách tránh: một phần xong, ổn thì commit ngay, thông điệp ghi đúng phạm vi.
D.Commit khi chưa xem thay đổi
Commit nhanh cho "có mốc" nhưng chưa đọc thì mốc đó có thể chứa lỗi, về sau bạn tưởng đó là điểm an toàn. Cách tránh: đọc hết thay đổi của phần đó, chạy thử nếu được, rồi mới commit. Nếu thay đổi to đến mức không đọc nổi, đó là tín hiệu phần này chia chưa đủ nhỏ.
E.Kéo phiên rất dài dù đã chia phần
Chia phần xong nhưng vẫn làm hết trong một phiên kéo dài nhiều giờ thì ngữ cảnh vẫn đầy. Cách tránh: sau một vài phần, khi thấy nó bắt đầu quên dặn dò hay lặp lại, hãy dọn ngữ cảnh hoặc mở phiên mới, và để quy ước quan trọng trong CLAUDE.md để không phải nhắc lại.
VI.Dự phóng: chủ đề này sẽ đi về đâu
Dưới đây là nhận định của Ông T dựa trên hướng đi chung của các công cụ lập trình bằng AI, không phải thông báo chính thức của ai.
A.Công cụ sẽ tự lo bớt việc quản lý ngữ cảnh
Mức chắc chắn: khả năng cao. Các công cụ agent đều có động lực giảm tình trạng "phiên dài thì chất lượng giảm", ví dụ bằng cách tóm tắt, nén hay chọn lọc thứ đưa vào ngữ cảnh. Nhưng dù công cụ giỏi lên, một phần việc vẫn do bạn: nói rõ phạm vi. Bạn nên chuẩn bị thói quen viết câu giao việc có ranh giới, vì thói quen này có giá trị dù công cụ đổi thế nào.
B.Chia việc sẽ dần được hỗ trợ ngay trong công cụ
Mức chắc chắn: có thể. Có xu hướng để AI tự đề xuất kế hoạch chia phần trước khi làm, rồi bạn duyệt từng phần. Nếu điều đó phổ biến hơn, vai trò của bạn chuyển từ người gõ lệnh sang người duyệt kế hoạch và duyệt kết quả. Bạn nên chuẩn bị bằng cách tập đánh giá "phần này có đủ nhỏ để kiểm tra không", kỹ năng này dùng được cho cả kế hoạch AI đề xuất.
C.Nhiều tác vụ chạy song song trên các phần tách biệt
Mức chắc chắn: có thể. Khi việc được chia thành các phần độc lập, việc để nhiều agent làm song song là bước tự nhiên. Nhưng song song làm tăng gánh nặng kiểm tra và nguy cơ xung đột giữa các phần. Bạn nên chuẩn bị bằng cách làm quen với việc tách phần thật sạch trước, và dùng git để giữ từng phần riêng biệt.
D.Kiểm tra tự động trở thành điểm dừng chuẩn
Mức chắc chắn: còn bỏ ngỏ. Có thể mốc "xong một phần" sẽ gắn với việc kiểm tra tự động chạy đạt, thay vì chỉ do người đọc. Tuy vậy mình chưa thấy cách nào thay hẳn được con mắt người, nhất là với báo cáo, số liệu hay việc có yếu tố kinh doanh. Bạn nên chuẩn bị bằng cách tập viết sẵn tiêu chí "thế nào là xong" cho từng phần, dù là bằng lời hay là một bài kiểm tra nhỏ.
VII.Bắt đầu từ đâu
Chia việc không phải kỹ thuật cao siêu. Nó chỉ là thói quen: giao ít, nói rõ, xem kỹ, commit, rồi giao tiếp. Bắt đầu với một việc nhỏ trong chính công việc của bạn là đủ thấy khác biệt.
Ba việc bạn làm được ngay hôm nay:
- Chọn một việc bạn định giao cho Claude Code, viết ra giấy hai hoặc ba phần nhỏ, mỗi phần mô tả được bằng một câu.
- Lưu câu giao việc mẫu có ba phần (làm gì, chưa làm gì, dừng khi nào) vào ghi chú, rồi dùng cho phần đầu tiên.
- Kiểm tra dự án đã dùng git chưa. Nếu rồi, hãy commit sau phần đầu tiên và xem lịch sử commit để thấy mốc của mình.
Câu hỏi thường gặp
Vì sao phiên làm việc dài lại làm Claude Code kém đi?
Mỗi câu bạn gõ, mỗi file nó đọc và mỗi lần sửa đều chiếm chỗ trong ngữ cảnh của phiên. Khi ngữ cảnh đầy, chất lượng kết quả có thể giảm, ví dụ quên ràng buộc ban đầu hay sửa lại phần đã chốt. Mình không nói được chính xác lúc nào thì giảm vì tuỳ việc và cách làm của bạn.
Một phần việc nhỏ đến mức nào thì đủ?
Mẹo của mình là phần đủ nhỏ để bạn xem hết thay đổi trong một lượt. Nếu xem xong mà vẫn không dám chắc đúng hay sai thì phần đó còn quá to. Không có con số cố định, việc càng lạ hay nhạy cảm thì nên cắt nhỏ hơn.
Mỗi phần xong có bắt buộc phải commit không?
Không bắt buộc, nhưng rất nên. Commit tạo ra mốc để bạn quay lại khi phần sau làm hỏng, và giúp lịch sử thay đổi rõ ràng. Hãy chỉ commit sau khi đã xem lại thay đổi của phần đó.
Tại sao phải nói cả phần chưa làm trong câu giao việc?
Vì nếu chỉ nói điều cần làm, Claude Code có thể làm luôn việc liên quan mà bạn chưa muốn giao, khiến thay đổi lan rộng và khó xem. Một câu như "chưa sửa xuất Excel" giúp giữ ranh giới rõ ràng.
Chia nhỏ có làm tốn lượt dùng hơn không?
Có thể, vì mỗi lượt giao việc thường khiến nó đọc lại một phần file và ngữ cảnh. Bù lại, bạn ít phải sửa đi sửa lại những thay đổi lẫn lộn. Mức tốn cụ thể phụ thuộc gói bạn dùng và việc bạn làm nên mình không khẳng định được.
Sau khi commit một phần, tôi có nên mở phiên mới không?
Nên cân nhắc nếu phiên đã dài hoặc có nhiều lần sửa qua lại. Mở phiên mới thì Claude Code không còn nhớ chuyện cũ, nên quy ước quan trọng hãy để trong file CLAUDE.md của dự án. Nếu phiên còn nhẹ và phần tiếp theo liên quan chặt thì có thể tiếp tục.
Dự án chưa dùng git thì làm sao?
Hãy khởi tạo git cho thư mục dự án và commit trạng thái hiện tại trước khi giao phần đầu tiên. Có mốc xuất phát này, bạn mới quay lại được nếu Claude Code sửa sai. Nhớ không đưa file chứa mật khẩu hay dữ liệu khách hàng thật vào commit.


