Nếu bạn dùng AI để viết code, sửa lỗi, làm nội dung, phân tích dữ liệu hoặc tự động hóa công việc, bạn sẽ sớm gặp một khái niệm rất quan trọng: System Prompt.
📥 Tải miễn phí
Coding Principles Prompt
System Prompt là gì?
System Prompt là bộ hướng dẫn nền giúp AI biết phải hành động như thế nào.
Nếu user prompt là yêu cầu cụ thể, ví dụ:
Hãy sửa lỗi đăng nhập trong file này.
Thì system prompt là bộ nguyên tắc AI phải tuân theo, ví dụ:
Chỉ sửa phần liên quan, không thêm thư viện mới, phải kiểm tra lại sau khi sửa.
Nói đơn giản: User prompt là việc cần làm. System prompt là cách AI phải làm việc.
Vì sao System Prompt quan trọng?
AI ngày nay không chỉ trả lời câu hỏi. Nó có thể viết code, sửa file, chạy lệnh, phân tích lỗi và hoạt động như một AI Agent.
Nếu không có system prompt rõ ràng, AI rất dễ:
- Viết code quá dài.
- Tự thêm thư viện không cần thiết.
- Sửa nhiều phần ngoài yêu cầu.
- Refactor lung tung.
- Không kiểm thử sau khi sửa.
- Trả lời dài nhưng không giải quyết đúng vấn đề.
Một system prompt tốt giúp AI làm việc có kỷ luật hơn, rõ phạm vi hơn và dễ kiểm soát hơn. Khi workflow đã ổn định, prompt caching giúp giảm chi phí xử lý lại phần hướng dẫn cố định.
Một System Prompt tốt nên có gì?
Một system prompt hiệu quả nên quy định rõ:
- Vai trò của AI.
- Phạm vi được phép làm.
- Khi nào cần hỏi lại.
- Khi nào được tự xử lý.
- Có được thêm thư viện hay không.
- Cách sửa code.
- Cách kiểm thử.
- Cách báo lỗi.
- Định dạng đầu ra.
Đặc biệt với AI Agent, system prompt nên giúp AI làm đúng việc, sửa đúng chỗ, kiểm tra được kết quả và không tự ý mở rộng nhiệm vụ.
Giới thiệu Coding Principles Prompt
Tôi đã chuẩn bị một bộ nguyên tắc tên là Coding Principles Prompt dành cho những ai dùng AI để lập trình hoặc vận hành AI Agent. Bản đang tải về là v5, và điều đáng nói nhất về nó là tôi đã bỏ đi nhiều hơn thêm vào.
Prompt này giúp AI làm việc theo các nguyên tắc:
- Hiểu rõ mục tiêu trước khi viết dòng code đầu tiên.
- Đọc code thật trước khi sửa, không đoán theo trí nhớ.
- Ưu tiên giải pháp nhỏ nhất, không tự ý thêm thư viện mới.
- Chỉ sửa phần liên quan trực tiếp, không refactor lan man.
- Luôn có bước kiểm thử, và không bao giờ sửa bài kiểm thử cho dễ đậu.
- Log lỗi đủ rõ để một phiên làm việc sau đọc lại mà chẩn đoán được.
- Dừng lại hỏi trước những thao tác không hoàn tác được.
Bộ tải về có bốn file, nhưng chỉ một trong số đó là thứ bạn thật sự cài vào máy.
- CLAUDE.md — bộ nguyên tắc chính, đây là file bạn cài.
- skills/nextjs-rules/SKILL.md — quy tắc riêng cho Next.js, chỉ nạp khi bạn đụng tới Next.js.
- tham-chieu/claude-code-system-prompt.md — bản chụp system prompt mặc định của Claude Code, để đọc chứ không cài.
- HUONG-DAN-CAI-DAT.md — hướng dẫn cài bằng tiếng Việt.
Vì sao bản v5 ngắn đi mà tốt lên
Bản đầu tiên của prompt này có một quy tắc mà lúc viết tôi khá tự tin. Quy tắc số 10, tên là AI-optimized code, và nó nói thẳng như thế này:
Mã nguồn được tối ưu cho AI kiểm tra và máy tính thực thi, không phải cho con người đọc.
Nghe rất hợp thời.
Vấn đề là Claude Code có sẵn một system prompt riêng, nạp trước mọi thứ bạn viết, và trong đó có một câu gần như ngược lại: hãy viết code đọc giống phần code xung quanh nó. Khi hai câu đó cùng nằm trong đầu model, nó phải tự chọn nghe bên nào, và bạn không biết nó chọn bên nào.
Đó là bài học lớn nhất khi tôi ngồi soát lại từng dòng: trùng lặp thì chỉ tốn tiền, còn mâu thuẫn thì làm hành vi không đoán trước được. Bản v5 sửa ba chỗ như vậy, cắt bớt những quy tắc mà công cụ vốn đã tự làm, và chuyển phần Next.js ra thành một skill riêng để nó chỉ nạp khi thật sự cần đến.
Đây cũng là lý do trong bộ tải về có thêm bản chụp system prompt mặc định. Nó trả lời câu hỏi mà hầu như không ai kịp hỏi trước khi ngồi viết CLAUDE.md cho mình: công cụ đã tự biết làm những gì rồi? Trả lời được câu đó, bạn viết ít đi mà được nhiều hơn.
Prompt này phù hợp với ai?
Bạn nên dùng prompt này nếu bạn:
- Dùng ChatGPT, Claude, Gemini để viết code.
- Dùng Cursor, Windsurf, Claude Code hoặc AI coding agent.
- Đang xây MVP bằng AI.
- Muốn AI sửa code nhưng không làm quá phạm vi.
- Muốn chuẩn hóa cách AI làm việc trong project.
- Không muốn AI tự ý thêm package, refactor lung tung hoặc trả lời quá dài.
Cách cài
Nhanh nhất là để Claude Code tự cài. Giải nén bộ này ra một thư mục bất kỳ, mở terminal ngay tại đó, gõ lệnh claude, rồi nhắn đúng một câu:
Đọc HUONG-DAN-CAI-DAT.md trong thư mục này và cài giúp tôi.
Trong file hướng dẫn có sẵn một khối chỉ dẫn viết riêng cho AI đọc: file nào chép đi đâu, file nào tuyệt đối không được chép, và phải hỏi lại bạn nếu máy đã có sẵn một CLAUDE.md từ trước. Bạn không cần nhớ thêm gì cả.
Còn nếu muốn tự tay làm thì cũng chỉ có hai bước. Chép file CLAUDE.md vào thư mục .claude nằm trong thư mục người dùng của bạn, rồi mở lại Claude Code. Chép thêm thư mục skills nếu bạn có làm việc với Next.js.
Một lưu ý quan trọng cho cả hai cách: nếu chỗ đó đã có sẵn CLAUDE.md của riêng bạn thì đừng ghi đè. Mở cả hai file ra, giữ phần của bạn, rồi chèn thêm những mục còn thiếu.
Dùng với Cursor, ChatGPT hoặc công cụ khác
File CLAUDE.md là markdown thuần, không phụ thuộc Claude Code. Bạn lưu nó thành .cursorrules ở thư mục gốc dự án, dán vào phần Custom Instructions của ChatGPT, hoặc đổi tên thành AGENTS.md cho công cụ nào đọc file đó.
Chỉ có một khác biệt đáng nhớ. Phần phụ lục ở cuối file liệt kê những quy tắc mà Claude Code vốn đã tự làm, kèm gợi ý xóa bớt cho gọn. Với các công cụ khác thì không có sẵn gì cả, nên hãy giữ nguyên toàn bộ.
Kết luận
System prompt là một trong những công cụ quan trọng nhất để làm việc hiệu quả với AI. Nhưng viết nó không phải là cuộc thi xem ai liệt kê được nhiều quy tắc hơn.
Mỗi dòng bạn viết trong đó đều được nạp lại ở mọi phiên, mọi tác vụ, kể cả những phiên chẳng liên quan gì tới nó. Một bộ nguyên tắc tốt vì thế được đo bằng thứ nó dám bỏ đi, chứ không phải thứ nó gom vào.
📥 Tải miễn phí
Coding Principles Prompt
