Panduan Asli CODEZ / 01
Cara Memilih Agent Skills: Dari Peringkat Bintang hingga Uji Coba Sebenarnya
Daftar dapat membantu mempersempit pencarian Anda. Pemilihan sebenarnya bergantung pada apakah suatu Skill dapat menyelesaikan tugas spesifik di lingkungan Anda. Panduan ini menyediakan metode penyaringan yang dapat digunakan kembali.
Verifikasi data:
Format dan fakta proyek berasal dari sumber asli yang ditautkan. Langkah penyaringan serta kriteria penerimaan adalah saran editor CODEZ. Kandidat PDF merupakan entri yang benar-benar terdaftar dan dibandingkan pada commit tetap. Skill pihak ketiga ini belum dijalankan; contoh bukan hasil pengujian nyata.
01 / Pertama, tentukan Skill apa yang Anda butuhkan
Agent Skills biasanya disusun dalam folder. SKILL.md berisi metadata dan petunjuk tugas, serta dapat disertai skrip, referensi, dan templat. Field compatibility dalam spesifikasi format dapat menjelaskan persyaratan lingkungan, tetapi bersifat opsional. Jika kosong, tetap periksa isi dokumen dan dependensinya.
Pertama, tuliskan metode input, output, dan penerimaan. Misalnya, "Ekstrak tabel dari PDF dengan lapisan teks ke dalam file CSV, sambil mempertahankan nama kolom." "Bantu saya memproses dokumen" terlalu luas, sehingga sulit untuk menentukan apakah kandidat tersebut sesuai.
02 / Apa yang dapat ditunjukkan oleh jumlah Star repositori?
Bintang GitHub dapat digunakan untuk menandai proyek dan menyatakan apresiasi atas kerja para pengelolanya. Oleh karena itu, kami menggunakannya sebagai petunjuk untuk mengetahui popularitas suatu proyek.
Situs ini menggunakan bintang repositori untuk pemeringkatan. Sebuah repositori dengan ratusan Skill mungkin hanya menarik perhatian dari sebagian kontennya; total bintang sebuah repositori tidak dapat dialokasikan untuk setiap Skill. Saat membandingkan Skill dari dua repositori, kesesuaian tugas dibandingkan terlebih dahulu, diikuti oleh popularitas sebagai pertimbangan kedua.
Tanggal pembaruan terbaru hanya dapat membantu menemukan informasi. Satu perubahan yang tidak terkait tidak berarti bahwa kemampuan yang Anda butuhkan telah diperbaiki; Anda harus memeriksa commit, contoh, dan log masalah untuk direktori yang sesuai.
03 / Mengubah persyaratan menjadi kondisi yang dapat diperiksa
Kondisi-kondisi berikut lebih mudah diinterpretasikan dan diverifikasi daripada peringkat popularitas tunggal. Jumlah kondisi yang dipenuhi oleh kandidat tidak perlu digabungkan menjadi skor total yang tampak tepat.
| Skenario | Pemeriksaan pertama | Amati selama penggunaan uji coba. |
|---|---|---|
| Pemrosesan dokumen dan spreadsheet | Tipe input, format output, dependensi sistem | Apakah nama kolom, encoding, tata letak, atau data hilang? |
| Alur Kerja Kode dan Pengembangan | Bahasa target, versi kerangka kerja, dan alat yang dibutuhkan | Lingkup perubahan, umpan balik kesalahan, dan apakah proyek tersebut lolos inspeksi. |
| Penelitian dan Kompilasi Data | Cakupan sumber, persyaratan kutipan, dan kondisi jaringan. | Apakah referensi dapat ditelusuri kembali? Apakah kesimpulan melampaui bukti yang ada? |
04 / Buka file asli dan periksa lingkungan serta cakupan operasinya.
Buka SKILL.md dari kartu situs, lalu baca README dalam folder yang sama. README berbahasa Mandarin membantu memahami petunjuk, tetapi kelengkapan bahasa tidak membuktikan kompatibilitas Skill. Jika versi Mandarin tidak tersedia, periksa kondisi penting pada teks sumber.
Catat informasi ini sebelum mencobanya:
- Lingkungan pengoperasian: Klien yang didukung, sistem operasi, alat baris perintah, dan persyaratan versi yang dinyatakan secara eksplisit.
- Lingkup operasi: File mana yang akan dibaca atau dimodifikasi, layanan eksternal mana yang akan dipanggil, dan apakah kredensial diperlukan.
- Sumber daya tambahan: Apakah skrip dan file referensi yang dikutip dalam teks tersebut ada? Apa yang akan dilakukan oleh perintah yang dieksekusi?
- Persyaratan penggunaan: Bacalah berkas lisensi untuk proyek dan direktori Skill; tag "Tidak Bertanda" atau "Menunggu Verifikasi" di situs ini menunjukkan bahwa informasi tersebut belum dikonfirmasi.
- Informasi yang dapat direproduksi: Catat alamat repositori, jalur Skill spesifik, dan versi commit selama masa uji coba untuk menghindari kesulitan menemukan konten yang sama di kemudian hari.
05 / Bandingkan kandidat dengan tugas kecil yang sama
Pilih dua atau tiga kandidat yang paling sesuai dengan tugas tersebut, dan ujilah dengan input non-sensitif yang sama pada salinan uji yang dapat dipulihkan. Aktifkan hanya kemampuan yang Anda butuhkan saat ini untuk pertama kalinya, ikuti petunjuk instalasi untuk klien yang sebenarnya.
Tetapkan kondisi keberhasilan sebelum memulai. Untuk ekstraksi tabel, periksa jumlah baris, nama kolom, dan nilai null; untuk modifikasi kode, periksa fungsionalitas target, file yang dimodifikasi, dan pemeriksaan proyek yang ada. Jika suatu proses gagal, catat kesalahan dan lingkungannya; jangan langsung mengaitkan kegagalan tersebut dengan model atau Skill itu sendiri.
Catat semua koreksi manual yang diperlukan, alat tambahan, biaya layanan eksternal, dan waktu penyelesaian. Menggunakan metode pencatatan yang konsisten untuk tugas berulang memudahkan pengambilan keputusan daripada hanya mengandalkan satu kesan terhadap hasil akhir.
- Kandidat dan versi: repositori / path Skill / commit.
- Input dan Lingkungan: Contoh / Sistem Operasi / Klien dan Ketergantungan.
- Hasil dan Koreksi: Item penerimaan mana yang lolos dan mana yang memerlukan pemrosesan manual.
- Sumber Daya dan Keputusan: Layanan, waktu dan biaya yang digunakan, serta alasan untuk mengadopsi atau menunda.
06 / Kandidat nyata: bagaimana memilih dua Skill PDF dengan nama yang sama?
Katalog memuat skills/pdf/SKILL.md dari anthropics/skills dan skills/.curated/pdf/SKILL.md dari openai/skills. Kedua Skill bernama pdf; catat repositori dan path lengkap agar tidak menganggapnya satu kumpulan instruksi yang sama. Tabel membandingkan fokus tugas dalam sumber asli, bukan menyatakan kemampuan keduanya saling eksklusif atau menentukan akurasi berdasarkan Star.
Dokumen Anthropic memberikan contoh berbagai teknik manipulasi PDF, termasuk ekstraksi teks dan tabel, manipulasi halaman, pembuatan, dan OCR dokumen yang dipindai, serta mengarahkan pemrosesan formulir ke FORMS.md. Dokumen OpenAI menekankan pada pembacaan, pembuatan, dan peninjauan tata letak, yang memerlukan pemeriksaan setelah rendering halaman dan sekali lagi setelah pembaruan signifikan; ekstraksi teks saja tidak cukup untuk membuktikan kebenaran tata letak.
| Kandidat dan Jalur Lengkap | Poin-poin penting dari teks asli | CODEZ menyarankan untuk memeriksa hal ini terlebih dahulu. | Masih perlu diverifikasi |
|---|---|---|---|
| anthropics/skills / skills/pdf/SKILL.md | Contoh diberikan untuk setiap operasi: Ekstraksi, Pemrosesan Halaman, Generasi, dan OCR. | Saat mengekstrak tabel atau memproses dokumen hasil pemindaian, verifikasi terlebih dahulu operasi dan ketergantungan yang terkait. | Struktur tabel, bahasa dan akurasi OCR, ketersediaan sumber dan alat yang dikutip. |
| openai/skills / skills/.curated/pdf/SKILL.md | Buat, tinjau, dan periksa tata letak dengan cara merender halaman. | Jika laporan yang mudah dibaca diperlukan, pertama-tama verifikasi proses rendering dan inspeksi. | Font, tabel, nomor halaman, dan penomoran halaman; apakah teks tersebut dapat ditampilkan dalam lingkungan dunia nyata. |
anthropics/skills: skills/pdf/SKILL.md (commit tetap) ↗
openai/skills: skills/.curated/pdf/SKILL.md (commit tetap) ↗
07 / Uraikan "Ekstraksi berhasil" menjadi item penerimaan yang dapat diverifikasi.
Berikut rancangan uji coba yang disarankan: bandingkan kandidat dengan daftar inventaris dua halaman yang sama dan tidak sensitif. Contohnya memuat nomor material 0017, nama kolom berbahasa Mandarin, deskripsi kosong, header berulang pada halaman kedua, dan satu sel gabungan. Periksa hasil yang diharapkan secara manual, lalu simpan nomor halaman sumber dan salinan file asli. Uji coba ini belum dijalankan.
Sebelum memulai, tentukan apakah input dapat memilih teks dan coba lakukan ekstraksi dalam jumlah kecil. Pemeriksaan pemilihan dan ekstraksi hanya boleh digunakan sebagai petunjuk: keberadaan lapisan teks tidak menjamin struktur tabel yang benar, dan dokumen yang dipindai dengan teks OCR yang sudah ada mungkin juga mengandung kesalahan. Jika OCR diperlukan, catat bahasa dan alat sistem yang digunakan; ketergantungan yang hilang harus dicatat sebagai masalah lingkungan.
- Catat commit kandidat, klien, model, versi alat, dan jenis input agar perbedaan lingkungan tidak dianggap sebagai perbedaan Skill.
- Catat baris yang dikoreksi secara manual beserta alasannya, waktu eksekusi, dan layanan yang benar-benar dipanggil; data yang tidak diukur harus dibiarkan kosong.
- Kesimpulan yang sesuai hanya akan diterima jika semua kriteria penerimaan yang tercantum terpenuhi. Bahkan jika sampel lolos, input aktual Anda tetap perlu diverifikasi.
| Item Inspeksi | Hasil perlu diverifikasi | Cara menangani kegagalan |
|---|---|---|
| Nomor Material | Pertahankan nol di depan pada 0017; jangan otomatis mengubahnya menjadi 17 | Setelah memperjelas tipe kolom, ekstrak data lagi dan verifikasi setiap item. |
| Tabel lintas halaman | Header halaman kedua tidak dihitung sebagai data, dan tidak ada catatan yang hilang atau duplikat. | Pertahankan nomor halaman, periksa jumlah baris di setiap halaman, lalu gabungkan. |
| Karakter Tionghoa dan nilai null | Nama kolom terbaca; deskripsi kosong tetap kosong, tanpa isi tebakan | Periksa pengkodean dan posisi kolom, lalu tandai posisi yang tidak dapat dipulihkan. |
| Sel gabungan | Nilai deskripsi sesuai dengan catatan yang tepat; aturan pemisahan didokumentasikan jelas | Wilayah sumber dipertahankan, dan aturan pemetaan ditentukan secara manual. |
| Format laporan keluaran | Konten yang ditampilkan tidak mengalami pemotongan, tumpang tindih, atau kehilangan karakter. | Perbaiki font atau tata letak dan periksa hasil render terbaru. |
08 / Kategori, lisensi, dan ketergantungan adalah tiga pemeriksaan terpisah
Kali ini, kedua entri PDF telah dikoreksi dari "Desain" dan "Pengembangan" menjadi "Dokumen" masing-masing, mengikuti teks aslinya: input dan output utama keduanya berupa PDF, dan kode Python serta alat rendering adalah cara untuk menyelesaikan tugas. Satu kategori saja hanya membantu menemukan kandidat dan tidak dapat menentukan apakah ekstraksi atau tinjauan tata letak lebih sesuai.
Kedua entri tersebut memiliki file LICENSE.txt masing-masing di dalam direktori, dan situs ini mempertahankan label "File lisensi menunggu verifikasi". Harap baca lisensi asli untuk setiap direktori; jangan berasumsi bahwa lisensi tersebut dapat digunakan secara bebas hanya karena repositori tersebut tersedia untuk umum atau organisasi tempatnya berada terkenal.
Daftar dependensi juga harus diperiksa untuk setiap operasi spesifik. Menginstal pustaka Python tidak berarti bahwa alat rendering sistem atau lingkungan OCR tersedia; dokumen ini tidak membuktikan kompatibilitas dengan klien mana pun. Catat alat yang hilang, langkah-langkah yang belum diverifikasi, dan batasan penggunaan dalam catatan keputusan Anda.
09 / Skill Cloudflare: periksa konfigurasi proyek dan kredensial terlebih dahulu
Bagian ini memeriksa commit tetap cloudflare/skills / skills/cf-cli/SKILL.md dan dokumentasi resmi pada 2026-10-14. Berikut adalah saran pemilihan dan uji coba CODEZ; Skill ini tidak dijalankan.
cf tidak menggunakan ulang login Wrangler. Periksa akun dan izin token terlebih dahulu; catat versi CLI, konfigurasi, serta sumber daya tujuan agar perbedaan lingkungan tidak dianggap sebagai perbedaan Skill.
| Skenario | Pemeriksaan pertama | Amati selama penggunaan uji coba. |
|---|---|---|
| wrangler.jsonc, wrangler.json, atau wrangler.toml ada, tanpa cloudflare.config.ts | Pertahankan dahulu alur Wrangler untuk dev, build, dan deploy; perintah proyek cf tidak membaca konfigurasi yang sudah ada itu. | Tinjau dahulu perintah dan perubahan berkas yang diusulkan Skill; putuskan migrasi konfigurasi secara terpisah. |
| cloudflare.config.ts sudah ada | Periksa dev, build, dan deploy sesuai alur proyek cf; CLI masih beta, dan kategori tidak membuktikan kompatibilitas. | Periksa Node.js 22.18 atau lebih baru dan akun tujuan; tinjau keluaran build serta Worker tujuan pada salinan uji. |
cloudflare/skills / skills/cf-cli/SKILL.md ↗