Analisis Seleksi Asli CODEZ / 02
Cara memilih Skill alur kerja Superpowers: kebutuhan, penerimaan, dan penulisan Skill
Dalam kategori "Alur Kerja Agen" yang sama, Skill dapat melayani tahapan yang sepenuhnya berbeda. Sebelum melakukan pemilihan, tentukan terlebih dahulu apakah Anda kekurangan persyaratan yang jelas, hasil yang dapat diverifikasi, atau deskripsi proses yang dapat digunakan kembali. Artikel ini menggunakan tiga sumber dunia nyata untuk mengilustrasikan cara memilih Skill berdasarkan tugas.
Verifikasi data:
Fakta proyek berasal dari SKILL.md asli pada commit tetap. Saran pemilihan, penilaian biaya, dan rancangan skenario merupakan analisis editor CODEZ. Skill pihak ketiga ini belum dijalankan untuk artikel ini. Skenario dan catatan uji coba adalah contoh, tanpa tingkat keberhasilan terukur atau peringkat kinerja.
Pilih berdasarkan output yang dibutuhkan terlebih dahulu.
Ketiga entri berasal dari obra/superpowers dan menampilkan jumlah Star repositori yang sama. Star tidak menentukan pilihan di antara ketiganya; kondisi pemicu dan hasil yang dihasilkan lebih membedakan.
Pendekatan kami adalah pertama-tama mengidentifikasi celah dalam tugas: ketika masih ada ambiguitas utama dalam persyaratan, kita perlu menyelaraskan maksudnya; ketika mempersiapkan pengiriman, kita perlu memverifikasi buktinya; ketika mempersiapkan untuk menulis pengalaman ke dalam kemampuan agar agen dapat menggunakannya kembali, kita perlu memeriksa apakah instruksi tersebut benar-benar mengubah perilaku.
| Apa yang dibutuhkan saat ini | Skill Kandidat | Hasil yang diharapkan | Biaya proses harus ditanggung |
|---|---|---|---|
| Klarifikasi tujuan, ruang lingkup, dan desain. | brainstorming | Pemahaman yang dapat diverifikasi pengguna tentang persyaratan dan dasar desain. | Diskusi dan konfirmasi harus sesuai dengan kompleksitas tugas. |
| Membuktikan pekerjaan selesai atau masalah diperbaiki | verification-before-completion | Perintah verifikasi, hasil, dan batasan yang sesuai dengan perubahan terkini. | Jalankan pengecekan dan baca output lengkapnya. |
| Menciptakan atau meningkatkan Skill yang dapat digunakan kembali. | writing-skills | Catatan verifikasi instruksi dan skenario yang dapat dipelihara. | Merancang skenario, mengamati data dasar, merevisi, dan meninjau. |
Kebutuhan belum jelas: periksa brainstorming
Teks aslinya berkisar pada pengorganisasian kolaborasi berdasarkan tujuan, konteks, persyaratan, dan validasi desain, serta membedakan tugas-tugas dengan kompleksitas yang berbeda. Teks ini dikategorikan dalam alur kerja Agen karena langkah-langkah ini menentukan bagaimana pekerjaan berlangsung dan validasi dicapai; namun, penerapannya perlu ditentukan dengan merujuk kembali ke teks aslinya.
Salah satu tanda yang baik untuk diperiksa pertama kali adalah ketika Anda dapat mendeskripsikan produk yang ingin Anda buat, tetapi Anda belum dapat menentukan pengguna, kriteria keberhasilan, atau ruang lingkup operasinya. Mulailah dengan catatan pemahaman singkat, periksa setiap item terhadap persyaratan Anda dan mana yang merupakan asumsi dari calon kandidat potensial.
Jika tugas tersebut sudah memberikan masukan, keluaran, dan kriteria penerimaan yang jelas, amati apakah tugas tersebut memanfaatkan informasi yang sudah ada dan apakah diskusi baru dapat menyelesaikan ambiguitas yang sebenarnya. Jangan menggunakan "mengajukan lebih banyak pertanyaan" sebagai standar kualitas.
Siap menyerahkan hasil: periksa verification-before-completion
Dokumen asli mensyaratkan identifikasi metode verifikasi, menjalankan pemeriksaan, dan memverifikasi keluaran lengkap sebelum pekerjaan yang dinyatakan selesai. Hal ini membatasi penilaian pengiriman, alih-alih menyediakan alat pengujian khusus proyek.
Saat melakukan pengujian, pertama-tama buatlah daftar kesimpulan yang ingin Anda buktikan, lalu tuliskan pengecekan yang sesuai. Misalnya, "Output CSV memiliki empat kolom yang ditentukan" dapat diperiksa dengan memeriksa nama kolom; "Seluruh sistem tidak memiliki masalah" biasanya tidak dapat dibuktikan hanya dengan satu pengecekan parsial.
Satu pemeriksaan kode yang lulus tidak otomatis membuktikan bahwa fungsi, deployment, dan alur pengguna nyata sudah benar. Kesimpulan harus memiliki bukti yang sesuai; nyatakan bagian yang belum tercakup.
verification-before-completion: file sumber pada commit tetap ↗
Memelihara Skill sendiri: periksa writing-skills
Teks aslinya membahas pembuatan dan pengeditan Skill, serta menghubungkan validasi deskripsi proses dengan pengujian skenario, termasuk mengamati perilaku tanpa deskripsi dan perubahan setelah revisi. Fokus di sini adalah pada kemampuan Agen yang dapat digunakan kembali.
Proses ini bermanfaat ketika jenis tugas yang sama terjadi berulang kali, dan spesifikasi yang ada masih menghasilkan penyimpangan yang dapat dijelaskan. Menuliskan penyimpangan spesifik dan metode penerimaan sebelumnya membuat verifikasi lebih mudah daripada sekadar memperluas sejumlah besar aturan.
Verifikasi skenario meningkatkan waktu dan biaya operasional, dan metode eksekusi yang didukung oleh klien mungkin juga berbeda. Untuk tugas yang hanya perlu diselesaikan sekali, pertama-tama tentukan apakah benar-benar perlu mempertahankan Skill baru; validitas format dan validitas perilaku diperiksa secara terpisah.
Contoh skenario: Memperbaiki kesalahan validasi input
Berikut contoh pemilihan yang dirancang editor, bukan laporan penggunaan ketiga Skill. Anggap input untuk mereproduksi masalah, pesan kesalahan yang diharapkan, dan perintah pemeriksaan regresi sudah jelas, lalu lakukan perbaikan dengan cakupan yang terdefinisi.
Dalam skenario ini, pemeriksaan bukti sebelum penyerahan adalah kebutuhan langsung. Jika kondisi reproduksi atau perilaku kesalahan masih ambigu, tambahkan alur klarifikasi kebutuhan. Jika tim berulang kali melewatkan pemeriksaan yang sama dan ingin memeliharanya sebagai Skill yang dapat digunakan kembali, pertimbangkan alur penulisan Skill.
Pemilihan ini didasarkan pada tahapan dan hasil, bukan pada penggunaan semua alur kerja dalam repositori untuk setiap tugas secara bersamaan. Saat menggabungkan beberapa kandidat, kondisi pemicu, langkah persetujuan, dan cakupan operasionalnya juga harus diperiksa untuk menghindari konflik.
Gunakan tabel catatan untuk menilai kecocokan Skill dengan lingkungan Anda
Bandingkan kandidat dengan masukan dan kriteria penerimaan yang sama, lalu catat klien, commit repositori, dan jalur berkas yang digunakan. Sampai uji coba nyata selesai, gunakan kesimpulan dari sumber publik hanya untuk memilih kandidat.
| Item Catatan | Isi kontennya |
|---|---|
| Tugas dan Masukan | Apa yang perlu diklarifikasi, divalidasi, atau ditulis ulang; pertahankan masukan yang sama. |
| Klien dan Versi | Klien agen, alat-alat yang diperlukan, dan lingkungan eksekusi. |
| Sumber Kandidat | Repositori, commit tetap, dan jalur SKILL.md |
| Hasil yang diharapkan | Pemahaman kebutuhan, catatan bukti, atau instruksi dan skenario |
| Hasil aktual | Output sebenarnya, perintah, dan kesalahan setelah penyelesaian. |
| Biaya dan keterbatasan | Pembahasan tambahan, prosedur operasional, dan area yang tidak dibahas. |