Slash Command và Skill tùy chỉnh

Những điều bạn cần biết

Custom command và skill đã được hợp nhất thành một hệ thống thống nhất: hệ thống Skills. Các file đặt tại .claude/skills/ hoặc .claude/commands/ đều tạo ra cùng một /command hoạt động y hệt nhau. Đường dẫn .claude/skills/ là vị trí chuẩn (canonical); .claude/commands/ là một alias tương thích ngược.

Hệ thống Skills thống nhất

Cả hai đường dẫn đều cho ra cùng một kết quả — một /command mà developer có thể gọi:

• .claude/commands/deploy.md tạo ra /deploy
• .claude/skills/deploy/SKILL.md cũng tạo ra /deploy

Đường dẫn skills là đường dẫn được khuyến nghị vì nó bổ sung các tính năng mà alias commands không có: một thư mục file hỗ trợ đi kèm SKILL.md, cơ chế tự động phát hiện để Claude có thể nạp một skill khi nó khớp với ý định của bạn, và quyền ưu tiên khi một skill và một command trùng tên (skill thắng). Cả hai đường dẫn đều hỗ trợ cùng frontmatter YAML (context: fork, allowed-tools, argument-hint) và đều tạo ra cùng một /command, nên các file .claude/commands/ hiện có vẫn hoạt động bình thường, không thay đổi.

Hai cấp độ phạm vi

Phạm vi dự án (chia sẻ qua git):

Đặt skill trong .claude/skills/ (chuẩn) hoặc .claude/commands/ (alias) bên trong repository của bạn. Cả hai đều được quản lý bằng git và chia sẻ qua git. Mọi developer clone hoặc pull repository đều tự động nhận các command này. Dùng cho các workflow chung của cả nhóm: /review, /deploy-check, /lint, /migration-guide.

markdownCopy

<!-- .claude/commands/review.md — tạo ra /review -->
Review the staged changes against our team checklist:
1. Check error handling patterns
2. Verify test coverage for new functions
3. Confirm API naming conventions
4. Flag any hardcoded credentials or secrets

Phạm vi người dùng (cá nhân):

Đặt skill trong ~/.claude/skills/ (chuẩn) hoặc ~/.claude/commands/ (alias). Đây là các skill cá nhân, không được quản lý hay chia sẻ. Dùng cho các workflow năng suất cá nhân mà các thành viên khác trong nhóm không cần đến.

Frontmatter của Skills: cấu hình tùy chọn

Các skill trong .claude/skills/ với file SKILL.md hỗ trợ cấu hình frontmatter YAML tùy chọn. Frontmatter này cũng hoạt động với các file .claude/commands/, nhưng .claude/skills/ là vị trí chuẩn cho các skill có cấu hình. Skills là các workflow theo tác vụ cụ thể, được gọi khi cần — chúng không tự động nạp như CLAUDE.md.

Ba tùy chọn frontmatter quan trọng nhất:

context: fork

Chạy skill trong một context sub-agent cô lập. Toàn bộ output chi tiết được giữ trong nhánh fork đó. Cuộc hội thoại chính vẫn sạch sẽ, không bị lộn xộn. Điều này thiết yếu cho:

• Phân tích codebase (tạo ra danh sách file và trích đoạn code rất dài)
• Brainstorm (tạo ra nhiều phương án và đánh giá)
• Bất kỳ tác vụ nào tạo ra output ồn ào, mang tính khám phá

Không có context: fork, output của skill chảy vào cuộc hội thoại chính và tiêu tốn token của context window. Với các skill dài dòng, điều này làm giảm chất lượng các phản hồi tiếp theo.

Frontmatter nằm ở đầu file SKILL.md của skill. Với một skill được gọi bằng /analyse-feature, file đó nằm tại .claude/skills/analyse-feature/SKILL.md:

yamlCopy

---
context: fork
allowed-tools:
  - Read
  - Grep
  - Glob
argument-hint: "Provide a feature description or area of the codebase to analyse"
---

allowed-tools

Phê duyệt trước các tool được liệt kê để Claude có thể dùng mà không cần nhắc xin quyền trong khi skill đang chạy. Nó không hạn chế những tool nào khả dụng: mọi tool khác vẫn có thể gọi bình thường, và các cài đặt quyền thông thường của bạn vẫn chi phối những gì không nằm trong danh sách. Dùng nó để cho phép một workflow đáng tin cậy chạy mà không phải dừng lại xin phép ở mỗi lần gọi.

yamlCopy

---
allowed-tools:
  - Read
  - Grep
  - Glob
---

Để loại bỏ tool khỏi bộ công cụ mà Claude có thể dùng trong khi skill chạy — đây mới thực sự là ranh giới bảo mật — hãy liệt kê chúng trong disallowed-tools, hoặc thêm quy tắc deny trong cài đặt quyền của bạn.

argument-hint

Nhắc developer nhập các tham số bắt buộc khi skill được gọi mà không có đối số. Cải thiện trải nghiệm developer bằng cách làm rõ đầu vào cần thiết thay vì trông chờ developer nhớ skill cần gì.

yamlCopy

---
argument-hint: "Specify the module path to analyse (e.g., src/api/auth)"
---

Skills so với CLAUDE.md: sự khác biệt then chốt

Sự khác biệt này được kiểm tra trực tiếp trong đề thi:

• Skills = workflow theo tác vụ cụ thể, được gọi khi cần. Phần mô tả của chúng luôn nằm trong context để Claude biết chúng tồn tại, nhưng toàn bộ nội dung skill chỉ nạp khi được gọi. Việc gọi có thể tường minh (/skill-name) hoặc tự động: Claude chọn các skill có description khớp với ý định của người dùng, hoặc các skill có trường frontmatter paths khi bạn đang làm việc trên các file khớp. Các skill có disable-model-invocation: true bắt buộc phải được người dùng gọi tường minh.
• CLAUDE.md = chuẩn phổ quát, luôn được nạp. Tự động áp dụng cho mọi phiên, không cần bước gọi nào.

Quy tắc: đừng đặt các quy trình theo tác vụ cụ thể vào CLAUDE.md. Đừng đặt tài liệu tham chiếu luôn-bật vào skill.

Các quy ước đặt tên API phải áp dụng cho mọi tác vụ sinh code thuộc về CLAUDE.md (hoặc .claude/rules/). Một workflow phân tích codebase nhiều bước mà developer thỉnh thoảng mới chạy thuộc về một skill. Với các quy ước áp dụng cho một loại file cụ thể — như file test — .claude/rules/ theo phạm vi đường dẫn là lựa chọn phù hợp nhất vì chúng nạp như context luôn-bật cùng các file khớp.

Tùy chỉnh Skill cá nhân

Tạo các biến thể cá nhân trong ~/.claude/skills/ (hoặc ~/.claude/commands/) với tên khác để không ảnh hưởng đến đồng đội. Nếu nhóm có một skill /analyse chuẩn nhưng bạn muốn một phiên bản chi tiết hơn, hãy tạo skill của riêng bạn trong ~/.claude/skills/ với tên khác (ví dụ, /deep-analyse). Skill cá nhân của bạn không ghi đè hay xung đột với phiên bản của nhóm.

Đặt custom command ở đâu: tra cứu nhanh

Bẫy thi

Tình huống luyện tập

Không tìm thấy câu hỏi luyện tập "q-3-2-001".

Bài tập thực hành

Nguồn tham khảo

• Claude Code Skills Documentation (custom slash commands are part of the unified Skills system) — Anthropic
• Claude Certified Architect Foundations Exam Guide — Task Statement 3.2 — Anthropic