Mình là Minh, dev freelance tại TP.HCM chuyên build tool AI cho các shop thương mại điện tử Việt Nam. Tháng 11 năm ngoái, mình nhận deal "khủng" từ một brand mỹ phẩm nội địa: họ cần triển khai một agent xử lý đỉnh dịch khách hàng Black Friday — dự kiến ~50.000 ticket/ngày, không được phép sập, không được phép trả lời sai SOP đổi trả hàng.
Mình thử vanilla Claude Sonnet 4.5 qua Anthropic API gốc: agent "không biết" policy đổi hàng riêng của brand, không gọi được CRM nội bộ, và đặc biệt là latency đo được trung bình 820ms — quá chậm cho live chat trên mobile 4G. Sau 2 tuần mày mò cộng đồng Anthropic tools và một thread Reddit khá dài về "skills plugin hack", mình tìm ra combo cực ngon: Claude Code Skills plugin + HolySheep API chuyển tiếp (đăng ký tại đây). Bài viết này mình sẽ chia sẻ toàn bộ quy trình — từ thiết kế skill manifest, hook tool call, cho đến benchmark thực tế tại production.
Claude Code Skills Là Gì?
Claude Code Skills là cơ chế mở rộng của Anthropic cho phép developer đóng gói "kiến thức + công cụ (tools)" vào một plugin có version, có manifest, có thể tái sử dụng xuyên suốt các project. Một skill bao gồm:
- SKILL.md: file mô tả persona, SOP, prompt template.
- tools/*.json: đặc tả function/tool mà skill có thể gọi (REST API, CRM, DB, Slack…).
- hooks/: pre/post hooks để validate input, log audit, hoặc gọi tool ngoài.
- triggers: regex/intent giúp router tự động kích hoạt skill theo câu khách nói.
Khác với "system prompt dài 5 trang", Skills có cấu trúc chuẩn nên Claude không bị "lạm dụng ngữ cảnh" — điều này giảm đáng kể token đầu vào và tăng tốc độ phản hồi.
Tại Sao Brand TMĐT Cần Custom Skills?
- Vanilla Claude không biết SKU nội bộ và chính sách đổi trả riêng của từng brand.
- Cần gọi trực tiếp CRM (Haravan, KiotViet, Sapo) để check đơn thay vì để CSKH con người tra cứu.
- Compliance: phải log mọi refund để đối soát sau Black Friday.
- Latency: live chat yêu cầu P95 < 200ms cho text-response đầu tiên.
Hướng Dẫn Từng Bước Phát Triển Plugin
Bước 1 — Chuẩn Bị Môi Trường
# Cài đặt Claude Code CLI
npm install -g @anthropic-ai/claude-code
Đăng nhập bằng key từ HolySheep (KHÔNG dùng key Anthropic trực tiếp để tránh overcharge)
export ANTHROPIC_BASE_URL="https://api.holysheep.ai/v1"
export ANTHROPIC_API_KEY="YOUR_HOLYSHEEP_API_KEY"
Khởi tạo project skill
mkdir ecommerce-support-agent && cd ecommerce-support-agent
claude-code init --type skill
Bước 2 — Khai Báo Skill Manifest
File skill.yaml định nghĩa persona, tools, triggers. Đây là "bộ xương" mà Claude runtime sẽ load mỗi khi router bắt được intent phù hợp.
name: ecommerce-support-agent
version: 1.0.0
description: "Agent CSKH cho brand mỹ phẩm nội địa"
persona: |
Bạn là trợ lý CSKH của Brand X. Luôn xưng "em", gọi khách là "chị/anh".
Quy tắc đổi trả: trong 7 ngày, hóa đơn đầy đủ, sản phẩm còn nguyên seal.
Không cam kết refund khi chưa gọi tool issue_refund.
triggers:
- intent: return_request
patterns: ["đổi hàng", "đổi trả", "trả hàng", "hàng lỗi"]
- intent: refund_inquiry
patterns: ["hoàn tiền", "refund", "bao giờ chuyển", "lúc nào nhận tiền"]
tools:
- name: get_order_status
description: "Tra cứu trạng thái đơn hàng theo mã đơn."
endpoint: "https://c