LemonData logoLemonData

Pengaturan

Bahasa
Blog

Kemampuan Kode Claude: Bangun Alur Kerja Kustom untuk Asisten Pengkodean AI Anda

L
LemonData
·26 Februari 2026·73 tampilan
#Claude Code#keahlian#alat pengembang#tutorial#produktivitas
Kemampuan Kode Claude: Bangun Alur Kerja Kustom untuk Asisten Pengkodean AI Anda

Keahlian Claude Code: Bangun Alur Kerja Kustom untuk Asisten Kode AI Anda

Claude Code hadir dengan asisten AI serbaguna. Keahlian memungkinkan Anda mengkhususkannya. Keahlian adalah file markdown yang mengajarkan Claude Code cara menangani jenis tugas tertentu: deploy ke Kubernetes, menulis migrasi database, meninjau pull request, atau mengikuti konvensi pengkodean tim Anda.

Perbedaan antara "tuliskan komponen React untuk saya" dan "tuliskan komponen React yang mengikuti sistem desain kami, menggunakan custom hooks kami, dengan batasan error dan atribut aksesibilitas yang tepat" adalah sebuah keahlian.

Apa Itu Keahlian Sebenarnya

Keahlian adalah file markdown di .claude/commands/ (tingkat proyek) atau ~/.claude/commands/ (global). Saat Anda mengetik /skill-name di Claude Code, isi file tersebut disuntikkan ke dalam percakapan sebagai instruksi.

.claude/
  commands/
    deploy.md          # /deploy
    review-pr.md       # /review-pr
    write-test.md      # /write-test

Itu saja. Tidak ada sintaks khusus, tidak perlu kompilasi, tidak perlu SDK. Hanya markdown yang menjelaskan cara melakukan sesuatu.

Menulis Keahlian Pertama Anda

Berikut contoh praktis: keahlian yang menegakkan konvensi pesan commit tim Anda.

Buat .claude/commands/commit.md:

# Alur Kerja Commit

## Langkah-langkah
1. Jalankan `git diff --staged` untuk melihat apa yang akan di-commit
2. Analisis perubahan dan kategorikan: feat, fix, refactor, docs, test, chore
3. Tulis pesan commit sesuai konvensi kami:
   - Format: `type(scope): description`
   - Scope adalah nama paket atau modul
   - Deskripsi menggunakan bentuk imperatif, huruf kecil, tanpa titik
   - Body menjelaskan MENGAPA, bukan APA
4. Jika perubahan menyentuh beberapa scope, buat commit terpisah
5. Jalankan `git commit -m "message"` dengan pesan yang dihasilkan

## Aturan
- Jangan pernah gunakan `--no-verify` untuk melewati hooks
- Jangan pernah mengubah commit yang sudah dipublikasikan
- Jika tes gagal di pre-commit, perbaiki masalah terlebih dahulu

## Contoh
- `feat(billing): add stripe webhook handler`
- `fix(auth): handle expired refresh tokens`
- `refactor(api): extract rate limiter to shared package`

Sekarang /commit memberikan Claude Code alur kerja terstruktur daripada instruksi samar "commit perubahan saya".

Polanya Desain Keahlian

Polanya Checklist

Terbaik untuk tugas dengan beberapa langkah verifikasi.

# Daftar Periksa Pra-Deploy

Sebelum deploy, verifikasi setiap item:

- [ ] `pnpm typecheck` berhasil
- [ ] `pnpm test` berhasil
- [ ] Tidak ada pernyataan console.log di kode produksi
- [ ] Variabel lingkungan didokumentasikan di .env.example
- [ ] Migrasi database dapat dibalik
- [ ] Perubahan API kompatibel ke belakang

Jika ada pemeriksaan gagal, hentikan dan laporkan masalah. Jangan lanjutkan deploy.

Polanya Pohon Keputusan

Terbaik untuk tugas yang pendekatannya tergantung konteks.

# Alur Kerja Perbaikan Bug

1. Reproduksi bug (temukan atau tulis tes yang gagal)
2. Identifikasi penyebab utama:
   - Jika itu error tipe → perbaiki definisi tipe di sumbernya
   - Jika itu race condition → tambahkan penguncian/penyusunan yang tepat
   - Jika itu validasi yang hilang → tambahkan validasi skema di batas
   - Jika itu error logika → perbaiki dan tambahkan tes regresi
3. Verifikasi perbaikan tidak merusak tes yang ada
4. Tulis tes yang seharusnya menangkap bug ini

Polanya Template

Terbaik untuk menghasilkan output yang konsisten.

# Endpoint API Baru

Buat endpoint API baru sesuai konvensi kami:

## Struktur File
- Route handler: `apps/api/src/routes/{resource}/{action}.ts`
- Skema: `apps/api/src/schemas/{resource}.ts`
- Tes: `apps/api/src/routes/{resource}/__tests__/{action}.test.ts`

## Elemen Wajib
- Skema Zod untuk validasi request
- Middleware otentikasi
- Pembatasan rate
- Respon error terstruktur menggunakan errorResponse()
- Respon sukses menggunakan successResponse()
- Komentar dokumentasi OpenAPI

Memasang Keahlian Komunitas

Ekosistem Claude Code memiliki perpustakaan keahlian komunitas yang terus berkembang. Pasang dengan:

npx add-skill username/repo-name -y

Koleksi keahlian populer:

  • coreyhaines31/marketingskills (29 keahlian marketing/SEO)
  • hedging8563/lemondata-api-skill (integrasi API LemonData)

Keahlian yang terpasang muncul di ~/.claude/commands/ dan bekerja di semua proyek.

Keahlian Proyek vs Global

Lokasi Lingkup Kasus Penggunaan
.claude/commands/ Hanya proyek ini Konvensi proyek, alur deploy
~/.claude/commands/ Semua proyek Preferensi pribadi, alat umum

Keahlian proyek harus di-commit ke repo Anda agar seluruh tim mendapat manfaat. Keahlian global untuk preferensi alur kerja pribadi.

Lanjutan: Keahlian dengan Hooks

Keahlian dapat merujuk ke hooks (perintah shell yang berjalan pada event tertentu) untuk penegakan otomatis:

# Pemeriksaan Pra-Commit

Sebelum commit apa pun, hooks berikut berjalan otomatis:
- `pre-commit`: menjalankan typecheck + lint
- `post-commit`: memperbarui changelog

Jika hook gagal, periksa output error dan perbaiki masalah.
Jangan gunakan --no-verify untuk melewati hooks.

Hooks itu sendiri dikonfigurasi di .claude/settings.json:

{
  "hooks": {
    "pre-commit": "pnpm typecheck && pnpm lint-staged"
  }
}

Tips untuk Keahlian yang Efektif

  1. Jadilah spesifik tentang jalur file dan konvensi penamaan. "Buat komponen" terlalu umum. "Buat komponen di src/components/ui/ menggunakan penamaan PascalCase" lebih bisa ditindaklanjuti.

  2. Sertakan contoh output yang benar. Claude Code belajar lebih baik dari contoh daripada aturan abstrak.

  3. Tentukan apa yang TIDAK boleh dilakukan. "Jangan pernah gunakan tipe any" lebih mudah ditegakkan daripada "gunakan tipe yang tepat."

  4. Fokuskan keahlian. Satu keahlian per alur kerja. Keahlian 200 baris yang mencakup segalanya kurang berguna dibanding lima keahlian 40 baris yang masing-masing menangani satu tugas dengan baik.

  5. Versikan keahlian Anda. Saat konvensi berkembang, perbarui keahlian. Keahlian usang lebih buruk daripada tidak ada keahlian karena menegakkan pola lama.

Dampak di Dunia Nyata

Tim yang mengadopsi keahlian melaporkan peningkatan konsisten:

  • Siklus review kode berkurang karena konvensi ditegakkan sebelum review
  • Waktu onboarding berkurang karena pengembang baru mendapat panduan yang sama dengan veteran
  • Kualitas kode yang dihasilkan AI meningkat karena AI memiliki konteks eksplisit tentang standar proyek

Investasinya kecil (30 menit untuk menulis beberapa keahlian pertama Anda) dan hasilnya bertambah dengan setiap interaksi.

Bangun dengan AI, dipandu oleh aturan Anda sendiri. lemondata.cc menyediakan infrastruktur API untuk alat pengembangan bertenaga AI.

Share: