Cách giúp Codex hiểu bạn tốt hơn: Làm chủ các kỹ thuật ghi nhớ để tăng hiệu suất lên 90%

Sau một thời gian sử dụng Codex App, hẳn bạn đã từng gặp những bực mình tương tự: phải lặp lại các cài đặt cơ bản mỗi khi bắt đầu một cuộc trò chuyện mới, hoặc nó vô tình thực thi các lệnh hệ thống ngoài mong đợi của bạn.

Bản chất của những điểm đau tần suất cao này là Codex của bạn thiếu một bộ nhớ dài hạn ổn định. Để giải quyết triệt để những giao tiếp lặp đi lặp lại kém hiệu quả này, bạn phải xây dựng một hệ thống bộ nhớ hoàn chỉnh cho nó.

Bài viết này sẽ hướng dẫn cách cấu hình AGENTS.md và Tính năng Memories để cấp cho Codex bộ nhớ vĩnh viễn, giúp nó thực sự hiểu ý định của bạn và đạt được hiệu quả công việc.

1. AGENTS.md

1. Nó là gì?

AGENTS.md là một tập hợp các hướng dẫn quy tắc được viết sẵn mà Codex tự động đọc mỗi khi khởi động.

Nếu không có AGENTS.md, mỗi lần Codex khởi động đều như một tờ giấy trắng – nó không biết thói quen làm việc, bối cảnh dự án, hay ranh giới thực thi thao tác của bạn.

Khi các quy tắc liên quan được cấu hình, những bối cảnh này sẽ có hiệu lực vĩnh viễn và bạn sẽ không bao giờ phải giải thích lại cùng một vấn đề.

2. Cách cấu hình và sử dụng

1️⃣ Lớp Toàn cầu: Được lưu trữ trong thư mục ~/.codex/AGENTS.md trên máy tính cục bộ của bạn, áp dụng cho tất cả các dự án. Phù hợp để viết các sở thích cá nhân toàn cầu và quy tắc chung.

Trong Codex App, điều này tương ứng với phần "Hướng dẫn tùy chỉnh" (Custom Instructions) trên trang cài đặt Cá nhân hóa.

Dưới đây là một mẫu cơ bản được đề xuất mà bạn có thể sao chép và dán trực tiếp vào vị trí hiển thị ở trên, sau đó liên tục điều chỉnh theo nhu cầu của bạn:

1# AGENTS.md
2
3## Hành vi cơ bản
4
5- Mặc định trả lời bằng tiếng Việt trừ khi người dùng yêu cầu rõ ràng một ngôn ngữ khác.
6- Câu trả lời nên ngắn gọn và trực tiếp, tránh những từ ngữ thừa thãi và lặp lại không cần thiết.
7- Nếu mô tả nhiệm vụ không rõ ràng, hãy yêu cầu xác nhận trước khi bắt đầu thực hiện.
8- Không chủ động suy đoán nhu cầu ngoài ý định của người dùng; chỉ làm những gì được yêu cầu.
9
10## Ranh giới an toàn
11
12- Mặc định là chỉ đọc; không chủ động sửa đổi hoặc xóa bất kỳ tệp nào trừ khi được người dùng hướng dẫn rõ ràng.
13- Trước khi thực hiện các thao tác không thể đảo ngược (như xóa, ghi đè, hoặc gọi API bên ngoài để ghi), phải xin phép trước.
14- Không in bất kỳ khóa, token hoặc thông tin xác thực nhạy cảm nào trong đầu ra.
15
16## Tiêu chuẩn kỹ thuật
17
18- Tránh thiết kế quá mức cần thiết; chỉ thực hiện những thay đổi được yêu cầu rõ ràng hoặc hiển nhiên cần thiết cho nhiệm vụ, giữ giải pháp đơn giản.
19- Không thêm tính năng, tái cấu trúc mã, hoặc thực hiện tối ưu hóa bổ sung trừ khi được yêu cầu.
20- Không thêm chú thích, chú thích kiểu, hoặc docstring vào mã không thay đổi.
21- Chỉ thêm chú thích khi logic không tự giải thích được.
22- Không thêm xử lý lỗi hoặc logic dự phòng cho các tình huống khó có thể xảy ra.
23- Không tạo các hàm tiện ích hoặc lớp trừu tượng chỉ được sử dụng một lần.
24- Trực tiếp xóa mã đã được xác nhận là vô dụng; không để lại chú thích giải thích.

2️⃣ Lớp Dự án: Được lưu trữ trong thư mục dự án, chủ yếu được sử dụng để tùy chỉnh các quy tắc dựa trên chủ đề và đặc điểm của dự án.

Một AGENTS.md cấp dự án tốt thường nên bao gồm các khía cạnh sau:

• Bối cảnh và cấu trúc dự án: Dự án là gì và các thư mục quan trọng nằm ở đâu.
• Phương thức thực thi: Cách khởi động, chạy hoặc vận hành dự án.
• Tiêu chuẩn và ràng buộc: Các tiêu chuẩn cần tuân theo và những điều không được làm.
• Tiêu chí hoàn thành: Cách xác định xem một nhiệm vụ đã kết thúc hay chưa.

3. Các phương pháp hay nhất với AGENTS.md

Cấu hình một AGENTS.md cơ bản chỉ là bước đầu tiên. Các nguyên tắc thực tế sau đây quyết định giới hạn trên của hệ thống bộ nhớ của bạn:

1️⃣ Phân lớp quy tắc, trách nhiệm rõ ràng

Trong Codex, AGENTS.md tuân theo nguyên tắc lân cận: Thư mục con > Thư mục gốc > Toàn cầu. Nghĩa là, các quy tắc trong thư mục chứa công việc hiện tại có mức độ ưu tiên cao nhất.

Điều này có nghĩa là các quy tắc cấp dự án sẽ trực tiếp ghi đè các cài đặt toàn cầu cùng loại. Nếu tất cả các quy tắc được trộn lẫn với nhau, các quy tắc cục bộ có mức ưu tiên cao có thể dễ dàng vô tình làm nhiễm bẩn hoặc phá hủy logic nền tảng toàn cầu.

Do đó, một hệ thống bộ nhớ quy tắc hợp lý nên tuân theo nguyên tắc "phân tách mối quan tâm": lớp toàn cầu chỉ chứa các quy tắc chung, chẳng hạn như sở thích ngôn ngữ, ranh giới an toàn và thói quen hành vi cơ bản; lớp dự án chứa các đặc tả cụ thể cho dự án đó, chẳng hạn như lệnh xây dựng, quy ước mã và mô tả mô-đun.

Hai lớp thực hiện nhiệm vụ riêng của mình mà không can thiệp lẫn nhau và sẽ không có xung đột nào xảy ra khi hợp nhất.

2️⃣ Bắt đầu từ những điều cơ bản, lặp lại khi cần

AGENTS.md không cần phải viết tất cả cùng một lúc. Hãy bắt đầu với các quy tắc cốt lõi nhất. Khi Codex lặp lại cùng một lỗi, hãy trực tiếp yêu cầu nó xem xét và cập nhật các quy tắc, ví dụ:

"Bạn vừa mắc lỗi giống như lần trước. Hãy tóm tắt lý do và thêm kinh nghiệm liên quan vào AGENTS.md."

Bằng cách này, các quy tắc luôn xuất phát từ những ma sát sử dụng thực tế và AGENTS.md sẽ liên tục phát triển theo quá trình sử dụng.

3️⃣ Giữ cho nó gọn nhẹ, tách nội dung phức tạp riêng biệt

Khi việc sử dụng ngày càng sâu, nội dung của AGENTS.md có thể tăng lên. Lúc này, không cần phải nhồi nhét mọi thứ vào một tệp duy nhất. Thay vào đó, hãy viết nội dung cho các chủ đề cụ thể thành các tệp độc lập và sau đó tham chiếu chúng trong tệp chính.

Ví dụ: viết mô tả kiến ​​trúc dự án riêng thành ARCHITECTURE.md và chỉ bao gồm một dòng tham chiếu trong AGENTS.md:

"Để biết kiến ​​trúc cốt lõi và đặc tả thư mục của dự án này, vui lòng tham khảo tệp ARCHITECTURE.md trong thư mục hiện tại."

2. Tính năng Memories

Ngoài việc chủ động cấu hình các quy tắc liên quan, Codex còn hỗ trợ tính năng bộ nhớ chủ động, cần được bật trong Cài đặt - Cá nhân hóa - Bộ nhớ (Memory), như hình dưới đây:

Sau khi bật nút, Codex sẽ chủ động tổng hợp thông tin hữu ích và các sở thích chính từ cuộc trò chuyện vào bộ nhớ. Nếu bạn muốn xem những bộ nhớ nào Codex của bạn đã thêm, bạn có thể mở tệp Memory.md trong ~/.codex/memory để xem nội dung bộ nhớ mà Codex của bạn đã thêm. Dưới đây là của tôi:

Cuối cùng

Xây dựng một hệ thống bộ nhớ là một quá trình phát triển theo thời gian. Hãy tin tôi, chỉ cần bạn kiên trì cải thiện và cập nhật các quy tắc hành động, đồng thời liên tục tích lũy bộ nhớ, Codex sẽ nhanh chóng trở thành công cụ năng suất cứng nhắc hiểu bạn nhất và thuận tiện nhất để sử dụng.