Perintah Tersuai berbanding Kemahiran

Kemahiran berada dalam .claude/skills/ dan merupakan pengganti semasa yang lebih lengkap untuk perintah. Selain kandungan gesaan, kemahiran menyokong frontmatter yang mengawal cara ia dilaksanakan. Tiga medan penting untuk peperiksaan ialah:

• context: fork — jalankan kemahiran dalam konteks terpencil supaya output terperincinya tidak mencemarkan perbualan utama.
• allowed-tools — hadkan alat yang boleh dipanggil oleh kemahiran (keistimewaan minimum).
• argument-hint — dokumentasikan argumen yang dijangka diterima oleh kemahiran.

Kawalan inilah yang tiada pada perintah legasi.

Berikut ialah kemahiran yang menjalankan semakan kod. Frontmatter dibatasi oleh ---; kandungan di bawahnya ialah arahan yang diikuti oleh Claude apabila kemahiran dipanggil.

Perhatikan bahawa context: fork mengasingkan output penemuan semakan, allowed-tools mengehadkannya kepada alat membaca dan mencari (tiada Write, tiada Bash), manakala argument-hint memberitahu pengguna perkara yang perlu dihantar.

Kemahiran sering menghasilkan banyak gangguan perantaraan: longgokan fail, hasil carian, dan langkah penerokaan. Jika semuanya masuk ke dalam perbualan utama, ruang konteks menjadi sesak dan mencetuskan fenomena kehilangan di tengah, apabila model kurang memberi perhatian kepada kandungan yang terselit antara permulaan dan pengakhiran.

context: fork menjalankan kemahiran dalam konteks terpencil, seperti ejen bawahan penerokaan semasa penemuan. Kerja terperinci berlaku di tempat lain dan hanya hasil yang diringkaskan dikembalikan. Ini memastikan sesi utama kekal ringkas dan perhatian anda tertumpu pada perkara yang penting.

Medan allowed-tools mengehadkan kemahiran kepada alat yang benar-benar diperlukan sahaja. Kemahiran semakan sepatutnya membaca dan mencari, tetapi tidak pernah menulis atau menjalankan perintah shell; mengehadkannya sedemikian menghapuskan seluruh kelas pengubahsuaian tidak sengaja.

Ini selaras dengan reka bentuk ejen berkeistimewaan minimum di bahagian lain dalam pensijilan: hadkan alat mengikut peranan, dan ingat bahawa 4–5 alat ialah titik optimum, manakala 18+ alat merosotkan kebolehpercayaan pemilihan. Kemahiran yang terfokus dan mempunyai skop yang baik adalah lebih selamat serta lebih boleh dipercayai.

Tanpa bergantung pada perintah berbanding kemahiran, setiap perintah atau kemahiran mempunyai skop yang ditentukan oleh lokasi failnya:

• Skop projek: .claude/commands/ atau .claude/skills/ di dalam repositori. Dikomitkan ke VCS, jadi seluruh pasukan mendapatnya secara automatik.
• Skop pengguna: folder yang sama di bawah ~/.claude/. Peribadi pada mesin anda, TIDAK dikongsi melalui VCS.

Ini ialah perbezaan projek berbanding pengguna yang sama seperti hierarki CLAUDE.md dan .mcp.json berbanding ~/.claude.json. Peraturannya konsisten merentas konfigurasi Claude Code.

Gunakan skop projek apabila aliran kerja perlu menjadi piawaian untuk semua orang yang mengendalikan repositori. Kemahiran /review-pr yang dikongsi bermakna setiap jurutera menyemak perbezaan dengan cara yang sama; kemahiran /migrate yang dikongsi mengekodkan peraturan pemindahan anda sekali sahaja.

Oleh sebab ia dikomitkan ke VCS, rakan sepasukan baharu yang mengklon repositori akan mendapatnya serta-merta tanpa sebarang persediaan. Jika anda terfikir, "pasukan perlu melakukan ini dengan cara yang sama," jawapannya ialah skop projek.

Gunakan skop pengguna (~/.claude/) untuk kemudahan peribadi yang bukan sebahagian daripada perjanjian pasukan: pembantu sementara anda sendiri, perintah peribadi untuk mencatat nota, atau pintasan yang terikat pada persediaan setempat anda.

Tolak ansurnya sama seperti CLAUDE.md pada peringkat pengguna: ia mengikuti anda merentas semua projek tetapi TIDAK dikongsi melalui VCS, jadi rakan sepasukan tidak akan melihatnya. Jika aliran kerja perlu boleh dihasilkan semula untuk seluruh pasukan, skop pengguna ialah pilihan yang salah kerana ia tidak kelihatan kepada orang lain.

Mekanisme dan skop adalah bebas antara satu sama lain, jadi anda mempunyai grid penuh untuk dijadikan asas reka bentuk:

• Kemahiran projek — dikongsi, semasa, dengan kawalan fork/allowed-tools. Pilihan lalai untuk aliran kerja pasukan.
• Kemahiran pengguna — peribadi, semasa, dan masih mendapat frontmatter lengkap.
• Perintah projek — dikongsi tetapi legasi; sesuai jika sudah wujud, tetapi pindahkan apabila anda memerlukan pengasingan atau pengehadkan alat.
• Perintah pengguna — peribadi dan legasi.

Untuk apa-apa yang baharu dan ditujukan kepada pasukan, pilihan lalai yang kukuh ialah kemahiran berskop projek.

Pemindahan biasanya bersifat mekanikal: alihkan fail daripada .claude/commands/ ke .claude/skills/, kemudian tambahkan frontmatter untuk memperoleh kawalan yang tiada sebelum ini. Gesaan biasa menjadi aliran kerja yang ditadbir.

Manfaatnya nyata: context: fork menghalang output semakan terperinci daripada mencemarkan sesi anda, manakala allowed-tools memastikan kemahiran tidak boleh menulis atau menjalankan perintah shell. Niatnya sama, tetapi kini terpencil dan berskop.

Perkara utama:

• Dua mekanisme: .claude/commands/ ialah legasi, manakala .claude/skills/ ialah semasa. Utamakan kemahiran untuk kerja baharu.
• Kemahiran menambahkan perkara yang tiada pada perintah melalui frontmatter: context: fork (mengasingkan output terperinci), allowed-tools (mengehadkan alat, keistimewaan minimum), argument-hint (mendokumentasikan argumen).
• Dua skop: projek (.claude/, dikongsi melalui VCS) berbanding pengguna (~/.claude/, peribadi, TIDAK dikongsi) — paksi yang sama seperti konfigurasi CLAUDE.md dan MCP.
• Aliran kerja pasukan yang mesti boleh dihasilkan semula → kemahiran berskop projek. Kemudahan peribadi → skop pengguna.
• Pindahkan perintah kepada kemahiran dengan mengalihkan fail dan menambahkan frontmatter; jangan sekali-kali menggantikan sekatan allowed-tools yang deterministik dengan nota prosa dalam CLAUDE.md.