Thiết kế Cấu trúc và Khắc phục Sự cố Quy trình MCP

ai-skillai

Chương 5 của tài liệu mang tiêu đề "Patterns and troubleshooting" (Các mô hình cấu trúc và khắc phục sự cố). Đây là một chương mang tính thực tiễn cao, được đúc kết từ kinh nghiệm của những người dùng sớm và đội ngũ nội bộ, chia làm hai phần chính: định hướng thiết kế cấu trúc và cách xử lý các lỗi thường gặp.

Dưới đây là nội dung chi tiết của Chương 5:

Phần 1: Lựa chọn hướng tiếp cận cốt lõi

Trước khi chọn mô hình, tài liệu khuyên bạn nên xác định rõ tư duy thiết kế của mình thuộc nhóm nào:

  • Tiếp cận từ vấn đề (Problem-first): Người dùng chỉ cần nêu kết quả mong muốn (ví dụ: "Thiết lập không gian dự án"), và skill sẽ tự động điều phối các công cụ (MCP) theo đúng trình tự để giải quyết.

  • Tiếp cận từ công cụ (Tool-first): Người dùng đã kết nối với công cụ (ví dụ: Notion), và skill đóng vai trò hướng dẫn Claude cách làm việc tốt nhất trên công cụ đó.

Phần 2: 5 Mô hình thiết kế quy trình (Workflow Patterns) phổ biến

Tùy vào mục đích, bạn có thể áp dụng 1 trong 5 mô hình sau:

1. Điều phối quy trình tuần tự (Sequential workflow orchestration):

  • Khi nào dùng: Dành cho các quy trình nhiều bước phải thực hiện theo một thứ tự cố định.

  • Đặc điểm: Yêu cầu thứ tự rõ ràng, bước sau phụ thuộc vào bước trước, có các bước kiểm tra (validation) và hướng dẫn hoàn tác (rollback) nếu lỗi.

  • Ví dụ: Quy trình chào đón khách hàng mới: Tạo tài khoản -> Thiết lập thanh toán -> Đăng ký gói -> Gửi email.

2. Phối hợp nhiều MCP (Multi-MCP coordination):

  • Khi nào dùng: Khi luồng công việc trải dài qua nhiều dịch vụ/ứng dụng khác nhau.

  • Đặc điểm: Phân chia thành các giai đoạn (phase) rõ ràng, truyền dữ liệu chéo giữa các MCP và xử lý lỗi tập trung.

  • Ví dụ: Chuyển giao thiết kế cho lập trình: Xuất file từ Figma (Figma MCP) -> Lưu trữ (Drive MCP) -> Tạo task (Linear MCP) -> Thông báo (Slack MCP).

3. Tinh chỉnh lặp đi lặp lại (Iterative refinement):

  • Khi nào dùng: Dành cho các tác vụ mà chất lượng đầu ra cần được cải thiện qua nhiều vòng lặp.

  • Đặc điểm: Đưa ra tiêu chí chất lượng cụ thể, có các kịch bản kiểm tra (script) và biết điểm dừng của vòng lặp.

  • Ví dụ: Tạo báo cáo: Viết nháp -> Kiểm tra lỗi thiếu sót/định dạng -> Sửa lỗi và vòng lặp lại -> Chốt bản cuối.

4. Lựa chọn công cụ dựa trên ngữ cảnh (Context-aware tool selection):

  • Khi nào dùng: Cùng một mục đích nhưng sẽ dùng công cụ khác nhau tùy tình huống.

  • Đặc điểm: Đưa ra các tiêu chí quyết định rõ ràng, có phương án dự phòng và minh bạch lý do chọn công cụ với người dùng.

  • Ví dụ: Lưu trữ file: File >10MB dùng Cloud, file code dùng GitHub, file nháp lưu cục bộ.

5. Trí thông minh đặc thù theo lĩnh vực (Domain-specific intelligence):

  • Khi nào dùng: Khi skill cần nhúng các kiến thức, quy tắc chuyên ngành khắt khe trước khi thực hiện hành động.

  • Đặc điểm: Nhúng tư duy chuyên gia vào logic, luôn kiểm tra tuân thủ trước khi hành động và lưu lại nhật ký kiểm toán (audit trail).

  • Ví dụ: Xử lý thanh toán có kiểm tra tính tuân thủ tài chính: Kiểm tra danh sách cấm/rủi ro -> Xử lý (nếu đạt) hoặc Gắn cờ chờ duyệt (nếu không đạt).

--------------------------------------------------------------------------------

Phần 3: Khắc phục sự cố thường gặp (Troubleshooting)

Chương này tổng hợp các lỗi kinh điển khi tạo skill và cách sửa:

  • Skill không tải lên được: Thường do đặt sai tên file (phải chính xác là SKILL.md phân biệt hoa thường), thư mục chứa khoảng trắng/chữ hoa, hoặc viết sai định dạng YAML frontmatter (thiếu dấu ngoặc, thiếu delimiter ---).

  • Skill không kích hoạt (Không tự chạy): Do mô tả quá chung chung hoặc thiếu các từ khóa "kích hoạt" mà người dùng hay dùng. Cách sửa: Hãy hỏi thử Claude xem khi nào nó sẽ dùng skill này để tìm ra điểm thiếu sót.

  • Skill kích hoạt quá nhiều (Chạy sai lúc): Tải cả ở những yêu cầu không liên quan. Cách sửa: Thêm các từ khóa phủ định (ví dụ: "Do NOT use for...") và thu hẹp phạm vi áp dụng.

  • Lỗi kết nối MCP: Skill đã chạy nhưng gọi công cụ thất bại. Cách kiểm tra: Xác minh lại server MCP có đang kết nối không, API key có hợp lệ không, hoặc dùng Claude gọi MCP trực tiếp (không qua skill) để xem lỗi do skill hay do server.

  • Claude không làm theo hướng dẫn: Do hướng dẫn quá dài dòng, câu lệnh mơ hồ hoặc bị chìm khuất. Cách sửa: Đưa các chỉ thị quan trọng lên đầu với tiêu đề nổi bật (như ## Critical), dùng ngôn ngữ dứt khoát, cụ thể và chuyển bớt các chi tiết rườm rà sang thư mục references/.

  • Vấn đề quá tải ngữ cảnh (Phản hồi chậm/kém): Xảy ra khi file SKILL.md quá dài (khuyên dùng dưới 5.000 từ), hoặc bật cùng lúc quá nhiều skill (khuyên dưới 20-50 skills). Hãy áp dụng triệt để "tiết lộ lũy tiến" để tối ưu hóa.

Bình luận (0)

Đang tải bình luận...