Nghệ Thuật Thiết Kế Và Lập Kế Hoạch Skill Cho Claude

Chương 2 có tiêu đề "Planning and design" (Lập kế hoạch và thiết kế) là một trong những phần quan trọng nhất, hướng dẫn chi tiết từ khâu lên ý tưởng cho đến khi cấu trúc các tập tin cho một skill. Chương này được chia thành 4 trọng tâm chính:

1. Xác định trường hợp sử dụng (Start with use cases) Trước khi bắt tay vào thiết kế, bạn cần xác định 2-3 trường hợp sử dụng cụ thể, trong đó mô tả rõ: câu lệnh kích hoạt từ người dùng (trigger), các bước thực hiện (steps) và kết quả mong đợi (result). Tài liệu chia các skill thành 3 nhóm phổ biến:

• Nhóm 1 - Tạo tài liệu và tài sản (Document & Asset Creation): Dùng để tạo ra các đầu ra chất lượng cao và nhất quán như thiết kế giao diện, ứng dụng, mã code hoặc tài liệu (như slide, bảng tính). Skill loại này thường nhúng các tiêu chuẩn thương hiệu, biểu mẫu chuẩn mà không cần kết nối với công cụ bên ngoài.

• Nhóm 2 - Tự động hóa quy trình (Workflow Automation): Phù hợp với các quy trình nhiều bước cần phương pháp luận nhất quán, thường có các cổng kiểm tra xác thực và vòng lặp tự động tinh chỉnh (ví dụ: skill tự động hóa các bước hướng dẫn người dùng tạo ra một skill khác).

• Nhóm 3 - Nâng cao MCP (MCP Enhancement): Dùng để điều phối nhiều lệnh gọi công cụ MCP liên tiếp, nhúng kiến thức chuyên môn và tự xử lý các lỗi thường gặp trong quá trình gọi API (ví dụ: tự động phân tích và sửa lỗi trên GitHub dựa trên dữ liệu lỗi từ Sentry).

2. Định hình tiêu chí thành công (Define success criteria) Để đánh giá skill có hoạt động hiệu quả hay không, bạn cần đo lường qua 2 bộ chỉ số:

• Định lượng: Skill tự động kích hoạt đúng lúc trong 90% các truy vấn liên quan, hoàn thành luồng công việc với số lượng lệnh gọi công cụ (tool calls) tối ưu và tỷ lệ gọi API thất bại bằng 0.

• Định tính: Người dùng không cần phải nhắc Claude về các bước tiếp theo, toàn bộ quy trình hoàn tất mà không cần người dùng can thiệp sửa đổi, và kết quả đầu ra luôn đồng nhất qua nhiều phiên làm việc khác nhau.

3. Tuân thủ các yêu cầu kỹ thuật khắt khe (Technical requirements) Chương này quy định những quy tắc "bất di bất dịch" khi thiết lập hệ thống tệp cho skill:

• Quy tắc đặt tên: Tệp chứa nội dung chính bắt buộc phải viết chính xác là SKILL.md (có phân biệt chữ hoa/chữ thường). Thư mục chứa skill phải định dạng theo kiểu kebab-case (ví dụ: notion-project-setup), không được chứa khoảng trắng, dấu gạch dưới hay chữ viết hoa. Đặc biệt, không được đặt tệp README.md bên trong thư mục này.

• Phần cấu hình YAML (YAML frontmatter): Đây là đoạn thông tin tối quan trọng nằm ở đầu tệp SKILL.md, giúp Claude quyết định khi nào thì kích hoạt skill. Cấu hình bắt buộc phải có trường name và description. Do các yếu tố bảo mật, bạn tuyệt đối không được sử dụng thẻ đóng mở XML (< >) hoặc đặt tên skill chứa các từ khóa riêng như "claude" hay "anthropic".

4. Kỹ thuật viết hướng dẫn hiệu quả (Writing effective skills)

• Đầu tư vào trường mô tả (description): Một đoạn mô tả tốt (dưới 1024 ký tự) phải thể hiện được 2 yếu tố: Skill làm gì? và Khi nào thì dùng đến?. Bạn cần đưa vào các "cụm từ kích hoạt" cụ thể. Ví dụ một mô tả tốt: "Phân tích tệp thiết kế Figma... Sử dụng khi người dùng tải lên tệp .fig, yêu cầu 'thông số thiết kế'...". Những mô tả quá chung chung hoặc quá nặng tính kỹ thuật mà thiếu từ khóa người dùng hay dùng sẽ làm skill không thể tự kích hoạt.

• Cấu trúc nội dung SKILL.md: Khuyến nghị dùng Markdown để cấu trúc các bước rõ ràng (Step 1, Step 2...), cung cấp kèm các ví dụ kịch bản (Examples) và hướng xử lý khi gặp lỗi (Troubleshooting).

• Thực hành nguyên tắc "Tiết lộ lũy tiến": Các chỉ dẫn (prompt) phải thật cụ thể, rõ ràng, luôn đi kèm cách xử lý lỗi. Tuy nhiên, thay vì nhồi nhét mọi thứ vào SKILL.md, hãy giữ tệp này tập trung vào các bước cốt lõi. Các tài liệu hướng dẫn dài hạn nên được tách ra và lưu ở thư mục references/, sau đó dẫn link để Claude tự tìm đọc khi cần.