Những lỗi thường gặp khi sử dụng AI Coding trong Antigravity và cách khắc phục

1. Thực trạng khi lập trình viên bắt đầu với AI Coding trong Antigravity

Google Antigravity đang tạo nên một làn sóng mạnh mẽ trong cộng đồng lập trình viên nhờ khả năng tự hành (agentic workflow) độc đáo: từ đọc tệp tin, tự viết mã, chạy lệnh terminal cho đến gỡ lỗi tự động. Tuy nhiên, vì Antigravity sở hữu quyền can thiệp trực tiếp vào môi trường máy tính thay vì chỉ phản hồi văn bản trong khung chat như các công cụ AI thế hệ cũ, việc sử dụng không đúng cách có thể dẫn đến những tình huống "dở khóc dở cười": code bị sửa lan man, xung đột thư viện hoặc gãy luồng xử lý của toàn bộ dự án.

Để giúp bạn làm chủ trợ lý AI đắc lực này một cách an toàn và năng suất nhất, iTee Pro đã tổng hợp những sai lầm phổ biến nhất khi sử dụng AI Coding trong Antigravity cùng giải pháp khắc phục chi tiết đã được kiểm chứng thực tế.

2. 7 lỗi thường gặp nhất và giải pháp khắc phục triệt để

2.1. Lỗi 1: Đưa ra yêu cầu quá khổng lồ trong một câu lệnh duy nhất (Mega-Prompting)

Hiện tượng: Bạn nhập một câu lệnh bao quát như: "Hãy viết cho tôi một sàn thương mại điện tử hoàn chỉnh có giỏ hàng, thanh toán qua cổng VNPay, quản trị đơn hàng và phân quyền tài khoản". Kết quả là agent cố gắng chỉnh sửa và tạo mới hàng chục tệp tin cùng lúc, dẫn đến hiện tượng cạn kiệt context, code bị bỏ dở giữa chừng (placeholder, TODO) và xuất hiện hàng loạt lỗi cú pháp không tương thích.

Cách khắc phục:

• Áp dụng nguyên tắc phân rã nhiệm vụ: Chia tính năng lớn thành các giai đoạn nhỏ (Milestones). Ví dụ: Thiết kế Database Schema & Migration > Viết API xác thực người dùng > Xây dựng API giỏ hàng > Tích hợp cổng thanh toán > Thiết kế giao diện Frontend.
• Luôn gõ lệnh /plan trước khi bắt đầu bài toán phức tạp để Antigravity lên khung kế hoạch từng bước, sau đó duyệt từng phần một cách có kiểm soát.

2.2. Lỗi 2: Thiếu ngữ cảnh kỹ thuật cụ thể (Context Deficiency)

Hiện tượng: Yêu cầu của bạn quá mơ hồ, ví dụ: "Nút bấm đăng nhập bị hỏng rồi, sửa giúp tôi" hoặc "Tối ưu lại truy vấn database trang chủ". Điều này buộc AI phải tự đoán mò, quét ngẫu nhiên toàn bộ thư mục dự án làm tiêu tốn thời gian và rất dễ sửa nhầm tệp tin không liên quan.

Cách khắc phục:

• Chỉ định chính xác đường dẫn tệp tin và vị trí hàm cần thao tác: ví dụ src/components/Auth/LoginButton.tsx hoặc backend/services/user.service.ts.
• Nêu rõ phiên bản công nghệ và thư viện đang dùng (ví dụ: React 19, Next.js App Router, Prisma ORM).
• Cung cấp chính xác mã lỗi, stack trace từ terminal hoặc log của trình duyệt thay vì chỉ mô tả cảm tính.

2.3. Lỗi 3: Quên yêu cầu Agent tự kiểm thử và xác minh (No Verification Step)

Hiện tượng: Sau khi Antigravity viết code xong, bạn lập tức đóng phiên làm việc mà không kiểm tra lại. Đến khi chạy dự án thực tế thì gặp lỗi biên dịch TypeScript, thiếu module import hoặc màn hình trắng xóa.

Cách khắc phục:

• Tận dụng quyền chạy lệnh terminal của Antigravity bằng cách thêm yêu cầu nghiệm thu ở cuối mọi câu prompt: "Sau khi sửa đổi xong, hãy chạy npm run build (hoặc npm test, pytest) để đảm bảo toàn bộ mã nguồn không còn lỗi cú pháp và các test cases đều vượt qua".
• Nếu có lỗi phát sinh trong terminal, Antigravity sẽ tự động kích hoạt vòng lặp tự sửa lỗi (Self-Healing Loop) cho đến khi dự án hoạt động ổn định.

2.4. Lỗi 4: Tin tưởng tuyệt đối mà bỏ qua bước duyệt diff code (Blind Trust)

Hiện tượng: Chấp nhận mọi thay đổi của AI một cách tự động (Auto-Accept) mà không đọc lại mã nguồn được sinh ra. AI có thể vô tình xóa mất các đoạn logic kiểm tra bảo mật cũ hoặc thay đổi interface của các hàm dùng chung.

Cách khắc phục:

• Luôn xem xét kỹ bảng so sánh thay đổi (Diff Inspection) trước khi chấp nhận ghi đè file.
• Kiểm tra xem AI có tuân thủ các quy tắc bảo mật cơ bản như: lọc dữ liệu đầu vào (input validation), ngăn ngừa SQL Injection và không lưu thông tin nhạy cảm vào mã nguồn hay không.

2.5. Lỗi 5: Làm việc trực tiếp trên nhánh Main/Production mà không tách Git Branch

Hiện tượng: Để Antigravity thực hiện các tác vụ tái cấu trúc lớn (Refactor) trực tiếp trên nhánh chính của dự án. Khi kết quả không như ý muốn, việc khôi phục lại trạng thái ban đầu trở nên vô cùng hỗn loạn và rủi ro.

Cách khắc phục:

• Hình thành thói quen tạo một Git branch mới trước khi giao việc lớn cho AI: git checkout -b feature/ai-refactor-auth.
• Sau khi kiểm tra toàn bộ tính năng hoạt động hoàn hảo, bạn mới tiến hành merge vào nhánh chính. Nếu có sự cố, bạn chỉ cần xóa nhánh tạm mà không lo mất mã nguồn quan trọng.

2.6. Lỗi 6: Bỏ quên sức mạnh của hệ thống Slash Commands và Subagents

Hiện tượng: Coi Antigravity như một chatbot thông thường và chỉ gõ văn bản thuần, bỏ qua hoàn toàn hệ sinh thái lệnh gạch chéo đặc quyền của nền tảng.

Cách khắc phục: Lựa chọn đúng lệnh cho từng ngữ cảnh:

• /plan: Lập kế hoạch phân tích kiến trúc trước khi can thiệp vào code.
• /grill-me: Kích hoạt chế độ phỏng vấn phản biện để AI làm rõ các yêu cầu mơ hồ trước khi lập trình.
• /boost: Bật tư duy tính toán chuyên sâu cho các thuật toán khó hoặc bài toán tối ưu hiệu năng cao.
• /goal: Bật chế độ tự hành chạy ngầm cho các tác vụ dài hạn (chạy test toàn hệ thống, dọn dẹp linting qua đêm).

2.7. Lỗi 7: Không thiết lập Rules và Custom Skills dẫn đến prompt lặp lại liên tục

Hiện tượng: Trong mỗi lần mở phiên làm việc mới, bạn lại phải copy dán lại những câu quen thuộc: "Hãy dùng Tailwind CSS, viết bằng TypeScript, tuân thủ Clean Architecture, không dùng any...". Điều này vừa mất thời gian vừa tiêu tốn bộ nhớ ngữ cảnh.

Cách khắc phục:

• Định nghĩa toàn bộ quy chuẩn của dự án vào thư mục .gemini/rules hoặc đóng gói thành Custom Skill (SKILL.md).
• Antigravity sẽ tự động nạp các quy tắc này vào mọi phiên làm việc ngầm định. Code sinh ra luôn nhất quán 100% với phong cách lập trình của bạn mà không cần nhắc lại.

3. Bảng đối chiếu: Sai lầm phổ biến và Cách xử lý chuẩn xác

Bảng tóm tắt nhanh dưới đây sẽ là cẩm nang bỏ túi giúp bạn đối soát trước mỗi lần giao việc cho AI:

Hành vi sai lầm	Hậu quả xảy ra	Cách xử lý chuẩn xác
Yêu cầu làm cả hệ thống lớn cùng lúc	Code đứt đoạn, sinh lỗi logic, quá tải context	Chia nhỏ thành từng milestone, dùng /plan
Mô tả lỗi chung chung ("hỏng rồi")	AI đoán mò, sửa nhầm file khác	Cung cấp đường dẫn file, dòng mã và stack trace chi tiết
Không yêu cầu test sau khi code	Dự án build lỗi, vỡ giao diện thực tế	Thêm tiêu chí: "Chạy npm test / build để xác minh"
Code trực tiếp trên nhánh chính (main)	Khó hoàn tác khi AI sửa sai nhiều file	Luôn tạo git branch mới trước khi để AI tự hành
Lặp đi lặp lại quy tắc trong từng prompt	Mất thời gian, tốn dung lượng context	Đóng gói quy chuẩn vào .gemini/rules hoặc Custom Skills
Bỏ qua các lệnh Slash Command	Chỉ khai thác được 30% sức mạnh của Antigravity	Tận dụng /plan, /grill-me, /boost, /goal

4. Lời khuyên vàng để cộng tác hoàn hảo với Antigravity

Để đạt được hiệu quả cao nhất khi làm việc với AI Coding trong Antigravity, bạn hãy nhớ rằng: Bạn là Kiến trúc sư trưởng (Architect), còn Antigravity là một nhóm kỹ sư thi công siêu tốc (Executors). Một người chỉ huy giỏi không bao giờ đưa ra những mệnh lệnh mù mờ; họ đưa ra bản vẽ rõ ràng, thiết lập hàng rào kỹ thuật vững chắc và kiểm tra nghiệm thu nghiêm ngặt trước khi đưa công trình vào vận hành.

5. Lời kết

Hiểu rõ và phòng tránh những lỗi thường gặp khi sử dụng AI Coding trong Antigravity sẽ giúp bạn tiết kiệm hàng chục giờ sửa lỗi vô ích, bảo vệ an toàn cho mã nguồn dự án và tối đa hóa năng suất lập trình lên gấp nhiều lần. Khi được dẫn dắt bởi tư duy đúng đắn, Google Antigravity chắc chắn sẽ trở thành vũ khí công nghệ lợi hại nhất trên hành trình chinh phục những đỉnh cao phần mềm của bạn.

Hãy thường xuyên theo dõi các bài viết hướng dẫn chuyên sâu về AI Agent và lập trình tự động trên iTee Pro để nâng cấp kỹ năng công nghệ mỗi ngày!