Panduan membaca yang dilokalisasi
writing-plansTujuan, penggunaan, dan sumber
Gunakan saat Anda memiliki spesifikasi atau persyaratan untuk tugas multi-langkah, sebelum menyentuh kode.
Sumber diambil:
- Repositori sumber
- obra/superpowers
- SKILL.md
skills/writing-plans/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 Anda memiliki spesifikasi atau persyaratan untuk tugas multi-langkah, sebelum menyentuh kode.
Bagaimana alur kerja hulu bekerja
Ringkasan
Tulis rencana implementasi untuk seorang insinyur yang belum pernah melihat basis kode atau spesifikasi ini. Asumsikan mereka akan menulis kode yang sesuai dengan gaya bahasa proyek setelah mengetahui antarmuka dan pengujian yang tepat, dan bahwa mereka akan membuat pilihan yang masuk akal di mana pun rencana tersebut menyisakan satu pilihan terbuka. Yang tidak dapat mereka ketahui adalah apa yang telah Anda putuskan: file mana, nama dan tanda tangan mana, nilai mana dari spesifikasi, pengujian mana yang membuktikan setiap tugas. Dokumentasikan hal-hal tersebut. Berikan seluruh rencana kepada mereka sebagai tugas-tugas kecil. DRY (Don't Repeat Yourself). YAGNI (You Ain't Gonna Need It). TDD (Test-Driven Development). Komitmen yang sering. Umumkan di awal: "Saya menggunakan keterampilan menulis rencana untuk membuat rencana implementasi." Konteks: Jika bekerja dalam worktree yang terisolasi, seharusnya sudah dibuat melaluisuperpowers:using-git-worktreesKeahlian dalam waktu eksekusi. Simpan rencana ke:docs/superpowers/plans/YYYY-MM-DD-.md
Granularitas Langkah
Setiap langkah merupakan satu tindakan dengan hasil yang dapat diperiksa: "Tulis tes yang gagal" - langkah "Jalankan untuk memastikan tes tersebut gagal" - langkah "Implementasikan kode minimal agar tes berhasil" - langkah
Jalur hulu · L43 ↗Apa yang Terkandung dalam Sebuah Langkah
Suatu langkah dianggap selesai ketika implementor dapat menulis tepat satu hal yang masuk akal darinya. Itulah seluruh persyaratannya: tidak ambigu, bukan lengkap. Setiap jenis langkah membawa apa yang membuatnya tidak ambigu dan tidak lebih: Langkah pengujian: nama pengujian dan pernyataannya, sebagai kode, dengan nilai-nilai spesifikasi yang tepat di dalamnya. Langkah kode: tanda tangan yang tepat (nama, parameter, tipe pengembalian), file tempatnya berada, dan nilai-nilai spesifik yang ditetapkan spesifikasi. Implementor menulis isi (body). Isi hanya muncul untuk algoritma yang tidak ditentukan oleh tanda tangan dan pengujian, atau untuk salinan persis yang ditetapkan spesifikasi. Langkah verifikasi: perintah untuk menjalankan dan output yang berarti berhasil.
Jalur hulu · L140 ↗Persyaratan dan pengaturan
Tidak ada bagian persyaratan singkat yang dipilih dari file ini. Ini tidak berarti Skill tersebut tidak memiliki dependensi. Periksa petunjuk pengaturan repositori dan file yang dirujuk.
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.
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
a6c67c1900064347c2a329990dd3c555657c51c3ec53b259a08aa01a2c26139a