Slash command tùy chỉnh

Bạn có để ý mình gõ đi gõ lại vài câu giống nhau? “Viết commit message theo quy ước”, “Review đoạn này về bảo mật”, “Giải thích hàm này bằng tiếng Việt”… Slash command tùy chỉnh đóng gói một prompt hay dùng thành một lệnh /tên - gõ một lần là xong.

• ▸Lệnh tùy chỉnh = một file markdown chứa sẵn prompt; gõ /tên để chạy lại nhanh.
• ▸Bên cạnh các lệnh CÓ SẴN (/help, /clear…), bạn tạo lệnh CỦA RIÊNG mình.
• ▸Tên file = tên lệnh: commit.md → /commit.

Tạo file .claude/commands/<tên>.md trong dự án; nội dung file chính là prompt sẽ chạy khi bạn gõ lệnh:

Review đoạn code thay đổi gần đây trong dự án.
Tập trung vào: lỗi tiềm ẩn, bảo mật, và code khó đọc.
Trả lời ngắn gọn bằng tiếng Việt, nêu file + dòng cụ thể.

Giờ gõ /review trong phiên là Claude chạy đúng prompt trên. Đặt ở .claude/commands/ (dự án - commit để cả nhóm dùng) hoặc ~/.claude/commands/ (cá nhân - mọi dự án của bạn).

• ▸Một file .md = một lệnh; nội dung file là prompt sẽ chạy.
• ▸Cấp dự án (.claude/commands/) chia sẻ qua git; cấp cá nhân (~/.claude/commands/) theo bạn.
• ▸Không cần khai báo gì thêm - có file là có lệnh.

Lệnh sẽ mạnh hơn nhiều khi nhận tham số. Dùng $ARGUMENTS - nó được thay bằng những gì bạn gõ sau tên lệnh:

Sửa lỗi sau, giải thích nguyên nhân ngắn gọn rồi vá:
$ARGUMENTS

Gõ /fix nút đăng nhập bị lệch trên mobile → $ARGUMENTS thành “nút đăng nhập bị lệch trên mobile”.

• ▸$ARGUMENTS = toàn bộ phần bạn gõ sau tên lệnh.
• ▸Cần tách riêng: $0 là tham số đầu, $1 là tham số thứ hai (đếm từ 0).
• ▸frontmatter argument-hint: [issue-number] giúp hiện gợi ý khi gõ lệnh.

Một lệnh thật sự lợi hại khi nó tự kéo dữ liệu mới nhất vào. Dòng dạng !`lệnh` được Claude Code chạy trước và thay bằng kết quả; @đường-dẫn chèn nội dung một file:

Các thay đổi đã stage:
!`git diff --staged`

Viết MỘT commit message theo Conventional Commits (vd "feat(...): ..."),
ngắn gọn, mô tả đúng thay đổi ở trên.

Thử ngay: chọn một ví dụ rồi sửa ô “Bạn gõ” để thấy prompt Claude thực sự nhận đổi theo - kể cả lệnh /commit tự nhúng diff:

Sửa GitHub issue 123 theo đúng quy ước code của dự án.
Đọc mô tả issue, viết test trước, rồi mới sửa.

• ▸!`lệnh` chạy bash và nhúng kết quả vào prompt trước khi Claude đọc.
• ▸@đường-dẫn nhúng nội dung file (vd @docs/quy-uoc.md).
• ▸Nhờ vậy lệnh luôn làm việc với trạng thái mới nhất của dự án.

Bên cạnh lệnh của bạn, Claude Code có nhiều lệnh dựng sẵn rất hữu ích - gõ /help để xem tất cả:

Thêm frontmatter (tùy chọn) để lệnh “xịn” hơn:

---
description: Sửa một lỗi được mô tả, giải thích rồi vá
argument-hint: [mô tả lỗi]
allowed-tools: Read, Edit, Bash
---
Sửa lỗi sau, giải thích nguyên nhân ngắn gọn rồi vá:
$ARGUMENTS