← Kembali ke daftar

Praktik terbaik rekayasa yang cepat

Perlakukan perintah seperti kode: beri struktur, buat versi, evaluasi. Di bawah ini adalah enam praktik yang bertahan dari lusinan jalur produksi di Starsg — praktik yang secara konsisten menggerakkan jarum, sesuai urutan yang cenderung penting.

1. Tetapkan peran dan tujuannya

Satu atau dua baris pertama harus mencerminkan perspektif model: siapa modelnya, untuk siapa model tersebut menulis, seperti apa kesuksesannya. Kepadatan istilah, nada, dan pilihan apa yang akan disertakan semuanya tidak sesuai dengan jangkar tersebut — jauh lebih murah daripada menarik kembali model tersebut nanti dengan “tidak terlalu bertele-tele” atau “tidak terlalu akademis”. A solid opening answers three things: identity, audience, goal.

Templat pengaturan peran

text
Anda adalah seorang insinyur hubungan pengembang.
Audiens: teknisi backend merasa nyaman dengan API HTTP tetapi baru mengenal LLM dan penetapan harga berbasis token.
Sasaran: dalam tiga menit, membantu pembaca memutuskan apakah Starsg layak untuk diintegrasikan, dan memberi tahu mereka langkah selanjutnya.
Gunakan nada yang polos namun profesional. Hindari kesalahan pemasaran.

2. Tulis tugas secara eksplisit

"Tulis uraian singkat produk" serahkan setiap keputusan kepada model — setiap proses hanyalah sebuah tebakan. Instruksi yang dapat digunakan kembali setidaknya memiliki lima elemen: tindakan (menulis/meringkas/menerjemahkan), objek (apa), audiens (untuk siapa), nada/gaya, dan panjang atau bentuk. Ejalah itu dan stabilitas output Anda akan segera melonjak.

❌ Terlalu kabur

text
Tuliskan saya uraian singkat produk.

✅ Kelima elemen

text
Dengan kata ~200, untuk teknisi backend, perkenalkan tiga pembeda Starsg (gateway terpadu, penagihan per kunci, fallback multi-model). Nada: profesional dan terkendali. Hindari kata-kata seperti “memberdayakan” atau “generasi berikutnya”. Akhiri dengan satu ajakan bertindak yang konkrit.

3. Berikan konteks dan contoh (Beberapa kesempatan)

Semakin abstrak persyaratannya, semakin banyak contoh yang dapat diterima. Satu hingga tiga pasangan “masukan → keluaran yang diharapkan” bernilai sepuluh baris penjelasan. Few-shot sangat menentukan ketika format sudah diperbaiki (klasifikasi, ekstraksi, JSON), ketika gaya sulit dijelaskan dengan kata-kata, atau ketika domain memiliki konvensi sendiri (hukum, medis, sistem internal). Buatlah contoh-contoh yang mencakup distribusi sebenarnya — bukan hanya kasus-kasus yang mudah.

Contoh ekstraksi beberapa suntikan

text
Dari teks tiket dukungan di bawah, ekstrak tiga kolom: «type / scope / severity». Keluaran JSON saja.

Contoh 1:
Masukan: Pengguna melaporkan kegagalan login di seluruh wilayah Guangzhou; dukungan telepon kelebihan beban.
Keluaran: {"type":"login","scope":"Guangzhou region","severity":"P1"}

Contoh 2:
Masukan: Akun percobaan menunjukkan saldo yang salah; hanya QA internal yang terpengaruh.
Keluaran: {"type":"account","scope":"internal QA","severity":"P3"}

Sekarang proses:
Masukan: Gerbang Beijing API mengembalikan 502; semua pengguna berbayar terpengaruh.

4. Batasi format keluaran

Apa pun yang dikonsumsi oleh sistem hilir harus dapat diurai. JSON? Berikan skema dan catatan lapangan. Daftar? Sematkan hitungan dan bentuk per item. Topi panjang? Katakan begitu. Tambahkan klausa seperti «jika bidang tersebut hilang, setel ke nol — jangan menciptakannya» dan Anda akan mengurangi halusinasi secara signifikan.

Batasan keluaran JSON

text
Ubah resume di bawah ini menjadi JSON, sesuaikan dengan skema ini:
{
  "name": string,
  "yearsOfExperience": number,
  "skills": string[],     // at most 5, lowercase
  "summary": string        // <= 60 words
}
Jika sumber tidak menyebutkan suatu bidang, setel ke nol — jangan menciptakannya. Output JSON saja, tanpa teks di sekitarnya.

5. Uraikan tugas-tugas kompleks (dengan rantai pemikiran)

Meminta model untuk "menganalisis + merencanakan + memproduksi" dalam satu kesempatan biasanya akan kehilangan detail atau menganggap penalaran sebagai jawaban akhir. Ada dua pilihan: biarkan ia berpikir selangkah demi selangkah secara internal, atau bagi sendiri pekerjaannya menjadi beberapa putaran. Untuk alur kerja yang dapat diaudit, kami lebih memilih yang terakhir — pertahankan setiap perantara sehingga nantinya Anda dapat menentukan dengan tepat langkah mana yang gagal.

Templat langkah demi langkah

text
Saya akan memberi Anda spesifikasi produk. Prosesnya dalam tiga langkah dan pisahkan masing-masing dengan judul ##:

## 1. Informasi penting
Daftar poin: pengguna target, skenario inti, fitur yang harus dimiliki, hal-hal yang secara eksplisit di luar cakupan.

## 2. Risiko dan poin yang tidak jelas
Cantumkan segala sesuatu yang ambigu atau bertentangan dalam spesifikasi, masing-masing satu kalimat.

## 3. Langkah selanjutnya
Berikan PM tiga tindakan selanjutnya yang konkrit dan dapat dilaksanakan, yang diurutkan berdasarkan prioritas.

Spesifikasi:
<<<

>>>

6. Ulangi dan evaluasi

Perintah yang baik tidak ditulis, melainkan diulang-ulang. Buat himpunan eval tetap (kasus 20–50 mencakup normal + edge + adversarial). Jalankan pada setiap perubahan cepat dan catat tingkat keberhasilan, panjang rata-rata, dan biaya token. Buatlah versi perintah Anda seperti kode — setiap perubahan mempunyai alasan dan garis dasar regresi, tidak ada yang “terasa lebih baik kali ini”.

Daftar periksa evaluasi
  • Memperbaiki kumpulan data yang mencakup kasus normal, edge, dan adversarial.
  • Ubah satu variabel per iterasi (instruksi, jumlah contoh, batasan format) — jika tidak, atribusi akan menjadi tidak jelas.
  • Lacak tingkat hit / token rata-rata / mode kegagalan per versi dalam satu lembar.
  • Uji seluruh model — perintah yang sama sering kali berperilaku sangat berbeda pada Claude / GPT / Gemini.
PenutupanTak satu pun dari enam hal tersebut merupakan solusi terbaik, namun jika digabungkan, keduanya merupakan kesenjangan antara “siap produksi, dapat diserahkan, dapat di-debug” dan “semacam karya”. Terapkan bagian 1, 2 dan 4 terlebih dahulu — Anda akan segera merasakan perubahan stabilitas. Kemudian tambahkan beberapa langkah dan evaluasi, dan latihan cepat Anda berubah dari kerajinan tangan menjadi teknik.