Praktik Penggunaan Codex
Pada modul ini, kita akan menerapkan penggunaan Codex secara langsung dengan membangun sebuah proyek Dashboard Analitik. Anda juga akan mempelajari berbagai kapabilitas tingkat lanjut dari Codex yang dirancang untuk mengoptimalkan alur kerja pengembangan perangkat lunak Anda.
- Inisialisasi Proyek: Menginstruksikan penyusunan struktur aplikasi dasar.
- Manajemen Konteks (Memory): Memanfaatkan memori agen untuk menjaga konsistensi pengerjaan.
- Kustomisasi Agen (Skills): Mendefinisikan standar penulisan kode melalui file konfigurasi.
- Ekstensibilitas (MCP): Menghubungkan agen dengan alat bantu dan lingkungan eksternal.
Membangun Proyek Pertama
Mari mulai dengan menginstruksikan Codex untuk membuat sebuah halaman antarmuka web dasar secara otonom.
1. Persiapan Ruang Kerja
Buka aplikasi Codex, kemudian buat obrolan (chat) atau proyek baru melalui panel sebelah kiri. Anda dapat menamai proyek ini, misalnya "Dashboard Analitik".
2. Memberikan Instruksi Dasar (Prompt)
Pada kotak input yang tersedia (Do anything), masukkan parameter instruksi berikut:
3. Eksekusi dan Otorisasi
Codex akan mulai memproses instruksi dan merencanakan struktur kode. Jika sistem memerlukan izin eksplisit untuk membuat atau mengubah struktur file (biasanya ditandai dengan permintaan Ask for approval), berikan otorisasi tersebut agar AI dapat menyelesaikan pembuatan halaman web secara komprehensif.
Fitur Memory (Ingatan Konteks)
Codex dilengkapi dengan kapabilitas Memory yang memungkinkannya menyimpan dan mengakses kembali informasi kontekstual dari interaksi proyek-proyek sebelumnya.
Mekanisme Penggunaan:
Saat Anda menentukan preferensi arsitektur atau standar penulisan kode, Codex akan mengintegrasikannya ke dalam basis pengetahuannya. Sebagai contoh:
- "Gunakan bahasa Indonesia baku untuk seluruh dokumentasi dan komentar kode."
- "Setiap komponen tombol harus menggunakan warna latar biru dengan sudut membulat (border-radius: 8px)."
Dengan fungsionalitas ini, Anda tidak perlu mengulang instruksi pengaturan yang sama pada sesi berikutnya, sehingga efisiensi pengembangan perangkat lunak meningkat secara signifikan.
Apa itu Skill?
Pernahkah Anda berharap AI punya "buku resep" khusus untuk mengerjakan tugas Anda? Itulah fungsi Agent Skills!
Singkatnya, skill adalah folder berisi contekan instruksi (dan kadang kode tambahan) yang mengajarkan Codex cara melakukan suatu pekerjaan spesifik langkah demi langkah secara konsisten. Daripada menulis instruksi panjang berulang kali setiap kali chat, Anda cukup membuat skill satu kali saja.
Cara Pintar Codex Menghemat Memori
Codex punya trik yang disebut Progressive Disclosure. Agar komputernya tidak "lemot" membaca semua skill sekaligus, Codex di awal hanya membaca nama dan deskripsi singkat skill Anda. Ia baru akan membaca seluruh instruksi lengkapnya (file SKILL.md) saat ia merasa benar-benar butuh menggunakannya.
Isi di Dalam Folder Skill
Membuat skill itu sederhana. Anda cuma butuh satu folder dan satu file bernama SKILL.md. Berikut contoh isinya:
Cara Super Gampang Membuat Skill
Kabar baiknya, Anda tidak harus selalu mengetik semuanya sendiri. Ada 3 cara untuk membuat skill:
1. Gunakan Fitur Rekam (Record & Replay)
Paling direkomendasikan! Anda cukup kerja seperti biasa, lalu suruh Codex merekam langkah-langkah Anda. Codex akan langsung mengubah ketikan dan klik Anda menjadi sebuah skill otomatis. Keren, kan?
2. Minta Bantuan AI ($skill-creator)
Di kotak chat Codex, ketik saja teks di bawah ini:
Codex akan mewawancarai Anda (seperti "Skill ini untuk apa?", "Kapan mau dipakai?") dan ia yang akan mengetikkan file SKILL.md-nya untuk Anda.
3. Buat Manual Sendiri
Anda juga bisa bikin folder baru dan menaruh file SKILL.md di dalamnya secara manual. Ingat, bagian atasnya wajib ada nama dan deskripsi seperti contoh ini:
--- name: nama-skill-kamu description: Tuliskan dengan jelas kapan Codex harus sadar untuk memakai skill ini. --- Halo Codex, jika kamu pakai skill ini, ikuti langkah berikut: 1. Buka folder X 2. Lakukan Y...
Di Mana Menyimpan Skill?
Tergantung kebutuhan, Anda bisa menyembunyikan skill tersebut hanya untuk proyek ini saja, atau membagikannya ke semua proyek yang ada di komputer Anda. Codex membaca folder bernama .agents/skills dari lokasi-lokasi ini:
| Tipe Lokasi | Lokasi File | Kapan Digunakan? |
|---|---|---|
| PER PROYEK (REPO) | .agents/skills | Simpan di dalam folder proyek coding Anda. Bagus agar teman setim yang men-download proyek ini juga bisa langsung memakai skill tersebut. |
| PRIBADI (USER) | ~/.agents/skills | Simpan di folder utama komputer Anda (Home). Cocok untuk skill rahasia atau kebiasaan pribadi Anda yang ingin dipakai di semua proyek. |
Mengambil Skill Buatan Orang Lain
Malas buat sendiri? Anda bisa menginstal skill buatan komunitas (misalnya skill untuk memakai aplikasi Linear) langsung dari chat dengan mengetik:
Nanti, kalau Anda membuat skill yang super hebat dan ingin dibagikan ke teman-teman sedunia, Anda bisa membungkusnya menjadi sebuah Plugin!
Cara Menyuruh Codex Memakai Skill
Codex itu pintar, tapi kadang harus disenggol. Ada dua cara agar ia memakai skill Anda:
- Panggil Langsung (Eksplisit): Ini cara paling pasti. Ketik saja
$nama-skill-kamuatau/skillsdi dalam chat, lalu minta Codex kerja. - Otomatis Jalan (Implisit): Codex akan menebak apakah ketikan Anda cocok dengan
descriptionyang ada di dalamSKILL.md. Jika cocok, ia akan otomatis memakai skill tersebut tanpa disuruh!
- Satu tugas, satu skill. Jangan buat skill "Sapu Jagat" yang isinya menyuruh Codex mendesain UI sekaligus mengatur Database. Buatlah terpisah.
- Taruh kata kunci di awal. Karena Codex membaca deskripsi dengan cepat, pastikan kata kunci paling penting ditaruh di awal kalimat deskripsi Anda.
- Anggap Codex itu anak magang yang pintar. Berikan instruksi langkah demi langkah, jelaskan apa input-nya dan wujud akhir output yang Anda harapkan.
Integrasi Model Context Protocol (MCP)
Model Context Protocol (MCP) adalah standar protokol yang memfasilitasi interaksi agen AI otonom dengan alat, sistem, dan lingkungan eksternal di luar ranah sintaksis teks semata.
Kapabilitas Fungsional MCP:
Melalui integrasi MCP, Codex dapat diberikan otorisasi untuk mengeksekusi berbagai tindakan riil, antara lain:
- Akses Skema Basis Data: Codex dapat menganalisis struktur tabel database aktif secara terprogram guna memastikan presisi kueri SQL atau ORM.
- Eksekusi Baris Perintah (CLI): Mengizinkan Codex menginisialisasi skrip, mengunduh dependensi perangkat lunak, atau menjalankan lingkungan server lokal langsung pada terminal sistem.
- Interaksi API Eksternal: Memungkinkan penarikan data secara dinamis dari sumber pihak ketiga saat fase pengujian arsitektur perangkat lunak.