Chuyển tới nội dung chính

Cách Làm Việc Hiệu Quả Với AI Agent

Tài liệu này được rút ra từ thực tế — một cuộc hội thoại dài giữa người dùng và Claude để xây dựng tài liệu hướng dẫn Claude Code Skills & Hooks. Toàn bộ quy trình, từ bản nháp đầu tiên đến sản phẩm hoàn chỉnh, trải qua 8 vòng chỉnh sửa với nhiều lần thêm, bớt, viết lại. Những gì ghi ở đây không phải lý thuyết — mà là cách làm đã chạy được.

1. Tư Duy Cốt Lõi: Bạn Là Người Chỉ Đạo, AI Là Người Thực Thi​

AI agent rất giỏi viết, tổng hợp, cấu trúc — nhưng không biết bạn muốn gì cho đến khi bạn nói. Đừng ngồi chờ AI đoán đúng từ đầu. Thay vào đó, hãy coi AI như một nhân viên mới rất có năng lực: cho họ làm bản nháp trước, rồi bạn review và chỉ đạo điều chỉnh.

Sai lầm phổ biến:

  • Viết prompt dài 500 chữ cố gắng mô tả hoàn hảo mọi thứ từ đầu → mệt, mà AI vẫn hiểu sai
  • Nhận output xong thấy không đúng ý → bỏ luôn, bắt đầu lại từ đầu
  • Không dám nói thẳng "cái này sai, bỏ đi" vì sợ mất phép lịch sự

Cách đúng: Bắt đầu nhẹ, để AI tự xây dựng dàn ý, rồi điều chỉnh dần qua nhiều vòng.

2. Quy Trình 4 Bước​

Bước 1: Khởi đầu ngắn gọn — để AI tự dàn ý​

Không cần prompt dài. Chỉ cần nêu rõ mục tiêu và phạm vi:

Bạn làm dùm tôi cách viết skill chuẩn của Claude nhé.
Sau đó là cách viết hook và ứng dụng của hook.

Hai câu. Vậy là đủ để AI tạo bản nháp đầu tiên. AI sẽ tự quyết định cấu trúc, nội dung, ví dụ. Bản nháp này sẽ không hoàn hảo — và đó là bình thường. Mục đích là có thứ gì đó để review, không phải có sản phẩm cuối.

Tại sao không viết prompt chi tiết từ đầu?

Vì bạn chưa biết AI sẽ tổ chức thế nào. Khi thấy bản nháp, bạn mới nhận ra "à, phần này thừa", "phần kia thiếu", "cấu trúc này không hợp lý". Phản ứng với thứ có sẵn dễ hơn nhiều so với tưởng tượng từ con số 0.

Bước 2: Review bằng mắt — đánh dấu cụ thể​

Khi nhận output, đọc qua nhanh và đánh dấu những chỗ cần sửa. Cách hiệu quả nhất:

  • Screenshot + khoanh tròn — chụp màn hình, vẽ khoanh tròn lên phần cần sửa, gửi kèm mô tả. AI hiểu ngay "chỗ này" là chỗ nào.
  • Nói thẳng vấn đề — không cần giải thích dài dòng, chỉ cần nêu rõ: cái gì sai, muốn thay bằng gì.

Ví dụ từ cuộc hội thoại thực tế:

Hình 1 => bạn viết file skill hoàn chỉnh trong 1 khung code thôi,
và ghi lưu ý quan trọng là bắt buộc phải có đoạn định nghĩa phía trên
theo đúng format thì mới chạy đúng

Hình 2, ngay đoạn đầu giới thiệu skill bạn lưu ý người dùng là
skill nên ngắn gọn xúc tích khoảng 300 chữ tối đa 500 chữ

Ngắn, thẳng, có hình minh họa. AI hiểu ngay và sửa đúng chỗ.

Bước 3: Chỉnh sửa nhiều vòng — mỗi vòng một focus​

Không cố sửa hết mọi thứ trong 1 lần. Mỗi vòng review, tập trung vào 1-2 vấn đề chính:

VòngFocusVí dụ thực tế
1Cấu trúc tổng"Bỏ phần 1.3 và 1.4 đi"
2Chi tiết nội dung"Phần hook nói ngắn gọn lại, chỉ lấy 1 ví dụ thôi"
3Thêm phần mới"Viết thêm hướng dẫn về file CLAUDE.md"
4Sửa lỗi nhỏ"Gộp 2 khung code thành 1, thêm lưu ý bắt buộc"
5Bổ sung thiếu sót"Thêm phần thiết lập folder .claude ở trên cùng"

Quy trình này giống cách sculptor đẽo tượng: phác thô trước → gọt hình dáng → mài chi tiết → đánh bóng.

Bước 4: Kiểm tra lần cuối trên thiết bị thật​

Đọc lại output trên thiết bị sẽ sử dụng (điện thoại, máy tính). Trong cuộc hội thoại mẫu, người dùng mở file trên điện thoại, phát hiện code block hiển thị bị cắt, bảng hiển thị không đẹp — những thứ không thấy được khi chỉ đọc trong chat.

3. Kỹ Thuật Giao Tiếp Với AI​

3.1. Nói thẳng, không vòng vo​

AI không có cảm xúc, không cần xã giao. Càng thẳng thắn, AI càng hiểu đúng:

❌ "Tôi nghĩ có lẽ phần hook hơi dài, bạn có thể cân nhắc rút gọn
    nếu bạn thấy phù hợp..."

✅ "Phần hook bạn nói ngắn gọn lại. Chỉ lấy ví dụ HTML to PPTX thôi,
    bỏ hết ví dụ khác."

3.2. Đưa lý do khi yêu cầu thay đổi​

Khi nói "sửa chỗ này", giải thích ngắn gọn tại sao. AI sẽ áp dụng logic đó cho toàn bộ tài liệu, không chỉ chỗ bạn chỉ:

❌ "Sửa phần multi-skill"

✅ "Chỗ multi skill bạn đặt vầy user sẽ hiểu nhầm về cách đặt file skill
    đơn giản, tôi muốn 1 chuẩn thống nhất như 1.2 dù skill có đơn giản
    1 file markdown thì cũng để trong folder tên skill"

Câu thứ hai cho AI biết: không chỉ sửa phần multi-skill, mà phải đồng bộ chuẩn folder xuyên suốt tài liệu.

3.3. Screenshot + khoanh tròn = vũ khí mạnh nhất​

Khi tài liệu dài, mô tả bằng chữ "đoạn thứ 3 trong phần 1.5" dễ hiểu nhầm. Screenshot với vùng khoanh tròn bằng bút đỏ thì không thể hiểu nhầm được.

Trong cuộc hội thoại mẫu, người dùng gửi 2-3 screenshot mỗi lần, mỗi ảnh khoanh tròn 1 chỗ cần sửa, kèm giải thích ngắn. AI sửa đúng 100% vì biết chính xác "chỗ này" là dòng nào.

3.4. Hỏi ý kiến AI trước khi thực thi​

Khi thêm phần lớn hoàn toàn mới, hãy trình bày ý tưởng và hỏi AI có cần bổ sung gì không trước khi cho viết:

Bạn viết thêm hướng dẫn về file CLAUDE.md.
File này thường để chú thích dự án...
=> bạn thấy kiến thức này đúng ko, có cần bổ sung gì ko.
Trả lời tôi trước khi thực thi nhé.

AI sẽ xác nhận phần đúng, bổ sung thêm những gì bạn chưa nghĩ tới (ví dụ: survive /compact, thứ tự đọc hierarchy, phân biệt với .claude/rules/). Sau khi đồng ý mới cho viết — tiết kiệm 1 vòng chỉnh sửa.

3.5. Đưa context từ kinh nghiệm thực tế​

AI biết lý thuyết, nhưng bạn biết thực tế. Chia sẻ vấn đề thật mà team gặp:

Team có nhiều bạn không đặt folder .claude ở root nên là ko có tác dụng
gì hết. Cách kiểm tra xem .claude có hoạt động không là gõ /skill name
bất kì để xem nó có hiện ra không.

Từ 1 câu thực tế này, AI tạo ra được cả phần "Bước 0: Thiết lập" với cách kiểm tra, lỗi thường gặp, hướng dẫn fix — tất cả đều thực tế vì xuất phát từ vấn đề thật.

4. Checklist Làm Việc Với AI Agent​

Trước khi bắt đầu​

  • Xác định mục tiêu: tạo cái gì, cho ai đọc, dùng ở đâu?
  • Chuẩn bị context: có tài liệu sẵn? Có ví dụ mẫu? Có kinh nghiệm thực tế?
  • Quyết định format output: markdown, docx, code file?

Vòng 1 — Bản nháp​

  • Gửi prompt ngắn gọn (2-3 câu mô tả mục tiêu)
  • Để AI tự quyết định cấu trúc
  • Nhận output, đọc lướt toàn bộ trước khi sửa

Vòng 2-4 — Chỉnh sửa​

  • Mỗi vòng tập trung 1-2 vấn đề, không sửa hết cùng lúc
  • Screenshot + khoanh tròn cho vấn đề cụ thể
  • Nói thẳng: bỏ/thêm/viết lại + lý do
  • Hỏi ý kiến AI trước khi thêm phần hoàn toàn mới

Vòng cuối — Kiểm tra​

  • Đọc lại trên thiết bị thật (điện thoại/máy tính)
  • Kiểm tra: code block có hiển thị đúng không?
  • Kiểm tra: cấu trúc có nhất quán không? (đánh số, convention)
  • Kiểm tra: có phần nào lặp lại hoặc mâu thuẫn không?

5. Các Phương Án Làm Việc​

Không phải lúc nào cũng dùng 1 cách. Tùy tình huống mà chọn:

Phương án A: AI dẫn dắt → Bạn chỉnh (dùng khi chưa rõ mình muốn gì)​

Bạn: "Viết cho tôi hướng dẫn về X"
AI:   Tạo bản nháp hoàn chỉnh
Bạn: Review → chỉnh sửa qua nhiều vòng

Phù hợp khi: chủ đề rộng, chưa có outline sẵn, muốn khám phá AI tổ chức thế nào. Đây là cách đã dùng trong cuộc hội thoại mẫu.

Phương án B: Bạn dẫn dắt → AI thực thi (dùng khi biết rõ mình muốn gì)​

Bạn: "Viết theo outline này: 1. Cấu trúc... 2. Ví dụ... 3. Lưu ý..."
AI:   Viết theo đúng outline
Bạn: Review → sửa chi tiết

Phù hợp khi: đã có outline rõ ràng, chỉ cần AI viết content.

Phương án C: Đối thoại → Đồng thuận → Thực thi (dùng cho nội dung phức tạp)​

Bạn: "Tôi nghĩ nên thêm phần X, ý tôi là... bạn thấy đúng không?"
AI:   Xác nhận + bổ sung ý
Bạn: "Ok viết đi"
AI:   Thực thi

Phù hợp khi: nội dung chuyên môn sâu, cần AI bổ sung kiến thức bạn chưa có. Trong cuộc hội thoại mẫu, phần CLAUDE.md dùng cách này — người dùng trình bày ý tưởng, AI bổ sung thêm 6 điểm, đồng ý rồi mới viết.

Phương án D: Template sẵn → AI điền (dùng cho công việc lặp lại)​

Bạn: Upload template + dữ liệu
AI:   Điền vào template theo pattern

Phù hợp khi: tạo nhiều tài liệu cùng format (skill files, API docs, test plans).

6. Sai Lầm Thường Gặp​

"Prompt dài = kết quả tốt" — Sai. Prompt 2 câu rõ ràng thường cho kết quả tốt hơn prompt 20 câu mơ hồ. Quan trọng là rõ ràng, không phải dài.

"Sửa 1 lần cho xong" — Sai. Output tốt nhất đến từ 3-5 vòng chỉnh sửa. Vòng 1 là phác thảo, vòng 2-3 là gọt giũa, vòng 4-5 là đánh bóng. Cố sửa hết trong 1 lần thường dẫn đến prompt quá phức tạp, AI hiểu sai nhiều chỗ.

"AI sai thì bỏ, bắt đầu lại" — Sai. Output sai 70% vẫn có giá trị — bạn đã biết 70% đó trông như thế nào và cần sửa gì. Bắt đầu lại = mất hết context đã build up.

"Không dám bảo AI xóa" — Sai. Xóa bỏ nội dung thừa quan trọng không kém gì thêm nội dung mới. Trong cuộc hội thoại mẫu, 2 section hoàn chỉnh (1.3 Anatomy, 1.4 Progressive Disclosure) bị xóa hẳn — và tài liệu tốt hơn nhờ vậy.

"Phải viết tiếng Anh cho AI hiểu" — Sai. AI hiểu tiếng Việt tốt. Viết bằng ngôn ngữ bạn thoải mái nhất — thoải mái thì thẳng thắn hơn, thẳng thắn thì AI hiểu đúng hơn.

7. Tóm Tắt​

1. Bắt đầu nhẹ    → Prompt ngắn, để AI tự dàn ý
2. Review nhanh    → Screenshot + khoanh tròn
3. Sửa từng vòng  → Mỗi vòng 1-2 focus
4. Nói thẳng       → Bỏ/thêm/viết lại + lý do
5. Hỏi trước      → Trình bày ý → AI bổ sung → đồng ý → thực thi
6. Kiểm tra cuối  → Đọc trên thiết bị thật

Nguyên tắc xuyên suốt: AI là công cụ khuếch đại ý tưởng của bạn, không phải thay thế. Bạn càng rõ ràng về mình muốn gì, AI càng tạo ra đúng thứ bạn cần. Và cách nhanh nhất để biết mình muốn gì — là xem AI tạo bản nháp đầu tiên, rồi phản ứng lại.

Rút ra từ cuộc hội thoại thực tế xây dựng tài liệu "Claude Code Skills & Hooks Guide" — 8 vòng chỉnh sửa, từ bản nháp đến sản phẩm hoàn chỉnh.