Agentic Coding — Phần 3: Vượt qua thách thức và rào cản khi áp dụng

Thách thức là tất yếu

Giống như bất kỳ công nghệ nào, các công cụ agentic coding không thể được triển khai thành công trong chân không. Dưới đây là cách vượt qua các thách thức áp dụng phổ biến nhất và đảm bảo việc triển khai Claude Code mang lại hiệu quả nhanh chóng.

Thách thức 1: Bẫy "Làm mọi thứ" (The "Do Everything" Trap)

Các công cụ agentic rất "nhiệt tình" nhưng không phải lúc nào cũng có đủ ngữ cảnh để hiệu quả. Người dùng mới thường giao những nhiệm vụ khổng lồ, không giới hạn với kết quả kém.

Ví dụ sai:

# SAI - qua rong, khong co rao chan
claude "Build a complete e-commerce system with user auth,
product catalog, shopping cart, checkout, and payment integration"

Giải pháp: Test-Driven Development (TDD)

TDD cung cấp rào chắn và tiêu chí thành công rõ ràng cho công cụ agentic coding của bạn. Quy trình TDD với Claude Code gồm 5 bước (chi tiết ở Phần 5):

1. Bắt đầu với test specifications: Thay vì yêu cầu "xây dựng hệ thống xác thực", hãy yêu cầu Claude Code viết các test toàn diện trước. Các test định nghĩa chính xác thành công trông như thế nào
2. Triển khai từng phần nhỏ: Chia nhỏ yêu cầu thành các khối nhỏ, có thể kiểm tra được
3. Kiểm tra tại mỗi checkpoint: Không cho phép tiến lên bước tiếp cho đến khi bước hiện tại vững chắc
4. Mở rộng dần dần: Sau khi chức năng cốt lõi hoạt động, thêm yêu cầu mới từng bước
5. Refactor và cải thiện: Review và nâng cấp chất lượng code

Ví dụ đúng:

# DUNG - chia nho, co rao chan
claude "Write comprehensive tests for user registration:
- Email format validation
- Password strength requirements (min 8 chars, uppercase, lowercase, digit, special)
- Duplicate email prevention
- Successful registration flow"

# Sau khi co test, moi implement
claude "Implement the registration logic to pass these tests.
Focus on security best practices for password hashing."

# Kiem tra
claude "Run the tests and analyze any failures"

Tận dụng tính chất lặp lại của quy trình command-line: chạy các lệnh tập trung như "write tests for user registration" rồi "implement the registration logic to pass these tests" thay vì một yêu cầu khổng lồ "build everything".

Thách thức 2: Khoảng cách ngữ cảnh (Context Gap)

"Cái này không hoạt động" hay "Nút quá lớn" không cho AI đủ thông tin để làm việc. Những mô tả mơ hồ như vậy dẫn đến lãng phí thời gian lặp lại và các phiên debug bực bội. Hãy nghiêng về phía chia sẻ quá nhiều ngữ cảnh và cung cấp phản hồi rõ ràng, có thể hành động.

Chia sẻ thông tin lỗi đầy đủ

Sai: "Nó bị crash rồi"

Đúng: Cung cấp full error message, stack trace và hành động cụ thể gây ra lỗi. Copy-paste trực tiếp output từ terminal, browser console, hoặc IDE error panel vào phiên Claude Code.

# SAI
claude "The login is broken, fix it"

# DUNG
claude "Debug authentication failure in user dashboard.
Error: Authentication failed at UserController.login (controllers/userController.js:45)
Database connection error: FATAL: password authentication failed for user 'myapp_user'

Environment: Node.js v18.17.1, Express 4.18.2, PostgreSQL 15.3
The issue started after running npm update this morning.
PostgreSQL service is running, database exists with test data."

Mô tả môi trường đầy đủ

Bao gồm hệ điều hành, phiên bản ngôn ngữ, chi tiết framework và các dependencies liên quan. Claude Code cần hiểu stack kỹ thuật của bạn để cung cấp giải pháp chính xác.

Sử dụng visual debugging có chiến lược

Khi xử lý vấn đề UI, chụp màn hình và mô tả chính xác những gì sai:

Sai: "Nút trông kỳ"

Đúng: "Nút đăng nhập tràn ra 20px ngoài container trên màn hình mobile"

Chỉ định chính xác expected vs. actual

claude "Fix this API issue.
Expected: API returns 200 status with user data including email and role.
Actual: Returns 401 with 'invalid token' message.

The token was generated 5 minutes ago and should be valid for 24 hours.
Here's the auth middleware code: [paste code]
Here's the route handler: [paste code]"

Bao gồm file liên quan

Chia sẻ các file code, file cấu hình, hoặc dữ liệu liên quan đến vấn đề. Claude Code không thể debug code mà nó không thấy.

Thách thức 3: Thiếu kỹ năng Prompt Engineering

Thành công với agentic coding đòi hỏi học cách giao tiếp hiệu quả với AI. Nhiều developer nhảy vào với kỳ vọng Claude Code sẽ đọc được suy nghĩ của họ, rồi thất vọng với kết quả chưa đạt. Ngoài ra, giống như bất kỳ AI agent nào, việc cung cấp đúng cấu trúc, nội dung và thứ tự là rất quan trọng để đảm bảo kết quả tối ưu.

Nguyên tắc 1: Đối xử với Claude như một kỹ sư đồng nghiệp

Tự hỏi: nếu đồng nghiệp của bạn có hiểu chính xác những gì bạn yêu cầu không, dựa trên prompt bạn đang đưa cho họ? Nếu không, hãy dự đoán những câu hỏi họ sẽ hỏi và cung cấp trước.

Nguyên tắc 2: Dùng ngôn ngữ kỹ thuật chính xác

Thay thế các thuật ngữ mơ hồ bằng ngôn ngữ kỹ thuật cụ thể:

Sai	Đúng
"Làm cho nó nhanh hơn"	"Tối ưu hóa database query để giảm response time từ 2s xuống dưới 500ms"
"Fix lỗi validation"	"Error handling quá chung chung — thêm validation cụ thể cho email format và password length"
"Thêm cache"	"Implement Redis caching cho product catalog API để giảm số API calls, TTL 5 phút"

Nguyên tắc 3: Cung cấp ví dụ và ràng buộc

Cho Claude Code thấy thành công trông như thế nào với ví dụ cụ thể:

claude "Create a new API endpoint for user profile update.
Follow this existing API pattern:
[paste an example endpoint from your codebase]

Use this coding style:
[paste your style guide or reference code]

Constraints:
- Must include input validation
- Must use our existing auth middleware
- Must follow our error response format: { error: string, code: number }
- Must include rate limiting (10 requests/minute per user)"

Nguyên tắc 4: Chia nhỏ task phức tạp

Thay vì một lệnh lớn, dùng các lệnh tuần tự:

# Thay vi "build a complete e-commerce system"
claude "Create the database schema for products, categories, and inventory"
# Kiem tra ket qua, sau do:
claude "Implement product catalog API with CRUD operations"
# Kiem tra ket qua, sau do:
claude "Add shopping cart functionality with session management"
# Moi lenh co mot muc tieu ro rang, don le

Nguyên tắc 5: Thành thạo feedback loop

Học cách cho phản hồi cụ thể về output của Claude Code:

# SAI - qua chung chung
claude "Fix the validation"

# DUNG - cu the va co huong dan
claude "The error handling is too generic - add specific validation for:
1. Email format using regex pattern
2. Password length (min 8, max 128 characters)
3. Password complexity (uppercase, lowercase, digit, special char)
Return specific error messages for each validation failure."

Nguyên tắc 6: Quản lý ngữ cảnh trong phiên làm việc

Hiểu thông tin nào Claude Code giữ lại trong phiên và thông tin nào cần nhắc lại. Tham chiếu công việc trước một cách rõ ràng:

claude "Using the authentication middleware from earlier,
now add role-based permissions. Support three roles:
- admin: full access to all endpoints
- editor: can create and update content
- viewer: read-only access
Apply the middleware to the user management routes we created."

Thách thức 4: Quá trình cải tiến dần

Bắt đầu với chức năng cơ bản và cải thiện dần:

# Buoc 1: Co ban
claude "Create a simple user login form with email and password fields"

# Buoc 2: Them validation
claude "Add input validation to the login form:
- Email format check
- Password not empty
- Show inline error messages"

# Buoc 3: Tang cuong
claude "Implement password strength requirements:
- Visual strength indicator
- Real-time feedback as user types
- Specific messages for each requirement"

Cách tiếp cận này xây dựng kết quả tốt hơn việc cố chỉ định mọi thứ ngay từ đầu.

Áp dụng cho đội ngũ Việt Nam

Thách thức đặc thù Việt Nam

Ngoài các thách thức phổ biến, các đội ngũ Việt Nam còn gặp thêm:

• Rào cản ngôn ngữ: Prompt tiếng Anh hay tiếng Việt? Thực tế, prompt kỹ thuật bằng tiếng Anh thường cho kết quả tốt hơn vì Claude được train nhiều hơn với dữ liệu kỹ thuật tiếng Anh. Tuy nhiên, comment và documentation cho người dùng cuối có thể yêu cầu bằng tiếng Việt
• Quy ước nội bộ: Nhiều công ty Việt Nam có quy ước code riêng, framework nội bộ, hoặc dependencies đặc thù. Đảm bảo ghi lại trong CLAUDE.md
• Internet và latency: Với các dịch vụ cloud ở nước ngoài, latency có thể ảnh hưởng trải nghiệm. Chia nhỏ task giúp giảm tác động của mất kết nối giữa chừng

Mẫu prompt cho đội ngũ Việt Nam

# Them vao CLAUDE.md
## Language Convention
- Code: English (variables, functions, comments)
- Commit messages: English
- API responses for end users: Vietnamese with full diacritics
- Internal docs: English preferred, Vietnamese acceptable
- CLAUDE.md: English

## Vietnamese-specific
- Phone format: +84xxxxxxxxx (10 digits after +84)
- Currency: VND, no decimal places, dot as thousand separator
- Date format: DD/MM/YYYY
- Address: So nha, Duong, Phuong/Xa, Quan/Huyen, Tinh/TP

Checklist khắc phục khi gặp vấn đề

Khi kết quả từ Claude Code không như mong đợi, chạy qua checklist này:

1. Prompt có đủ ngữ cảnh không? (đồng nghiệp có hiểu được không?)
2. Task có quá lớn không? (có thể chia nhỏ hơn?)
3. Có chỉ định expected output không?
4. Có cung cấp file và code liên quan không?
5. CLAUDE.md có cập nhật với conventions hiện tại không?
6. Có đưa ví dụ về style/pattern mong muốn không?
7. Có chỉ rõ constraints và requirements không?

Điểm then chốt

• Không giao task quá lớn: Dùng TDD làm rào chắn, chia nhỏ task, kiểm tra từng bước
• Cung cấp ngữ cảnh đầy đủ: Error messages, môi trường, file liên quan, expected vs. actual
• Đối xử với Claude như đồng nghiệp: Dùng ngôn ngữ kỹ thuật chính xác, cung cấp ví dụ, cho phản hồi cụ thể
• Cải tiến dần: Bắt đầu đơn giản, thêm dần phức tạp, không cố làm mọi thứ cùng lúc
• Ghi lại mọi thứ vào CLAUDE.md: Mỗi bài học, mỗi convention mới đều nên được cập nhật

Tiếp theo, hãy tìm hiểu về bảo mật — yếu tố nền tảng không thể bỏ qua khi triển khai agentic coding.