Penyiapan dengan asisten pemrograman

Penyiapan tercepat cukup dengan satu prompt. Tombol Salin prompt di Beranda Anda memberi Anda teks untuk ditempelkan ke asisten pemrograman (Claude Code, Codex, Cursor, GitHub Copilot, atau yang lain) di dalam proyek Anda.

Yang dilakukan prompt

Dialognya terdiri dari dua langkah. Pertama, Anda memilih apa yang harus dikerjakan asisten: penyiapan baru, SDK saja, atau migrasi dari SDK tilawah lain atau dari penyiapan Quran Lab yang lebih lama. Setelah itu, Anda menyalin prompt.

Untuk migrasi, ada satu pertanyaan lagi sebelum prompt: apa yang akan dilakukan pada aturan, ambang batas, dan teks umpan balik yang Anda tulis sendiri.

• Pertahankan. Hanya modelnya yang berganti. Kode Anda tetap seperti semula dan menerima keluaran TajweedFormer.
• Pindahkan. Asisten menulis ulang setiap aturan untuk keluaran TajweedFormer, mempertahankan perilakunya, lalu menyebutkan apa saja yang tidak dapat dipindahkan.
• Hapus. Asisten menghapusnya, tetapi baru setelah menunjukkan daftarnya kepada Anda dan Anda setuju.

Menyalin prompt akan membuat kunci untuk aplikasi serta token setup yang berlaku selama 24 jam. Keduanya hanya dimasukkan ke teks yang disalin. Dengan keduanya, pada penyiapan baru, asisten:

• menentukan mana di antara empat SDK yang dibutuhkan proyek Anda, lalu memasang versi terbarunya;
• menyimpan kunci di tempat platform Anda menyimpan rahasia, di luar repositori Anda;
• menamai kunci sesuai nama aplikasi Anda dan mendaftarkan penyiapan ke Quran Lab;
• menjelaskan berbagi rekaman dan menyusun draf listing direktori Anda untuk Anda tinjau;
• menjalankan pemeriksaan penyiapan, lalu memberi tahu Anda dalam beberapa baris apa saja yang sudah dikerjakannya.

Selama asisten bekerja, Beranda Anda ikut menampilkan kemajuannya: prompt disalin, asisten masuk, menyiapkan, siap.

Asisten hanya menanyakan hal yang tidak bisa dijawab oleh proyek Anda. Asisten dapat membuat kunci dan mendaftarkan penyiapan, tetapi tidak pernah dapat mencabut, memindahkan, atau menghapus apa pun. Asisten tidak pernah mengeluarkan aplikasi dari daftar sebuah kunci atas inisiatifnya sendiri: instalasi yang tidak lagi tercantum pada kunci berhenti mengenali bacaan dan menghapus model saat berikutnya terhubung ke server.

Skill

Prompt ini menyertakan tautan ke skill Quran Lab untuk asisten: seluruh penyiapan dalam satu berkas yang diikuti asisten langkah demi langkah. Prompt bisa bekerja sendiri, tetapi hasilnya lebih baik jika skill terpasang.

Skill ini menjaga dirinya tetap mutakhir. Paling banyak sekali sehari, sebelum hal lain, asisten membandingkan versi salinan yang terpasang dengan versi yang dipublikasikan. Jika ada versi yang lebih baru, asisten mengunduh berkas-berkas baru, memeriksa masing-masing terhadap SHA-256 yang tercantum di https://sdk.quranlab.ai/skills/quranlab-sdk/manifest.json, dan baru setelah itu mengganti berkas lama. Waktu pemeriksaan terakhir disimpan di quranlab-sdk.checked di samping skill, yang diabaikan git. Jika pemeriksaan gagal, salinan lama tetap dipakai dan asisten memberi tahu Anda dalam satu baris; saat offline, asisten melanjutkan dengan salinan yang ada. Asisten yang tidak dapat menjalankan perintah atau menjangkau sdk.quranlab.ai tetap memakai salinannya sampai prompt berikutnya dari tombol Salin prompt memasang versi terbaru.

Skill ini adalah versi 3.1.8:

https://sdk.quranlab.ai/skills/quranlab-sdk/SKILL.md

Skill tidak pernah berisi kunci.

Memasang skill

Jalankan satu baris dari folder proyek Anda. Perintah itu menyimpan skill di folder tempat asisten Anda memuat skill, sekaligus membuat folder yang belum ada di sepanjang jalurnya. Di Windows, perintahnya adalah curl.exe: perintah ini sudah tersedia di Windows 10 (sejak 2018) dan Windows 11, serta bisa dijalankan di PowerShell maupun Command Prompt.

Claude Code

curl -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .claude/skills/quranlab-sdk/SKILL.md

curl.exe -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .claude\skills\quranlab-sdk\SKILL.md

Codex

curl -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .agents/skills/quranlab-sdk/SKILL.md

curl.exe -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .agents\skills\quranlab-sdk\SKILL.md

Cursor

curl -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .cursor/skills/quranlab-sdk/SKILL.md

curl.exe -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .cursor\skills\quranlab-sdk\SKILL.md

GitHub Copilot

curl -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .github/skills/quranlab-sdk/SKILL.md

curl.exe -fsSL --create-dirs https://sdk.quranlab.ai/skill -o .github\skills\quranlab-sdk\SKILL.md

Asisten lain: berikan tautan skill di atas kepadanya.

Proyek yang disiapkan dalam bentuk rule Cursor atau berkas instruksi Copilot tetap berfungsi: kedua berkas itu tetap berada di https://sdk.quranlab.ai/skills/quranlab-sdk/quranlab-sdk.mdc dan https://sdk.quranlab.ai/skills/quranlab-sdk/quranlab-sdk.instructions.md.

Perubahan berikutnya

Asisten yang sama juga mengerjakan perubahan berikutnya saat Anda memintanya: memperbarui SDK ketika halaman aplikasi Anda menunjukkan bahwa pembaruan sudah rilis, memilih waktu respons lain, menyematkan versi model, atau mengubah aplikasi mana saja yang dilayani sebuah kunci. Waktu respons, versi model, dan aplikasi sebuah kunci juga dapat Anda ubah sendiri di tab Pengaturan aplikasi, dan saat pembaruan SDK sudah rilis, halaman aplikasi memiliki tombol Salin prompt pembaruan.