Skip to Content

Check và sửa lỗi

Khoảng 5 phút. Làm xong, bạn đọc được kết quả check, biết lỗi nào chặn deploy và lúc nào cần nhắc agent sửa.

check kiểm lỗi project qua bốn lớp ngay khi agent ghi file. Lỗi chặn deploy, cảnh báo thì không, và mỗi dòng nói rõ file, dòng và cách sửa.

Agent viết code nhanh nhưng hay lặp vài kiểu sai: dùng prop antd đã bỏ, gọi API không có, import thư viện ngoài stack. Mỗi luật của check ứng với một kiểu lỗi từng làm app hỏng khi chạy, nên agent biết sai ở đâu trước khi người dùng của app gặp.

Bốn lớp

check chạy lớp rẻ trước:

  1. Cú pháp: phân tích mọi file .ts / .tsx.
  2. Luật cấm: mẫu code làm app hỏng hoặc ra ngoài stack, kèm cảnh báo chất lượng.
  3. Hợp đồng: cây route, trang gọi đúng API có thật, ranh giới .ts / .tsx, schema của handler.
  4. Kiểm kiểu: TypeScript đầy đủ trên code của app, khoảng 5–15 giây.

Khi nào check chạy

  • Mỗi lần agent ghi file: ba lớp đầu chạy ngay, kết quả trả về trong cùng lần gọi. Agent sửa ở lần ghi sau.
  • Khi agent gọi check: ba lớp đầu; thêm typecheck: true để chạy cả kiểm kiểu. Agent nên chạy một lần cuối mỗi giai đoạn.
  • Khi deploy: chạy đủ bốn lớp và từ chối khi còn lỗi. App đang chạy giữ nguyên.

Đọc một kết quả

✗ 2 error(s) Errors: - [gate:code.antd-v6-no-visible-prop] app/orders/page.tsx:42 <Modal visible={…}> — antd v6 Modal ignores `visible`, so it never opens. Use `open={…}` … - [contract] app/orders/page.tsx FE calls GET /orders/stats but no matching BE route found Warnings: - [gate:perf.order-unindexed] app/orders/repository.ts:18 orders.createdAt is used in orderBy but …

Mỗi dòng có lớp (gate, contract, syntax, types), mã luật nếu có, file, dòng và thông báo. Thông báo viết bằng tiếng Anh vì người đọc chính là agent.

Hai lỗi trên sửa như sau: đổi visible thành open ở dòng 42; thêm handler app/orders/stats/get.ts hoặc bỏ lời gọi. Cảnh báo cuối không chặn deploy, nhưng nên thêm index cho createdAt.

Để agent tự sửa

Thường bạn không phải làm gì: agent đọc kết quả và sửa ngay trong lần gọi sau. Sau mỗi lần ghi file, check hay deploy, manh.run còn trả một dòng Progress (check, layout, deploy, dữ liệu mẫu, checkpoint) và bước nên làm tiếp, để agent không dừng giữa chừng.

Bạn vào cuộc khi agent sửa vòng vòng một lỗi. Khi đó dán nguyên dòng lỗi cho agent và nói rõ ý muốn, ví dụ: “Lỗi contract này nghĩa là trang gọi API chưa có. Viết handler app/orders/stats/get.ts trả tổng đơn theo tháng.”

Cần biết

  • Còn lỗi cú pháp thì phần lớn luật cấm tạm dừng. Sửa lỗi cú pháp trước rồi chạy lại.
  • Lỗi kiểu là loại duy nhất bỏ qua được khi deploy, bằng deploy({ force: true, reason }) khi chắc app vẫn chạy. Lỗi ở ba lớp đầu không bỏ qua được.
  • Một cây file đã từng deploy thành công luôn deploy lại được dù có luật mới, để quay lại bản cũ không bị chặn.

Bước tiếp theo

Cập nhật