Bỏ qua để đến nội dung chính
LeoNex News

Context engineering và guardrails để "thuần hoá" coding agent

Dây chuyền ba bước đưa đặc tả và ngữ cảnh qua các cổng kiểm tra trước khi xuất mã đã xác minh.
Trong bài này

Coding Agent như Cursor, Windsurf, Cline hay Claude Code thường cho kết quả ấn tượng ở giai đoạn đầu, nhưng khi dự án lớn dần với nhiều file và nghiệp vụ rẽ nhánh, chúng có thể làm hỏng tính năng đang chạy, kéo thêm thư viện xung đột hoặc phá vỡ kiến trúc. Nguyên nhân nằm ở cách dùng thiếu cấu trúc, gọi là Unstructured Vibe Coding. Hướng khắc phục là kết hợp Spec-Driven Agentic Coding, Context Engineering và Automated Guardrails, tức quy trình đặc tả trước, cấp ngữ cảnh ổn định cho Agent và đặt các hàng rào kiểm soát tự động.

Vì sao Coding Agent làm hỏng codebase

Agent hiện đại không kém thông minh, nhưng chúng vận hành bằng cách dự đoán xác suất trong một Context Window, tức cửa sổ ngữ cảnh có dung lượng hữu hạn. Khi người dùng giao tiếp thiếu cấu trúc, Agent rơi vào ba điểm mù.

  • Lost in the Middle: hội thoại kéo dài qua nhiều lượt sửa lỗi khiến Agent dần quên các quy chuẩn kiến trúc đã nhắc ở đầu phiên.

  • Architectural Blindness: nếu ranh giới giữa các tầng không được chỉ rõ, Agent có xu hướng đặt truy vấn Database ngay trong Controller hoặc Component giao diện để tính năng chạy nhanh nhất.

  • Dependency Hallucination: thay vì dùng lại các hàm tiện ích đã có trong dự án, Agent tự viết hàm mới hoặc cài thêm thư viện bên ngoài.

Context Engineering: bộ quy tắc ngữ cảnh cho dự án

Trước khi nhờ AI viết bất kỳ dòng code nào, kỹ sư nên thiết lập Static Context Rules, tức bộ quy tắc ngữ cảnh cố định, qua các tệp cấu hình ở thư mục gốc như .cursorrules, .windsurfrules hoặc CLAUDE.md. Tệp này hoạt động như một System Prompt bất biến, buộc Agent đọc và tuân thủ quy ước của dự án ở mỗi lượt sinh mã.

Một tệp .cursorrules cho dự án Full-stack gồm Next.js, TypeScript, Prisma và Tailwind có thể chia thành bốn phần: công nghệ và thư viện cốt lõi, ranh giới thư mục và kiến trúc, quy ước viết code cùng xử lý lỗi, và giao thức thực thi kèm kiểm chứng.

  • Phần công nghệ nêu rõ Zod dùng để kiểm tra mọi dữ liệu đầu vào API và Form, còn Prisma ORM làm việc với PostgreSQL.

  • Phần kiến trúc quy định thư mục src/app/ chỉ chứa routing, layout và page mỏng; business logic nằm trong src/services/; các Zod schema dùng chung nằm ở src/lib/validations/.

  • Phần quy ước cấm dùng any và yêu cầu mọi Server Action cùng API Route được bọc trong try/catch, trả về định dạng thống nhất.

  • Phần thực thi cấm tự ý cài gói npm mới khi chưa được xác nhận, đồng thời yêu cầu chạy npm run typecheck và npm run lint sau mỗi lần chỉnh sửa.

plaintext
- KHÔNG tự ý cài đặt thêm gói npm mới nếu chưa hỏi ý kiến và được xác nhận.
- Sau khi hoàn thành chỉnh sửa code, luôn chạy `npm run typecheck` và `npm run lint` để đảm bảo không phát sinh lỗi biên dịch.

Quy trình ba pha: Spec, Plan, Execute

Để Agent không làm việc vượt quá yêu cầu, quy trình tách bạch giữa tư duy thiết kế và việc sinh mã thành ba pha.

  1. Đặc tả yêu cầu: thay vì bắt Agent code ngay, chuyển sang Ask hoặc Architect Mode và cùng AI viết tệp docs/feature-spec.md, trong đó mô tả luồng dữ liệu từ UI qua API tới Database, liệt kê Edge Cases cùng trạng thái lỗi, và nêu thay đổi Schema nếu có.

  2. Lập kế hoạch tác động: khi đặc tả đã chuẩn, yêu cầu Agent liệt kê chính xác các tệp cần tạo mới hoặc sửa, giải thích ngắn thay đổi ở từng tệp, và chưa viết code cho đến khi kế hoạch được duyệt. Danh sách này giúp phát hiện sớm việc Agent định sửa nhầm module lõi nhạy cảm.

  3. Thực thi và tự kiểm thử: sau khi duyệt, Agent bắt đầu viết mã và tận dụng Feedback Loop từ Terminal để tự sửa lỗi. Agent viết Unit Test hoặc Integration Test song song với tính năng, tự chạy npm test hoặc pytest, đọc Stack Trace khi test Fail và sửa cho đến khi toàn bộ Pass.

Quản trị Context Window và các Guardrails

Dù quy trình tốt, dự án vẫn gặp rủi ro nếu bỏ qua các cơ chế kiểm soát. Trước hết là vệ sinh ngữ cảnh, gồm hai nguyên tắc.

  • Một tính năng, một phiên chat: không dùng chung một cửa sổ chat kéo dài cho nhiều tính năng. Sau khi hoàn thành module và git commit, nên mở phiên mới để làm sạch bộ nhớ đệm của Agent.

  • Gắn thẻ ngữ cảnh chủ động: dùng cú pháp @file hoặc @folder để chỉ định đúng các tệp liên quan, thay vì để Agent tự quét toàn bộ dự án và gây nhiễu.

Vai trò của kỹ sư phần mềm thay đổi

Điểm chính

Nguồn tham khảo

Các nguồn mà bài viết này dựa vào.

  1. Context Engineering & Guardrails trong Vibe Coding - Kỹ thuật thuần hóa Coding Agents để không sinh ra "rác" trên dự án Production (mở trong tab mới) — Viblo

Xem thêm trong AI Engineering

Sơ đồ vòng xử lý: đánh giá được lấy mẫu, LLM tạo bản tóm tắt, hệ thống kiểm tra căn cứ và phản hồi người dùng quay lại để cập nhật.
AI-ENG AI Engineering

Tóm tắt review tự động có vòng phản hồi: LLM chạy production tại Grab

Hệ thống Automated Merchant Review Summary System biến các đánh giá viết tay về cửa hàng thành bản tóm tắt ngắn gọn. Người tiêu dùng có thể xem tóm tắt tổng thể hoặc chọn một chủ đề cụ thể, còn merchant (cửa hàng, đối tác bán hàng) nhận biết được điều khách hàng đánh giá cao và khâu nào cần cải…

6 phút đọc

Sơ đồ bắt đầu với một agent, rẽ sang nhiều agent qua điểm quyết định, kèm ghi chú chuyển giao và biểu đồ so sánh.
AI-ENG AI Engineering

Multi-agent: khi nào nên tách agent, khi nào không

Trong các hệ thống AI agent, việc chia nhỏ thành nhiều agent nghe có vẻ hiện đại, nhưng thực tế thường kéo theo khó khăn khi kiểm thử, gỡ lỗi và làm tăng chi phí. Nguyên tắc xuyên suốt: bắt đầu bằng một agent, chỉ tách khi có lý do cụ thể, và luôn đo đạc để xác nhận quyết định đó. Những nguyên tắc…

2 phút đọc

Bản tin qua email

Nhận tuyển chọn bài viết mới của LeoNex News qua email.

Chúng tôi chỉ dùng địa chỉ này để gửi bản tin.

Nhận tuyển chọn bài viết mới của LeoNex News qua email. Bạn sẽ nhận một email xác nhận; đăng ký chỉ có hiệu lực sau khi bạn xác nhận. Mỗi email đều có liên kết hủy đăng ký. Xem chính sách quyền riêng tư