Tác nhân AI viết code của bạn chỉ đạt 10/100 điểm: Những gì bạn đang bỏ sót

Tác nhân AI viết code của bạn chỉ đạt 10/100 điểm: Những gì bạn đang bỏ sót

Sau khi thực hiện 2.431 lần kiểm tra trên 8 nền tảng lập trình AI với các kho mã nguồn thực tế, tôi đã nhận thấy một mô hình rõ ràng: hầu hết các dự án chỉ sử dụng chưa đến 10% những gì có sẵn.

Tôi đã xây dựng Nerviq — một công cụ CLI không có dependency (zero-dependency) giúp kiểm toán thiết lập tác nhân AI viết code của bạn và chấm điểm từ 0 đến 100.

npx @nerviq/cli audit

Hầu hết các dự án chỉ đạt điểm 10-20 trên 100. Sau khi chạy thiết lập tối ưu, điểm số có thể nhảy vọt lên 60-80+.

10 điều quan trọng bạn có thể đang bỏ lỡ

1. File hướng dẫn (Critical - Rất quan trọng)

Mọi nền tảng AI viết code đều có một loại file dành riêng: CLAUDE.md, AGENTS.md, .cursorrules, GEMINI.md. Nếu thiếu file này, tác nhân sẽ không biết các lệnh build (build commands), phong cách code (code style), hay các quy tắc của dự án.

2. Sơ đồ kiến trúc (Tiết kiệm 73% token)

Một biểu đồ Mermaid cung cấp cho tác nhân cấu trúc dự án chỉ bằng một phần nhỏ số token so với việc viết văn bản mô tả.

3. Hooks ưu tiên hơn hướng dẫn (Tuân thủ 100% so với 80%)

Hướng dẫn bằng văn bản chỉ mang tính tham khảo (~80% tuân thủ). Hooks mang tính xác định (100%). Hãy tự động chạy lint sau mỗi lần chỉnh sửa. Mọi lúc.

4. Lệnh xác minh (Verification commands)

Đây là điều có tầm quan trọng cao nhất mà bạn có thể làm. — Anthropic Best Practices

Các tác nhân hoạt động hiệu quả hơn đáng kể khi chúng có thể tự xác minh công việc của mình.

5. Quy tắc từ chối (Deny rules)

Tác nhân AI của bạn tự động tải các file .env. Nếu không có quy tắc từ chối, nó có thể đọc được các bí mật (secrets). Đây là lỗi nghiêm trọng phổ biến nhất.

6. Lệnh tùy chỉnh (Custom commands)

Hãy ngừng gõ cùng một câu lệnh nhắc nhở (prompt) liên tục. Hãy tạo các lệnh tái sử dụng như /test, /deploy, /review.

7. Sự lệch pha đa nền tảng (Cross-platform drift)

Nếu bạn sử dụng Claude kết hợp với Cursor và Copilot, cấu hình của chúng có thể xung đột. Lệnh nerviq harmony-audit sẽ tự động phát hiện điều này.

8. Hồ sơ quyền hạn (Permission profiles)

Hầu hết các thiết lập hoặc là cho phép tất cả hoặc là chặn tất cả. Có các hồ sơ tốt hơn: read-only (chỉ đọc), suggest-only (chỉ gợi ý), safe-write (ghi an toàn), power-user (người dùng cấp cao).

9. Cấu hình MCP

Máy chủ MCP mở rộng khả năng của tác nhân, nhưng việc sử dụng quá 10 máy chủ hoặc hơn 80 công cụ sẽ làm giảm hiệu suất.

10. Kiểm tra cụ thể theo Stack công nghệ

Python, Go, Rust, Java, Ruby, PHP, .NET, Flutter, Swift, Kotlin — mỗi ngôn ngữ đều có những yêu cầu cấu hình tác nhân riêng biệt.

Tính năng mới: Tự động sửa lỗi (Auto-fix)

nerviq fix                    # Hiển thị những gì có thể sửa
nerviq fix claudeMd           # Sửa một kiểm tra cụ thể
nerviq fix --all-critical     # Sửa tất cả các vấn đề nghiêm trọng

Mỗi lần sửa đều hiển thị tác động đến điểm số: Score: 4 → 16 (+12).

An toàn là trên hết

• nerviq audit — chỉ đọc, không ghi gì cả (mặc định)
• nerviq suggest-only — báo cáo dưới dạng markdown, không ghi file
• --dry-run — xem trước các thay đổi
• --config-only — chỉ chạm vào các file cấu hình, không bao giờ chạm vào mã nguồn
• Mọi thao tác ghi đều tạo các bản sao lưu để khôi phục (rollback artifacts)

Hãy thử ngay

npx @nerviq/cli audit              # Quét nhanh: điểm số + top 3 vấn đề
npx @nerviq/cli audit --full       # Tất cả các kiểm tra + mức độ tin cậy
npx @nerviq/cli suggest-only       # Chia sẻ kết quả với đội nhóm
npx @nerviq/cli harmony-audit      # Sự đồng nhất đa nền tảng

Không có dependency. Không cần API key. Chạy cục bộ trên máy của bạn. Giấy phép AGPL-3.0.

GitHub: github.com/nerviq/nerviq npm: npmjs.com/package/@nerviq/cli Website: nerviq.net