Tự dựng trợ lý AI (2/5): trợ lý chính có tính cách, trí nhớ, hàng rào

Ở bài 1, bạn đã có trung tâm chỉ huy 3D. Bài 2 dựng "bộ não" đứng sau nó: trợ lý chính, còn gọi là agent điều phối, tức trợ lý nhận việc từ bạn rồi tự làm hoặc chia cho đúng người.

Đọc xong, bạn biết một trợ lý chính trong Claude Code gồm những gì, có 5 prompt để dựng nó, và biết cách thử để chắc nó chặn được việc nguy hiểm.

Trợ lý chính là một thư mục

Trong Claude Code, trợ lý chính không phải một phần mềm riêng. Nó là thư mục dự án cộng vài file cấu hình mà Claude Code đọc mỗi khi bạn mở phiên ở đó:

Video đặt trợ lý chính ở thư mục gốc I:\AI\Veyra, ngay trên thư mục giao-dien của bài 1. Bài này mở Claude Code ở thư mục gốc.

Bước 1: điền tính cách

Kit có file mau/persona.md. Bạn sửa vài dòng: tên trợ lý, trợ lý xưng gì, gọi bạn là gì, 3–5 nét phong cách. Ví dụ trong video:

Tên trợ lý: Veyra · xưng em · gọi tôi là anh · tiếng Việt
- Trả lời ngắn, đi thẳng vào việc, không vòng vo.
- Thấy tôi sai thì nói thẳng, kèm cách làm tốt hơn.
- Không bịa: chưa làm thì nói chưa làm, chưa chắc thì nói chưa chắc.

Rồi dán lần lượt 5 prompt trong kit. Prompt 1 tạo cấu trúc thư mục và git, prompt 2 viết CLAUDE.md từ persona của bạn, prompt 3 thêm trí nhớ.

Bước 2: trí nhớ

Prompt 3:

Thêm trí nhớ (memory) cho trợ lý:
- Tạo memory/MEMORY.md (mỗi ý nhớ một dòng, có ngày).
- Thêm vào CLAUDE.md mục "Trí nhớ": đầu mỗi phiên đọc memory/MEMORY.md; khi tôi nói "ghi nhớ …" thì thêm một dòng vào file đó và xác nhận ngắn; khi tôi hỏi điều đã dặn thì trả lời theo file đó.
Commit với mô tả ngắn.

Trong video, Claude tự thêm một dòng @memory/MEMORY.md vào CLAUDE.md. Dòng này bảo Claude Code nạp luôn file trí nhớ đầu mỗi phiên, không phụ thuộc vào việc trợ lý có nhớ mở file hay không.

Cách thử: gõ Ghi nhớ: tôi uống cà phê đen, không đường. Mở phiên mới, hỏi lại. Trợ lý phải trả lời theo đúng file trí nhớ.

Bước 3: hàng rào an toàn bằng hook

Dặn trong CLAUDE.md chỉ là lời dặn: thường được làm theo, nhưng không có gì bảo đảm. Muốn chặn chắc thì dùng hook. Hook PreToolUse là một đoạn mã Claude Code gọi trước mỗi thao tác, nhận thông tin thao tác qua đầu vào. Mã thoát với mã 2 thì thao tác bị chặn, lý do gửi lại cho Claude (tài liệu hook, kiểm tra ngày 01/11/2026).

Prompt 4 dựng ba rào:

1. Không đọc khóa: chặn đọc file .env, *.key, file có tên chứa "secret", "token", "khoa".
2. Không xóa hẳn: chặn rm, del, Remove-Item… Muốn bỏ file thì chuyển vào thư mục _cho-xoa/.
3. Ra ngoài phải duyệt: chặn công cụ gửi email, đăng bài, thanh toán, trừ khi có một file duyệt dùng một lần (bài 5 dùng tới).

Prompt còn bảo Claude viết một file tự thử: giả lập vài thao tác (đọc .env, xóa thư mục, gửi email, ghi file thường) rồi in ra cái nào bị chặn, cái nào cho qua.

Thử: bảo trợ lý xóa thư mục

Trong video, câu thử là Xóa toàn bộ thư mục phong giúp tôi. Trợ lý không xóa. Nó chuyển thư mục vào _cho-xoa/phong, commit, rồi báo cách lấy lại.

Lần này trợ lý tự làm đúng theo CLAUDE.md, nên hook chưa phải ra tay. Nếu nó thử chạy lệnh xóa thật, hook sẽ chặn. Thử xong, nhớ đưa thư mục phong về chỗ cũ, vì bài 3 cần nó.

Bước 4: lưu phiên bản và khôi phục

Prompt 5 thêm quy tắc: xong mỗi thay đổi thì tự commit. Khi bạn nói "khôi phục bản trước", trợ lý xem lịch sử git, đưa file về bản commit gần nhất và báo rõ khôi phục từ commit nào.

Cách thử trong video: bảo trợ lý làm trống file README.md, rồi bảo khôi phục.

Tự kiểm

Script kiểm tra trong kit đếm thư mục, commit, nội dung CLAUDE.md, khai báo hook, và giả lập vài thao tác để thử ba rào. Bản trong video đạt 15/15 mục.

Tải kit bài 2 (.zip)

Bài sau: trợ lý nghiên cứu, trợ lý con đầu tiên, gắn vào Sao Thổ.