Tôi hiểu nhiệm vụ của mình là dịch văn bản này từ tiếng Anh sang tiếng Việt, tuân thủ nghiêm ngặt các quy tắc bạn đưa ra. Tôi sẽ giữ nguyên cấu trúc Markdown/HTML, không dịch brand name hay tên sản phẩm (YouMind, ByteDance, Slides), và xử lý cẩn thận các code segment cùng blockquote.
Dưới đây là bản dịch của tôi:
Trước đây tôi đã viết về cách prompt hiệu quả nhất cho thế hệ Claude 5 mới nhất và làm việc với chúng một cách lặp đi lặp lại để khám phá những gì bạn muốn xây dựng.
Nhưng khi bạn gửi một tin nhắn đến Claude, prompt chỉ là một phần nhỏ trong ngữ cảnh mà nó nhận được. Phần lớn ngữ cảnh của bạn được tập hợp từ system prompt, Skills, file CLAUDE.md, bộ nhớ và các nguồn khác. Chúng tôi gọi đây là kỹ thuật ngữ cảnh, và nó tạo ra tác động lớn đến kết quả bạn tạo ra khi sử dụng Claude Code hoặc khi xây dựng agent của riêng mình.
Không giống như prompt, ngữ cảnh được sử dụng chung cho nhiều yêu cầu khác nhau, vì vậy nó không thể quá cụ thể. Làm thế nào để bạn xây dựng những prompt và hướng dẫn tổng quát này cho Claude, đặc biệt là khi bạn không biết prompt của người dùng có thể là gì?
Điều này có thể khó khăn một cách đáng ngạc nhiên khi khả năng của chính Claude ngày càng phát triển. Gần đây nhất, chúng tôi đã nhận thấy một bước nhảy vọt trong cách chúng tôi prompt thế hệ Claude mới nhất. Chúng tôi đã loại bỏ hơn 80% system prompt của Claude Code cho các mô hình như Claude Opus 5 và Claude Fable 5 mà không có bất kỳ sự suy giảm nào có thể đo lường được trong các bài đánh giá code của chúng tôi.
Dưới đây là những gì chúng tôi đã học được về cách prompt nhóm mô hình mới này và cách bạn có thể tận dụng nó để cập nhật kỹ thuật ngữ cảnh của mình. Chúng tôi đã đưa những phương pháp hay nhất này vào \claude doctor\, hãy sử dụng lệnh /doctor trong Claude Code để điều chỉnh kích thước skills và file CLAUDE.md của bạn.
Cởi trói cho Claude
Nhìn chung, chúng tôi nhận thấy rằng mình đã kiềm chế Claude Code quá mức, cả thông qua system prompt cũng như trong file CLAUDE.md và skills.
Ví dụ, khi đọc bản ghi của chính nội bộ chúng tôi sử dụng Claude Code, chúng tôi thấy một số thông điệp mâu thuẫn trong một yêu cầu duy nhất như "để lại tài liệu khi thích hợp" hoặc "KHÔNG thêm bình luận" khi system prompt, skills và yêu cầu của người dùng xung đột với nhau.
Nhìn chung, Claude có thể diễn giải ý định của người dùng để đưa ra câu trả lời đúng, nhưng Claude phải suy nghĩ cẩn thận hơn về những thông điệp chồng chéo và mâu thuẫn này trước khi quyết định phải làm gì.
Và mặc dù những ràng buộc này từng cần thiết để tránh các kịch bản xấu nhất, chúng tôi đã phát hiện ra rằng mình có thể xóa nhiều ràng buộc trong số đó và để mô hình sử dụng ngữ cảnh xung quanh và phán đoán thay vào đó.
Ngoài ra, Claude Code hiện có nhiều công cụ hơn. Claude từng phụ thuộc vào CLAUDE.md như một nguồn bộ nhớ, thông tin và hướng dẫn. Giờ đây chúng tôi có bộ nhớ, artifact và skills, mà Claude có thể sử dụng để tạo ra những cách mới để tải và chia sẻ ngữ cảnh giữa các phiên làm việc.
Trước đây và bây giờ
Đã có một số phương pháp hay nhất trước đây về kỹ thuật ngữ cảnh đã trở thành huyền thoại. Bao gồm:
**
**Trước đây: Đưa ra quy tắc cho Claude
Hiện tại: Để Claude sử dụng phán đoán**
Khi lần đầu tiên triển khai Claude Code, chúng tôi cần đảm bảo rằng Claude tránh được các kịch bản xấu nhất, chẳng hạn như xóa file. Điều này có nghĩa là chúng tôi sẽ đưa ra những hướng dẫn đặc biệt mạnh mẽ mà không phải lúc nào cũng đúng. Ví dụ, trong system prompt, chúng tôi từng nói:
Trong code: mặc định không viết bình luận. Không bao giờ viết docstring nhiều đoạn hoặc khối bình luận nhiều dòng — tối đa một dòng ngắn. Đừng tạo tài liệu lập kế hoạch, quyết định hoặc phân tích trừ khi người dùng yêu cầu — hãy làm việc từ ngữ cảnh hội thoại, không phải từ các file trung gian.
Nhưng đối với một số prompt nhất định, hướng dẫn này sẽ sai. Trong trường hợp tài liệu, người dùng có thể có sở thích riêng của họ hoặc các phần cụ thể của code rất phức tạp có thể cần các khối bình luận nhiều dòng.
Tuy nhiên, nếu không có những rào cản này cho các mô hình cũ hơn, các bình luận mà Claude viết sẽ không chính xác trong nhiều trường hợp và chúng tôi phải chấp nhận sự đánh đổi này. Nhưng các mô hình mới hơn có khả năng phán đoán tốt hơn và có thể xử lý tốt các quyết định này mà không cần quy tắc rõ ràng.
Trong system prompt mới, chúng tôi nói: Viết code đọc giống như code xung quanh: khớp mật độ bình luận, cách đặt tên và ngữ điệu.
**Trước đây: Đưa ra ví dụ cho Claude
Hiện tại: Thiết kế giao diện**
Quy tắc số một cho việc sử dụng công cụ là đưa ra ví dụ cho Claude về cách sử dụng chúng. Với các mô hình mới nhất của chúng tôi, chúng tôi phát hiện ra rằng việc đưa ra ví dụ thực sự lại kiềm chế chúng trong một không gian khám phá nhất định.
Thay vì sử dụng ví dụ, hãy suy nghĩ nhiều hơn về thiết kế của các công cụ, script, file của bạn — Claude có những tham số nào và làm thế nào để chúng có thể diễn đạt tốt hơn?
Ví dụ, trong công cụ Todo, chỉ cần liệt kê trạng thái như một kiểu liệt kê giữa pending, in_progress và completed, đã gợi ý cho Claude cách sử dụng nó. Hướng dẫn giữ một mục ở trạng thái in_progress giúp xác định hành vi chúng tôi yêu cầu.
**Trước đây: Đặt tất cả lên phía trước
Hiện tại: Sử dụng tiết lộ dần dần**
Vì Claude Code tập trung vào code, system prompt của chúng tôi bao gồm thông tin chi tiết về cách thực hiện đánh giá và xác minh code. Những thông tin này không phải lúc nào cũng cần thiết, nhưng khi cần, đó là thông tin quan trọng.
Kể từ đó, Claude Code đã trở nên rất thành thạo trong việc sử dụng tiết lộ dần dần — tải đúng ngữ cảnh vào đúng thời điểm. Ví dụ, chúng tôi đã chuyển việc xác minh và đánh giá code thành các skill riêng mà Claude Code có thể gọi một cách có chọn lọc.
Nhưng tiết lộ dần dần không chỉ dành cho skills, chúng tôi cũng sử dụng nó cho các công cụ. Một số công cụ của chúng tôi có 'tải trễ' (deferred loading), có nghĩa là agent phải tìm kiếm định nghĩa đầy đủ của chúng bằng ToolSearch trước khi sử dụng. Điều này cho phép chúng tôi có nhiều công cụ hơn (chẳng hạn như công cụ Task) mà không chiếm dụng ngữ cảnh cho đến khi cần thiết.
Điều tương tự cũng có thể áp dụng cho file CLAUDE.md và Skill.md của riêng bạn. Một huyền thoại phổ biến là bạn muốn biến chúng thành một kho lưu trữ trung tâm cho mọi phương pháp đã biết mà bạn có thể gặp phải, vì nếu không Claude sẽ không tìm thấy. Thay vào đó, hãy cân nhắc có một cấu trúc cây file có thể được tải vào đúng thời điểm.
**Trước đây: Lặp lại chính mình
Hiện tại: Mô tả công cụ đơn giản**
Các mô hình Claude trước đôi khi có thể cần các hướng dẫn lặp lại hoặc có xu hướng nghe theo hướng dẫn ở cuối cửa sổ ngữ cảnh hơn là ở đầu. Điều này có nghĩa là system prompt của chúng tôi đôi khi có tham chiếu đến các công cụ trong system prompt chính cũng như hướng dẫn trong mô tả công cụ.
Chúng tôi nhận thấy rằng mình có thể xóa các ví dụ lặp lại này và đặt hướng dẫn về cách sử dụng công cụ trong mô tả công cụ thay vì trong system prompt.
**Trước đây: Bộ nhớ trong file CLAUDE.md
Hiện tại: Tự động ghi nhớ**
Chúng tôi từng khuyến khích người dùng lưu mọi thứ vào bộ nhớ của Claude bằng cách sử dụng phím tắt # để ghi tự động vào CLAUDE.md của họ. Thay vào đó, giờ đây Claude tự động lưu những ký ức có liên quan đến công việc và đến bạn.
**Trước đây: Thông số kỹ thuật đơn giản
Hiện tại: Tham chiếu phong phú**
Trong chế độ lập kế hoạch, Claude Code phụ thuộc rất nhiều vào các file markdown với các kế hoạch. Lưu trữ các file này dưới dạng kế hoạch đã giúp Claude tham chiếu đến chúng khi cần. Một phương pháp hay tương tự khác là lưu trữ các thông số kỹ thuật trong codebase để Claude tham khảo khi làm việc trên các dự án dài hơn.
Nhưng chúng tôi nhận thấy rằng Claude có thể xử lý các tham chiếu ngày càng phức tạp hơn. Thay vì các file markdown đơn giản, Claude có thể tham chiếu đến các artifact HTML được tạo bởi tính năng artifact mới của chúng tôi.
Bạn cũng có thể cung cấp cho Claude các tham chiếu dưới dạng code. Một thông số kỹ thuật cũng có thể là một bộ kiểm thử chi tiết hoặc một hàm trong một codebase khác mà Claude có thể chuyển đổi.
Rubric là một dạng tham chiếu khác. Rubric cho phép Claude cố gắng xác minh sở thích của bạn trong một lĩnh vực cụ thể (ví dụ: thiết kế API tốt trông như thế nào) bằng cách sử dụng luồng công việc động và khởi chạy các agent xác minh với các rubric đó.
Áp dụng điều này vào ngữ cảnh của bạn
Tổng hợp tất cả lại, điều này trông như thế nào khi bạn tập hợp ngữ cảnh của mình?
**System Prompt
**System prompt gắn liền với ngữ cảnh sản phẩm. Nó cho Claude biết nó đang hoạt động trong sản phẩm nào và đang làm gì. Đối với Claude Code, bạn gần như sẽ không bao giờ sửa đổi điều này, nhưng nếu bạn đang xây dựng agent harness của riêng mình, đây là nơi bạn nên dành nhiều thời gian.
**CLAUDE.md
**Giữ CLAUDE.md nhẹ nhàng và mô tả ngắn gọn repo của bạn dùng để làm gì, nhưng hãy dành hầu hết các token cho các vấn đề (gotchas) bên trong codebase. Ví dụ, bạn có thể tổ chức code của mình để giữ các kiểu trong một file nguyên khối duy nhất và không nơi nào khác. Tránh nêu những điều 'hiển nhiên' mà Claude có thể biết bằng cách nhìn vào hệ thống file hoặc repo của bạn.
Sử dụng tiết lộ dần dần để biết thêm chi tiết, ví dụ nếu bạn có một số hướng dẫn độc đáo về cách xác minh công việc của mình, hãy tạo một skill xác minh và tham chiếu nó từ CLAUDE.md của bạn.
**Skills
**Hãy nghĩ về skills như những hướng dẫn nhẹ nhàng để Claude tìm thông tin khi cần. Tránh làm chúng bị giới hạn quá mức, ngoại trừ trong các lĩnh vực cực kỳ quan trọng.
Đối với các skill dài, hãy cố gắng sử dụng tiết lộ dần dần càng nhiều càng tốt — chia nó thành nhiều file và tách chúng ra.
Sẽ tốt nhất khi skills mã hóa các ý kiến, kiến thức hoặc phương pháp hay nhất cụ thể dành riêng cho bạn, nhóm của bạn hoặc sản phẩm.
**References
**Bạn có thể @ đề cập đến các file để bao gồm chúng dưới dạng tham chiếu. Các tham chiếu cho phép Claude tham khảo thông tin chuyên sâu về kế hoạch hiện tại.
Đây có thể là trong các file thông số kỹ thuật, bản mô phỏng, hoặc thậm chí toàn bộ codebase. Nhìn chung, bạn nên ưu tiên các file ở dạng code vì nó cung cấp hướng dẫn rõ ràng, độ chính xác cao cho Claude bằng ngôn ngữ mà nó biết rất rõ. Ví dụ, một bản mô phỏng HTML của một thiết kế thường sẽ mang lại kết quả tốt hơn so với mô tả thiết kế hoặc ảnh chụp màn hình.
Hãy thử đơn giản hóa
Trên toàn bộ system prompt, skills và file CLAUDE.md của bạn, bạn có thể cần đơn giản hóa giống như chúng tôi đã làm. Chúng tôi đã triển khai một lệnh mới có tên \claude doctor\, sẽ giúp bạn thực hiện việc này một cách tự động. Để biết thêm chi tiết về cách prompt các mô hình nâng cao hơn một cách cụ thể, hãy xem Hướng dẫn thực địa về Fable của chúng tôi.
