0

Giao việc cho AI agent: lên kế hoạch trước, code sau

Lần đầu dùng AI agent, mình gõ đúng một câu: "thêm chức năng lọc đơn hàng theo trạng thái". Mười phút sau nó báo xong. Mở diff ra thì thấy nó sửa 14 file: thêm bộ lọc, đổi tên vài hàm "cho rõ nghĩa hơn", định dạng lại một file không liên quan, và viết luôn một lớp tiện ích mới mà project đã có sẵn một cái tương tự. Tính năng chạy được. Nhưng review xong chỗ diff đó mất gần gấp đôi thời gian tự viết.

Đọc xong bài này, bạn sẽ có một quy trình 5 bước để giao việc cho AI agent mà không phải dọn hậu quả, kèm mẫu "phiếu giao việc" copy dùng được ngay.

AI agent khác chat ở đâu

Chat với AI thì bạn hỏi, nó trả lời, bạn tự copy code về. Còn AI agent (Claude Code, Cursor Agent, Copilot Agent, Codex...) thì tự làm: tự mở file, tự sửa code, tự chạy lệnh build, test, đọc kết quả rồi sửa tiếp.

Cách dễ hình dung nhất: chat giống hỏi ý kiến một đồng nghiệp qua tin nhắn. Agent giống đưa hẳn bàn phím cho một bạn thực tập rất nhanh tay, rất chăm, nhưng chưa biết quy ước của team và có xu hướng làm nhiều hơn được giao.

Bạn sẽ không giao cho bạn thực tập đó một câu rồi bỏ đi uống cà phê. Với agent cũng vậy.

Quy trình 5 bước

 1. Mô tả việc        2. Agent viết plan      3. Mình duyệt plan
 (mục tiêu + giới  →  (sẽ sửa file nào,    →  (cắt bớt, sửa hướng,
  hạn + tiêu chí)      làm theo thứ tự nào)     rồi mới cho làm)
                                                     │
 5. Mình review diff  ←  4. Agent làm + tự kiểm  ←───┘
 (đọc code, chạy thử)    (build, test, báo kết quả)

Thứ thay đổi lớn nhất so với lần đầu của mình là bước 2 và 3: bắt agent viết kế hoạch trước, duyệt xong mới cho động vào code. Đọc một kế hoạch 15 dòng mất 1 phút. Đọc một diff 14 file mất 30 phút. Sửa hướng ở bước plan rẻ hơn sửa hướng ở bước diff rất nhiều.

Bước 1: mô tả việc như viết một ticket tốt

So hai cách giao:

Giao một câu Giao có phiếu
"Thêm chức năng lọc đơn hàng theo trạng thái" Mục tiêu: trang danh sách đơn có dropdown lọc theo trạng thái (Chờ xử lý, Đang giao, Đã giao, Đã huỷ)
Phạm vi: chỉ sửa trang danh sách đơn và API lấy danh sách đơn
Không được: đổi tên hàm cũ, format lại file không liên quan, thêm thư viện mới
Dùng lại: hàm buildQueryFilter đã có trong utils/query.ts
Xong khi: lọc đúng, test cũ vẫn xanh, có thêm test cho bộ lọc

Hai dòng "Không được" và "Dùng lại" là hai dòng chặn đúng hai thứ đã làm hỏng lần đầu của mình: sửa lan man và viết lại thứ đã có.

Bước 2 và 3: plan trước, duyệt rồi mới làm

Câu mình hay thêm vào cuối:

Chưa sửa code vội. Hãy đọc code liên quan rồi viết kế hoạch:
- Sẽ sửa những file nào, mỗi file sửa gì (1 dòng/file)
- Thứ tự làm
- Rủi ro hoặc chỗ chưa chắc
Đợi mình duyệt kế hoạch rồi mới làm.

Khi đọc plan, mình hỏi ba câu: có file nào nằm ngoài phạm vi không, có chỗ nào đang viết lại thứ đã có không, và có bước nào mình không hiểu không. Có thì sửa ngay trong plan. Nhiều agent có hẳn chế độ chỉ lập kế hoạch (Claude Code có plan mode), dùng được thì càng tốt.

Viết luật một lần cho cả project

Có những điều lần nào giao việc cũng phải nhắc: lệnh build, lệnh chạy test, thư mục không được đụng, quy ước đặt tên. Thay vì nhắc mãi, mình viết chúng vào một file đặt ở gốc project. Claude Code đọc file CLAUDE.md, nhiều công cụ khác đọc AGENTS.md. Agent sẽ tự đọc file này mỗi lần bắt đầu làm việc.

Một file đơn giản là đủ:

# Hướng dẫn cho AI agent

## Lệnh
- Build: `npm run build`
- Test: `npm test` (phải xanh trước khi báo xong)

## Quy ước
- Không thêm thư viện mới nếu chưa hỏi
- Không đổi tên hàm, file đang có trừ khi được yêu cầu
- Hàm tiện ích dùng chung nằm trong `src/utils/`, tìm ở đó trước khi viết mới

## Không được đụng
- `src/legacy/` (đang chờ xoá, không sửa)
- File `.env*`

File này giống tài liệu onboarding cho người mới, chỉ khác là người đọc là AI. Mỗi khi agent làm sai một điều mà lẽ ra quy ước phải nói, mình thêm một dòng vào file.

Thứ tự làm việc cũng là một quyết định

Ví dụ: giao cho agent việc thêm cột số điện thoại bắt buộc (NOT NULL) vào bảng khách hàng đang có dữ liệu. Cách làm thẳng là một migration thêm cột NOT NULL rồi deploy. Trên production, migration đó sẽ lỗi vì các dòng cũ chưa có giá trị, hoặc bản code cũ còn đang chạy sẽ insert thiếu cột.

Plan của agent chia làm bốn bước: thêm cột cho phép NULL → deploy code mới có ghi số điện thoại → chạy script điền dữ liệu cho các dòng cũ → migration đổi cột sang NOT NULL. Mình chỉ duyệt và thêm một ý: script điền dữ liệu chạy theo lô nhỏ để không khoá bảng lâu. Đây là kiểu giá trị mà bước plan mang lại: nhiều khi agent thấy một cách làm gọn hơn, nhưng chỉ khi nó được yêu cầu nghĩ trước khi làm.

Phiếu giao việc dùng ngay

Mục tiêu: [việc cần làm, người dùng sẽ thấy gì]
Phạm vi: [được sửa những phần nào]
Không được: [những thứ không được đụng hoặc không được làm]
Dùng lại: [hàm, component, pattern đã có nên dùng]
Xong khi: [tiêu chí: test nào phải xanh, chạy thử thấy gì]

Chưa sửa code vội: đọc code liên quan, viết kế hoạch (file nào, sửa gì, thứ tự,
rủi ro), đợi mình duyệt rồi mới làm.

Thử ngay: việc tiếp theo bạn định giao cho AI agent, điền phiếu ở trên và bắt nó viết plan trước. Để ý xem plan đầu tiên có chỗ nào bạn muốn cắt không. Gần như lần nào cũng có.

Bài sau trong series nói về bước 5: review kết quả AI làm, và vì sao AI sai theo những kiểu rất khác người. Bạn đang giao việc cho agent theo cách nào? Comment chia sẻ với mọi người nhé.

P.S. Bước "viết plan trước" mình dùng nhiều tới mức có hẳn một skill cho nó: plan trong PrimeKit, bộ skill mình tự làm. Skill bắt agent lập kế hoạch có phạm vi rõ, thứ tự phụ thuộc, tiêu chí nghiệm thu và cách kiểm tra cho từng bước. Cài bằng npx @lovehlmmm/primekit init, rồi gõ /pk:plan kèm mô tả việc. Plan đẹp tới đâu thì vẫn cần bạn đọc và duyệt, đó là phần không giao cho AI được.


Series khác của mình


All rights reserved

Viblo
Hãy đăng ký một tài khoản Viblo để nhận được nhiều bài viết thú vị hơn.
Đăng kí