Panduan membaca yang dilokalisasi
writing-skillsTujuan, penggunaan, dan sumber
Gunakan saat membuat keterampilan baru, mengedit keterampilan yang sudah ada, atau memverifikasi fungsi keterampilan sebelum digunakan.
Sumber diambil:
- Repositori sumber
- obra/superpowers
- SKILL.md
skills/writing-skills/SKILL.md- Bintang Repositori
- 309,479
- Pembaruan terakhir repositori
- 2026-10-30
- Klasifikasi Kemampuan
- Alur Kerja Agen
- Waktu pengumpulan terbaru
Lisensi: MIT
Cuplikan alur kerja adalah alat bantu baca, bukan instruksi yang dapat dieksekusi dari Codez. Tidak ada Skill pihak ketiga yang dijalankan untuk menghasilkan halaman ini.
Bagian yang menjelaskan tujuan dan alur kerja di bawah ini merupakan materi dari hulu, yang telah diorganisir dan diterjemahkan untuk dibaca. Bagian ini berbeda dari analisis editorial Codez yang diberi label secara terpisah.
Apa yang dilakukan oleh Skill ini?
Gunakan saat membuat keterampilan baru, mengedit keterampilan yang sudah ada, atau memverifikasi fungsi keterampilan sebelum digunakan.
Bagaimana alur kerja hulu bekerja
Alur Kerja Penemuan
Bagaimana agen masa depan menemukan keahlian Anda: Menemukan masalah ("tesnya tidak stabil") Mencari keahlian (menggunakan grep untuk deskripsi, menelusuri kategori) Menemukan KEAHLIAN (deskripsi cocok)
Jalur hulu · L388 ↗Ringkasan
Keterampilan menulis adalah penerapan Pengembangan Berbasis Pengujian (Test-Driven Development) pada dokumentasi proses. Keterampilan pribadi tersimpan di direktori keterampilan runtime Anda (~/.claude/skills/(tentang Claude Code) — lihatcodex-tools.mdataugemini-tools.mduntuk jalur pada runtime tersebut. Codex, Copilot CLI, dan Gemini CLI juga mengenalinya.~/.agents/skills/Sebagai alias lintas-runtime. Anda menulis kasus uji (skenario tekanan dengan subagen), mengamati kegagalannya (perilaku dasar), menulis keterampilan (dokumentasi), mengamati keberhasilan pengujian (agen mematuhi), dan melakukan refaktor (menutup celah). Prinsip inti: Jika Anda tidak mengamati kegagalan agen tanpa keterampilan tersebut, Anda tidak tahu apakah keterampilan tersebut mengajarkan hal yang benar.
Kapan Harus Mengembangkan Keterampilan?
Teknik ini tidak langsung jelas bagi Anda. Anda akan merujuknya lagi di berbagai proyek. Pola ini berlaku secara luas (tidak spesifik proyek). Orang lain akan mendapat manfaat.
Jalur hulu · L47 ↗skills/
skill-name/
SKILL.md # Main reference (required)
supporting-file.* # Only if neededPersyaratan dan pengaturan
Keterampilan Penegakan Disiplin (rules/requirements)
Contoh: TDD, verifikasi sebelum penyelesaian, perancangan sebelum pengkodean. Pertanyaan akademis: Apakah mereka memahami aturannya?
Jalur hulu · L188 ↗Batasan dan pemeriksaan kualitas
Tidak ada bagian batasan terpisah yang dipilih dari file ini. Ini tidak berarti Keterampilan ini aman untuk setiap input atau lingkungan. Tinjau sumber lengkapnya dan validasi hasil Anda sendiri.
Mulailah dengan uji coba yang aman.
- Periksa host yang didukung dan petunjuk instalasi repositori. Simpan direktori Skill beserta skrip, aset, dan dokumentasi yang dirujuk di dalamnya secara bersamaan;SKILL.mdsendirian dapat menghilangkan dependensi.
- Berikan input sebenarnya, output yang diinginkan, dan kriteria penerimaan kepada agen. Sintaks pemanggilan dan alat yang tersedia bergantung pada host; situs ini tidak mengasumsikan perintah instalasi universal.
- Cobalah alur kerja sumber dalam proyek sementara atau pada salinannya. Tinjau operasi yang mengubah file, layanan jarak jauh, atau sumber daya yang dapat ditagih sebelum mengizinkannya.
- Validasi output terhadap pemeriksaan kualitas sumber dan persyaratan Anda sendiri. Pemicu yang berhasil atau jumlah bintang repositori yang tinggi tidak menjamin hasil yang benar.
Baca selengkapnya di sumber aslinya.
- Ringkasan
- Apa itu Keterampilan?
- Pemetaan TDD untuk Keterampilan
- Kapan Harus Mengembangkan Keterampilan?
- Teknik
- Pola
- Referensi
- Struktur Direktori
- MenulisSKILL.md
- Diagram alur
- Contoh Kode
- Keterampilan Mandiri
- Keterampilan Menggunakan Alat yang Dapat Digunakan Kembali
- Keterampilan dengan Referensi yang Berat
- Hukum Besi (Sama dengan TDD)
- Menguji Semua Jenis Keterampilan
- Keterampilan Penegakan Disiplin (rules/requirements)
- Keterampilan Teknik (panduan cara melakukan)
- Keterampilan Pola (model mental)
- Keterampilan Referensi (documentation/APIs)
- Alasan Umum untuk Melewatkan Tes
- Cocokkan Bentuknya dengan Kegagalannya
- Perlindungan Terhadap Rasionalisasi
- RED-GREEN-REFACTOR untuk Keterampilan
- MERAH: Tulis Tes yang Gagal (Baseline)
- HIJAU: Menulis dengan Keterampilan Minimal
- REFAKTOR: Tutup Celah
- Perumusan Tes Mikro Sebelum Skenario Lengkap
- ❌ Contoh Naratif
- ❌ Pengenceran Multibahasa
Keterampilan Terkait
Terjemahan dan ruang lingkup
Panduan membaca ini memilih bagian-bagian dari teks yang telah disematkan di bagian atas.SKILL.mdTerjemahan ini dibantu. Ini bukan manual lengkap atau klaim kompatibilitas yang telah diuji. Bacalah dokumen asli dan file referensinya sebelum digunakan.
Pendahuluan ini mengacu pada versi yang disematkan di bawah ini; aktivitas repositori saat ini dan waktu pengumpulan ditampilkan secara terpisah.
- Sumber yang disematkan
- Baca teks aslinya ↗
- Sumber diambil
- Komit sumber
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- Sumber SHA-256
8cb3ac68c6d8c4bb46886b998b09af7989643cab8bd0e46ee86dd62e64546bbe