Cải thiện quy trình lập trình bằng công cụ AI

Cài Claude Code cho cả đội chưa phải là cải thiện quy trình. Nếu mỗi người vẫn gõ lại quy ước dự án đầu mỗi phiên, vẫn phải rời trình soạn code để hỏi một con bot, hay bỏ qua review vì "AI viết rồi", thì công cụ chỉ thêm việc hoặc thêm rủi ro.

Bài này giúp bạn trả lời: dùng Claude Code và các công cụ AI thế nào để quy trình lập trình của đội nhanh hơn mà vẫn chắc chắn?

Ví dụ xuyên suốt: phần mềm quản lý xưởng nội thất

Một công ty nội thất xuất khẩu có đội 15 lập trình viên làm phần mềm quản lý xưởng: đơn hàng, tồn kho gỗ, lịch máy. Trưởng nhóm muốn dùng Claude Code để sửa lỗi, viết tính năng, sinh tài liệu API và hỗ trợ review pull request. Phần mềm chạy trên một cơ sở dữ liệu production mà kế toán và xưởng dùng hằng ngày.

Đặt AI vào đúng chỗ trong quy trình

Trước khi chạy thử, vẽ quy trình hiện tại và đánh dấu từng bước: AI giúp được gì, bước nào người phải giữ quyền quyết định. Song song là chuẩn bị hạ tầng: MCP server, luật quyền, subagent và CLAUDE.md ở project scope (bài 7.1).

Hai nguyên tắc nữa đề hay hỏi:

• Đưa AI tới chỗ người ta đang làm việc. Claude Code chạy ngay trong terminal hay trình soạn code thì lập trình viên không phải chuyển qua lại giữa các công cụ. Một con bot riêng trong ứng dụng chat buộc họ rời chỗ làm việc, thêm ma sát.
• Không bỏ review vì code do AI viết. Khung AI Fluency của Anthropic gọi năng lực chịu trách nhiệm cho thứ mình làm ra và đưa vào dùng là Diligence. Review là cơ chế kiểm duy nhất cho đầu ra của AI trong quy trình; bỏ đi là mất nó. Số dòng thay đổi cũng không đo được rủi ro: năm dòng sửa phần tính giá thành có thể nguy hiểm hơn hai trăm dòng sửa chữ trên giao diện.

Một phiên làm việc tốt: khám phá, lập kế hoạch, làm, kiểm

Docs Claude Code khuyên với việc không nhỏ thì đi theo thứ tự: khám phá (đọc code liên quan, chưa sửa gì), lập kế hoạch, làm, rồi commit. Chế độ lập kế hoạch (plan mode) cho Claude đọc và đề xuất mà không sửa file; bạn duyệt kế hoạch rồi mới cho làm. Phím Shift+Tab chuyển vòng giữa chế độ mặc định, accept edits và plan (cộng auto nếu tài khoản có):

Trong phiên, ba thói quen giúp Claude làm đúng ngay:

• Đưa đúng ngữ cảnh: trỏ thẳng tới file bằng @, dán ảnh chụp lỗi, hoặc đưa log qua pipe thay vì mô tả lại.
• Cho Claude cách tự kiểm: docs nhấn mạnh hãy đưa Claude một thứ chạy được và trả về đạt hay không đạt (test, lệnh build, script so kết quả), và đòi bằng chứng là lệnh đã chạy cùng kết quả.
• Đổi hướng sớm: Esc để dừng, /rewind để quay về điểm trước khi sửa. Docs khuyên nếu đã sửa hướng hai lần mà vẫn sai thì /clear và viết lại prompt tốt hơn, thay vì kéo dài phiên. Việc tìm rộng trong codebase thì giao cho subagent Explore (chỉ đọc), để kết quả tìm không làm đầy ngữ cảnh chính.

Trong ví dụ, lỗi "tồn kho gỗ bị âm sau khi huỷ đơn" được xử lý thế này: plan mode để Claude đọc luồng huỷ đơn và đề xuất nguyên nhân; trưởng nhóm duyệt; Claude viết test tái hiện lỗi trước, chạy để thấy test đỏ, sửa, chạy lại để thấy xanh, rồi mới commit.

Biến việc lặp lại thành công cụ của đội

Khi cùng một việc lặp lại ở nhiều phiên và nhiều người, đóng gói nó một lần:

Subagent riêng chỉ đáng làm khi việc đó lặp lại qua nhiều phiên và cần một prompt tập trung, quyền tool hẹp, một model cụ thể. Docs Claude Code nói mỗi subagent chạy trong ngữ cảnh riêng, với system prompt, quyền tool riêng. File đặt ở .claude/agents/ và commit để cả đội dùng:

---
name: review-migration
description: Review migration cơ sở dữ liệu. Dùng khi có thay đổi trong db/migrations.
tools: Read, Grep, Glob
model: sonnet
---
Kiểm migration có khoá bảng lớn lâu không, có đường quay lại không,
có làm mất dữ liệu tồn kho không. Chỉ báo vấn đề, không sửa file.

Hook khác CLAUDE.md ở chỗ nó chắc chắn chạy. Docs mô tả hook là lệnh shell Claude Code chạy ở những thời điểm cố định, để một việc luôn xảy ra thay vì trông vào việc model chọn làm. Ví dụ chạy Prettier sau mỗi lần Claude sửa file, đặt trong .claude/settings.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }]
      }
    ]
  }
}

Hook chạy trước khi tool chạy (PreToolUse) thì chặn được hành động: script thoát với mã 2 là Claude Code chặn lệnh đó.

Đưa Claude Code vào pull request và CI

Claude Code GitHub Actions chạy Claude Code trong workflow của repo. Có hai cách dùng: nhắc @claude trong issue hay bình luận pull request để Claude làm theo yêu cầu, hoặc đưa sẵn một prompt để chạy tự động theo sự kiện, như mỗi khi có pull request mới. Lệnh /install-github-app trong Claude Code cài sẵn phần lớn các bước. Docs khuyên cấp cho workflow đúng những quyền nó cần, giới hạn số lượt bằng --max-turns, và review thay đổi của Claude trước khi merge.

Trong ví dụ, workflow review đăng nhận xét lên từng pull request; luật bảo vệ nhánh hiện có vẫn yêu cầu một người approve. Ngoài GitHub, script có thể gọi claude -p (chế độ không tương tác) để Claude làm một việc rồi in kết quả.

Sinh tài liệu cũng theo tinh thần đó. Câu luyện thi về tài liệu bám sát code chấm đúng cách: subagent đọc file code liên quan bằng tool đọc file và tìm code, viết tài liệu, rồi đẩy thay đổi qua quy trình review bình thường của đội. Sai là viết từ trí nhớ của model mà không đọc code, hay đăng thẳng lên trang công khai không qua duyệt.

Khi Claude Code chạm hệ thống thật

Docs Claude Code nói Claude tạo điểm lưu (checkpoint) trước khi sửa file, nên sửa sai trong repo thì quay lại được. Nhưng hành động trên hệ thống bên ngoài, như ghi vào cơ sở dữ liệu, gửi tin hay deploy, thì checkpoint không lấy lại được. Vì vậy với cơ sở dữ liệu production, dùng nhiều lớp:

1. MCP server cơ sở dữ liệu dùng tài khoản chỉ đọc theo mặc định.
2. Subagent làm việc với dữ liệu chỉ có tool đọc.
3. Mọi thao tác sửa dữ liệu phải có người xác nhận rõ ràng.