Biến Claude Code Thành Trợ Lý "Đo Ni Đóng Giày": Làm Chủ Workflow Với Custom Commands

Trong thế giới phát triển phần mềm, sự lặp lại chính là "nợ kỹ thuật" của năng suất. Bạn đã bao giờ cảm thấy mệt mỏi khi phải copy-paste cùng một bộ quy chuẩn dự án vào prompt, hay lặp đi lặp lại những câu lệnh thiết lập môi trường nhàm chán? Claude Code không chỉ là một CLI-based AI agent thông thường; nó cung cấp cho bạn khả năng mở rộng vô hạn thông qua Custom Commands (hay còn gọi là Custom Slash Commands). Đây là chìa khóa để bạn ngừng việc "chat" đơn thuần và bắt đầu xây dựng một hệ thống trợ lý hiểu sâu sắc kiến trúc mã nguồn của mình.

1. Custom Commands: Từ vị thế "người dùng" sang "kiến trúc sư" quy trình

Thông thường, chúng ta tương tác với Claude Code qua các lệnh tích hợp sẵn như /model hay /init. Tuy nhiên, sức mạnh thực sự nằm ở những lệnh do chính bạn định nghĩa (Slash Commands).

Hãy tưởng tượng thay vì phải mô tả chi tiết cách bạn muốn viết một UI Component theo chuẩn Atomic Design mỗi khi cần, bạn chỉ cần gõ /component. Khi đó, bạn không đơn thuần là ra lệnh cho AI; bạn đang vận hành một quy trình đã được đóng gói (encapsulated). Từ việc tự động hóa /commit-message, thực hiện /code-review theo checklist riêng, đến việc dựng /feature-spec, Custom Commands giúp chuẩn hóa tiêu chuẩn kỹ thuật trên toàn đội ngũ một cách mượt mà.

2. Cấu trúc tệp Markdown: Đơn giản nhưng đầy uy quyền

Việc tạo Custom Command rất trực quan. Bạn tạo thư mục .claude (nếu chưa có) tại gốc (root) của dự án, sau đó tạo thư mục con commands.

Bất kỳ tệp .md nào nằm trong .claude/commands/ sẽ tự động trở thành một lệnh. Ví dụ: commit-message.md sẽ kích hoạt lệnh /commit-message.

Lưu ý quan trọng:

• Project-scoped (.claude/commands/): Có thể commit vào Git để cả team dùng chung.
• Global (~/.claude/commands/): Áp dụng cho mọi dự án trên máy bạn.

Việc sử dụng định dạng Markdown cho phép bạn cấu trúc "Prompt" một cách chuyên nghiệp với headings, lists và code blocks.

"Về bản chất, một custom command là một bản hướng dẫn chi tiết (detailed prompt) được gửi đến mô hình mỗi khi lệnh được thực thi. Nó có thể chi tiết hoặc đơn giản tùy thuộc hoàn toàn vào ý đồ của chúng ta."

3. Tự động hóa thông minh với Bash và Placeholder Tokens

Một Custom Command không chỉ là văn bản tĩnh. Nó có thể yêu cầu Claude Code thực thi các lệnh terminal để thu thập dữ liệu thực tế.

Ví dụ, với lệnh /commit-message, bạn có thể chỉ định AI chạy:

• git status: Để nhận diện danh sách các tệp đã staged.
• git diff --staged: Để phân tích nội dung thay đổi thực tế.

Pro-tip dành cho kỹ sư: Khi định nghĩa định dạng đầu ra cho AI bằng các placeholder tokens như <emoji> hay <type>, hãy luôn đặt chúng bên trong các khối mã (code blocks) bằng dấu backticks (```). Điều này cực kỳ quan trọng để ngăn parser Markdown hiểu nhầm các dấu ngoặc nhọn. Ngoài ra, Claude Code còn hỗ trợ placeholder động chính thức: $ARGUMENTS (toàn bộ tham số), $1, $2… (rất mạnh khi dùng /commit-message feat: add dark mode).

4. "Allowed Tools" - Bảo mật và Hiệu suất tối đa

Để quy trình không bị ngắt quãng bởi những yêu cầu cấp quyền liên tục (permission prompts), Claude Code sử dụng cơ chế Front Matter ở đầu tệp Markdown.

---
description: create a commit message by analyzing git diffs
allowed-tools: Bash(git status *), Bash(git diff --staged), Bash(git commit *)
---

Dưới góc độ tư duy hệ thống, allowed-tools là một cơ chế cấp quyền theo ngữ cảnh (context-specific permissions). Thay vì cho phép toàn bộ lệnh Bash trong file cấu hình local (điều này tiềm ẩn rủi ro bảo mật), bạn chỉ cho phép các lệnh cụ thể hoạt động trong phạm vi của slash command đó. Điều này tạo ra một trải nghiệm "không ma sát" (frictionless) mà vẫn đảm bảo tính an toàn cho hệ thống.

5. Cơ chế Resume và Ưu tiên UI

Sau khi chỉnh sửa hoặc tạo mới một Custom Command, bạn cần restart phiên làm việc (thoát và chạy lại lệnh claude) để hệ thống nhận diện thay đổi. Lệnh claude -r (hay claude --resume) dùng để tiếp tục session cũ (resume conversation với memory đầy đủ).

Một chi tiết thú vị về UX là các Custom Commands sẽ luôn xuất hiện ở đầu danh sách khi bạn gõ dấu /, tách biệt hoàn toàn với các lệnh hệ thống mặc định, giúp bạn truy cập nhanh nhất vào các công cụ tùy chỉnh của mình.

Kết luận: Chuẩn hóa để bứt phá

Custom Commands không chỉ là những phím tắt (shortcuts). Chúng là phương tiện để chúng ta "đóng gói" trí tuệ tập thể và các tiêu chuẩn kỹ thuật vào một công cụ duy nhất. Khi những tác vụ lặp lại như viết commit message hay kiểm tra quy chuẩn code được tự động hóa, bạn sẽ có nhiều không gian hơn cho những tư duy sáng tạo thực sự.