Membuat Perintah Slash Kustom di Claude Code — Alur Kerja Anda

Apa itu Perintah Slash Kustom?

Claude Code hadir dengan perintah slash bawaan seperti /help dan /clear, tetapi tahukah Anda bahwa Anda dapat dengan mudah menambahkan perintah Anda sendiri? Perintah slash kustom memungkinkan Anda memanggil prompt yang sering digunakan atau tugas rutin dengan kata kunci singkat, dan menguasainya dapat secara dramatis mempercepat pengembangan harian Anda.

Alih-alih mengetik prompt panjang seperti “Tinjau kode pada cabang saat ini” setiap saat, Anda cukup mengetik /review untuk memicu perilaku yang sama. Bagikan perintah di seluruh tim dan Anda dapat menstandarisasi kriteria tinjauan atau prosedur rilis.

Lokasi dan Format File

Perintah slash kustom adalah file Markdown biasa. Ada dua lokasi penyimpanan:

• Khusus proyek: .claude/commands/<nama-perintah>.md
• Seluruh pengguna: ~/.claude/commands/<nama-perintah>.md

Perintah khusus proyek dapat dimasukkan ke repositori Anda dan dibagikan dengan rekan tim, sementara perintah seluruh pengguna tersedia di semua proyek Anda. Nama file menjadi nama perintah, jadi review.md menjadi /review.

Membuat Perintah Pertama Anda

Mari mulai dengan perintah paling sederhana yang mungkin. Jalankan ini dari root proyek Anda:

mkdir -p .claude/commands
cat > .claude/commands/review.md <<'EOF'
Baca semua perubahan yang saat ini berada di area staging Git dan
tinjau dari perspektif berikut:

- Kemungkinan bug
- Konsistensi penamaan
- Cakupan tes yang hilang
- Masalah keamanan

Jika Anda menemukan masalah, laporkan dengan nama file dan nomor baris.
EOF

Itu saja. Saat Anda mengetik /review di Claude Code, konten file dikirim sebagai prompt.

Menerima Argumen

Untuk membuat perintah lebih berguna, biarkan mereka menerima argumen. Gunakan placeholder $ARGUMENTS di dalam Markdown Anda dan string apa pun yang Anda lewatkan saat pemanggilan akan disisipkan di sana.

# .claude/commands/explain.md

Mohon jelaskan file atau simbol berikut dengan cermat, dengan cara
yang dapat diikuti oleh pemula.

Target: $ARGUMENTS

Penjelasan Anda harus mencakup:
1. Ringkasan satu atau dua kalimat tentang apa yang dilakukan kode
2. Panduan langkah demi langkah melalui baris-baris penting
3. Contoh penggunaan yang realistis
4. Jebakan umum yang harus dihindari

Panggil dengan /explain src/utils/parser.ts. Token $ARGUMENTS diganti dengan src/utils/parser.ts sebelum eksekusi.

Perintah yang Merujuk ke Beberapa File

Selain meneruskan jalur file sebagai argumen, Anda dapat menggunakan sintaks @ di dalam perintah untuk secara eksplisit memuat file tertentu.

# .claude/commands/check-types.md

Setelah membaca @tsconfig.json dan @package.json, temukan semua
kesalahan tipe di seluruh proyek.

Langkah-langkah:
1. Jalankan `npx tsc --noEmit`
2. Kelompokkan kesalahan berdasarkan file
3. Sarankan urutan prioritas perbaikan
4. Urutkan pertama-tama berdasarkan ukuran area yang terdampak

Tampilkan hasilnya sebagai tabel.

Claude secara otomatis membaca tsconfig.json dan package.json sebelum mulai mengerjakan perintah.

Dalam Praktik: Perintah Persiapan Rilis

Berikut contoh yang membungkus alur kerja rilis tipikal ke dalam satu perintah.

# .claude/commands/release.md

Siapkan rilis untuk versi $ARGUMENTS.

Langkah-langkah:
1. Perbarui field `version` di package.json menjadi $ARGUMENTS
2. Tambahkan bagian baru di awal CHANGELOG.md
   - Referensikan git log sejak tag sebelumnya
   - Kategorikan menjadi feat / fix / docs / chore
3. Jalankan `npm run test` dan pastikan semua tes lulus
4. Jalankan `npm run build` dan pastikan tidak ada kesalahan build
5. Ringkas perubahan dan usulkan pesan commit

Penting: Jangan menjalankan `git push` atau `npm publish` sendiri.
Serahkan konfirmasi akhir kepada pengguna.

Mengetik /release 1.4.0 menangani semuanya, dari kenaikan versi hingga menjalankan tes. Demi keamanan, hindari operasi destruktif dan biarkan manusia mengonfirmasi langkah terakhir.

Mensimulasikan Flag dan Opsi

Anda dapat menjelaskan logika percabangan dalam Markdown untuk mensimulasikan flag.

# .claude/commands/test.md

Argumen: $ARGUMENTS

Ikuti aturan ini:

- Jika argumen kosong: jalankan semua tes
- Jika argumen berisi `--unit`: jalankan hanya tes unit
- Jika argumen berisi `--e2e`: jalankan hanya tes E2E
- Jika jalur file disertakan: jalankan hanya tes yang terkait dengan file tersebut

Setelah menjalankan, analisis penyebab tes yang gagal.

Panggilan seperti /test --unit atau /test src/auth.ts menjadi mungkin.

Praktik Terbaik untuk Berbagi Tim

Letakkan perintah khusus proyek di bawah .claude/commands/ dan kelola dengan Git sehingga setiap anggota tim menggunakan perintah yang sama. Perhatikan hal-hal berikut:

• Gunakan konvensi penamaan yang konsisten: kata kerja dulu, nama pendek (review, fix, explain)
• Dokumentasikan di README: buat perintah mudah ditemukan
• Hindari operasi destruktif: larang secara eksplisit hal-hal seperti git push --force atau rm -rf
• Tentukan format output: jaga konsistensi hasil tinjauan dengan tabel atau daftar periksa

Kesimpulan

Perintah slash kustom adalah jalur terpendek untuk mengubah Claude Code menjadi “asisten AI pribadi Anda sendiri”. Mulailah dengan satu atau dua perintah sederhana dan tambahkan lebih banyak setiap kali Anda menemukan tugas yang berulang. Sebelum lama, mereka akan menjadi bagian yang sangat diperlukan dari alur kerja Anda.

Untuk dasar-dasar Claude Code, lihat panduan memulai. Untuk otomatisasi yang lebih canggih, lihat Memulai dengan Agent SDK, dan untuk tips tentang konteks, lihat Manajemen Konteks.

Untuk dokumentasi resmi, rujuk ke dokumentasi Anthropic.