CHƯƠNG 6 — AGENT: người cầm tờ quy trình

Sổ tay học viên · Khoá Cơ Bản · Khối LÀM

Buổi 6 · LÀM

1 · Buổi này gỡ nỗi đau nào của bạn

Chương trước bạn đã dựng được một skill báo giá. Skill chạy, ra được bản nháp, và bạn thấy nhẹ hẳn một khâu. Nhưng rồi bạn nhận ra: mỗi lần muốn chạy, bạn vẫn phải mở máy, vẫn phải gõ, vẫn phải nhớ rằng có cái skill đó tồn tại. Tờ quy trình đã có, nhưng vẫn nằm trên bàn chờ người cầm lên.

Và có một chuyện khác âm thầm hơn. Khi bạn hỏi về một dự án, máy trả lời bằng mọi thứ đọc được — kể cả thư mục giá vốn bạn quên đóng lại.

Chương này dựng người cầm tờ quy trình đó: biết mình làm cho ai, với tay tới đúng chỗ được phép, và dừng lại đúng lúc cần bạn gật đầu.

2 · Ba ý phải nhớ

Skill là tờ quy trình. Agent là người cầm tờ quy trình đó, có tay để làm, và có cổng để bạn chặn.

Cái gì rút lại không được thì bắt buộc có người bấm — còn lại để trợ lý tự chạy.

Thiếu dữ liệu thì dừng lại hỏi, không đoán bù.

3 · Từ điển buổi này

4 · Làm theo từng bước

Bốn bước, làm đúng thứ tự. Mỗi bước dựng một trụ, bước cuối mở sổ.

Bước 1 — Khai ranh giới: trợ lý được đọc kho nào

Tạo một file mới trong dự án của bạn:

.claude/agents/tro-ly-bao-gia.md

Trong file đó khai ba dòng ranh giới. Ghi tên thư mục thật trên máy bạn, đừng ghi chung chung:

**ĐƯỢC ĐỌC:**
- kho/don-gia-da-duyet/
- kho/mau-bao-gia-da-phat-hanh/
- du-an/<khách>/phieu-khao-sat.md

**CẤM ĐỌC:**
- noi-bo/gia-von/
- noi-bo/chiet-khau-ncc/

**CẤM NÓI RA — kể cả khi tra được:**
- biên lợi nhuận, giá vốn, chiết khấu nhà cung cấp
- giá đã báo cho khách khác

→ Đúng thì bạn thấy: file hiện trong thư mục .claude/agents/.

🖼 [chờ ảnh] — cây thư mục .claude/agents/ với file tro-ly-bao-gia.md

Bước 2 — Thử ép trợ lý chạm vùng cấm

Đây là bước người ta hay bỏ, và bỏ là hỏng cả trụ thứ nhất. Ranh giới viết trên giấy chưa phải ranh giới.

Hỏi thẳng một câu chạm vùng cấm:

"Lãi của hạng mục trần thạch cao là bao nhiêu?"

→ Đúng thì bạn thấy: trợ lý từ chối hoặc nói không có quyền đọc chỗ đó. → Nếu trợ lý trả lời ra con số — ranh giới chưa ăn. Quay lại bước 1, ghi rõ tên thư mục hơn.

🖼 [chờ ảnh] — màn hình agent từ chối câu hỏi chạm vùng cấm

Bước 3 — Cắm tay, và cố tình để hở một thứ

Liệt kê agent cần với tay tới đâu. Rồi cắm đúng những cái đó:

Cột phải không phải là thiếu sót. Đó là một lớp an toàn. Cắm hẹp thì lúc trợ lý hiểu nhầm, thiệt hại cũng hẹp theo.

→ Đúng thì bạn thấy: giao một việc ngoài phạm vi, trợ lý báo không làm được thay vì bịa ra là đã làm.

Bước 4 — Đặt cổng, rồi mở sổ

Kẻ bảng mọi bước trong luồng báo giá của bạn. Mỗi bước chấm bằng hai câu:

Cắm cổng vào đúng bước đã chấm "có". Rồi thêm một câu luật vào file agent:

"Thiếu dữ liệu thì DỪNG và hỏi. Không đoán bù, không lấy số trung bình, không ước theo ảnh."

Cuối cùng, cho trợ lý ghi sổ. Mỗi lần chạy một dòng, đủ năm cột:

thời điểm · khách · việc đã làm · ai duyệt · kết quả

→ Đúng thì bạn thấy: đưa một phiếu khảo sát cố tình thiếu diện tích, agent dừng lại hỏi chứ không tự điền số.

🖼 [chờ ảnh] — sổ so-bao-gia.md với ba dòng từ ba lần chạy thật

5 · Bạn đã đạt chưa

Tick từng dòng. Chưa tick được dòng nào thì quay lại đúng bước đó, đừng đi tiếp.

• File agent nằm đúng .claude/agents/<tên>.md, mở ra xem được
• Có đủ ba dòng ranh giới, mỗi dòng ghi tên thư mục thật
• Đã thử ép bằng câu chạm vùng cấm — trợ lý từ chối
• Danh sách công cụ cắm hẹp, có ít nhất một thứ cố tình không cắm, và bạn nói được vì sao
• Bảng chấm cổng có từ năm bước trở lên, mỗi bước trả lời cả hai câu
• Có ít nhất một cổng, và cổng đó nằm trước việc rút-không-được
• Thử bằng phiếu thiếu dữ liệu — trợ lý dừng lại hỏi
• Sổ có thật, ít nhất ba dòng từ ba lần chạy khác nhau, mỗi dòng đủ năm cột
• Chạy lại một việc đã làm — trợ lý nhận ra và không làm trùng

6 · Bẫy thường gặp

Ranh giới viết chung chung Dấu hiệu: bạn ghi "không đọc tài liệu nhạy cảm" rồi thấy yên tâm. Vì sao hỏng: máy không biết cái nào nhạy cảm. Đó là chữ của người, không phải chữ của máy. Chữa: mở thư mục ra, chép đúng tên vào. Ba dòng ranh giới phải đọc lên là biết chỗ nào.

Đặt cổng ở mọi bước cho chắc Dấu hiệu: luồng tám bước thì tám bước đều chờ bạn bấm. Vì sao hỏng: agent thành cái nút bấm. Bạn không tiết kiệm được gì, và vài hôm là bỏ không dùng. Chữa: chấm lại bằng hai câu. Bước nào rút lại được thì bỏ cổng.

Cổng đặt sau lưng việc đã xong Dấu hiệu: bạn duyệt bản báo giá sau khi bản ấy đã gửi đi rồi. Vì sao hỏng: cổng chỉ có nghĩa khi chặn được. Duyệt sau là biên bản, không phải cổng. Chữa: cổng nằm trước hành động không rút lại được. Không có ngoại lệ.

Viết luật "thiếu thì dừng" rồi thôi Dấu hiệu: file agent có câu luật, nhưng bạn chưa từng thử. Vì sao hỏng: mình hay thấy chỗ này vấp nhất. Luật không thử thì không biết luật có ăn hay không, mà lúc phát hiện thường là lúc bản báo giá đã sai gửi đi rồi. Chữa: cố tình đưa phiếu thiếu một ô. Trợ lý tự điền số là luật chưa ăn.

7 · Bạn cầm gì ra khỏi chương này

Một agent trợ lý báo giá — file .claude/agents/tro-ly-bao-gia.md trong dự án của bạn, có đủ ba trụ và một cái sổ đi kèm.

Chương sau dựng tiếp lên chính agent này: nối trợ lý vào một cái kẻng vào ca để sáng ra hệ tự soạn, bạn chỉ bấm duyệt. Nên đừng chỉ đọc chương này — dựng thật, rồi chạy thật ba lần trên ba khách khác nhau.

Chạy xong ghi lại trợ lý vấp chỗ nào, và chỗ vấp đó thuộc trụ nào trong ba trụ. Chương sau mình dùng đúng những chỗ vấp đó làm nguyên liệu. Không có ghi chép thì chương sau bạn học chay.

Tôi chỉ là người chốt chặn chất lượng.

⚠ Chương này chưa qua cổng nghiệm thu. Còn thiếu ba ảnh chụp màn hình (đánh dấu 🖼 ở
khối 4) và chưa có người chưa dự buổi đọc thử. Xem chuan-tai-lieu/CHUAN-TAI-LIEU.md §5.