Penyesuaian

Penyesuaian memungkinkan Codex bekerja mengikuti cara kerja tim Anda.

Di Codex, penyesuaian berasal dari beberapa lapisan yang bekerja bersama:

• Panduan proyek (AGENTS.md) untuk instruksi persisten
• Memori untuk konteks berguna yang dipelajari dari pekerjaan sebelumnya
• Skill untuk alur kerja yang dapat digunakan kembali dan keahlian domain
• MCP untuk mengakses alat eksternal dan sistem bersama
• Subagen untuk mendelegasikan pekerjaan kepada subagen khusus

Semua ini saling melengkapi, bukan bersaing. AGENTS.md membentuk perilaku, memori membawa konteks lokal ke pekerjaan berikutnya, skill mengemas proses yang dapat diulang, dan MCP menghubungkan Codex ke sistem di luar ruang kerja lokal.

Panduan AGENTS

AGENTS.md memberi Codex panduan proyek tahan lama yang menyertai repositori Anda dan berlaku sebelum agen mulai bekerja. Jaga agar tetap ringkas.

Gunakan untuk aturan yang ingin selalu diikuti Codex di repositori, seperti:

• Perintah build dan pengujian
• Ekspektasi tinjauan
• Konvensi khusus repositori
• Instruksi khusus direktori

Ketika agen membuat asumsi yang keliru tentang basis kode Anda, perbaiki asumsi tersebut di AGENTS.md dan minta agen memperbarui AGENTS.md agar perbaikannya bertahan. Perlakukan ini sebagai siklus umpan balik.

Kapan perlu memperbarui AGENTS.md

• Kesalahan berulang: Jika agen berulang kali membuat kesalahan yang sama, tambahkan aturan.
• Terlalu banyak membaca: Jika agen menemukan file yang tepat tetapi membaca terlalu banyak dokumen, tambahkan panduan perutean (direktori/file yang perlu diprioritaskan).
• Umpan balik PR berulang: Jika Anda memberikan umpan balik yang sama lebih dari sekali, tetapkan sebagai aturan.
• Di GitHub: Dalam komentar pull request, tag @codex dengan permintaan (misalnya, @codex add this to AGENTS.md) untuk mendelegasikan pembaruan ke chat cloud.
• Mengotomatiskan pemeriksaan penyimpangan: Gunakan tugas terjadwal untuk menjalankan pemeriksaan berulang (misalnya, setiap hari) yang mencari kekurangan panduan dan menyarankan hal yang perlu ditambahkan ke AGENTS.md.

Pasangkan AGENTS.md dengan infrastruktur yang menegakkan aturan tersebut: hook pre-commit, linter, dan pemeriksa tipe menangkap masalah sebelum Anda melihatnya sehingga sistem semakin cerdas dalam mencegah kesalahan berulang.

Codex dapat memuat panduan dari beberapa lokasi: file global di direktori home Codex Anda (untuk Anda sebagai pengembang) dan file khusus repositori yang dapat di-commit oleh tim. File yang lebih dekat dengan direktori kerja memiliki prioritas lebih tinggi. Gunakan file global untuk membentuk cara Codex berkomunikasi dengan Anda (misalnya, gaya tinjauan, tingkat detail, dan default), dan pertahankan fokus file repositori pada aturan tim dan basis kode.

<FileTree class="mt-4" tree={[ { name: "~/.codex/", open: true, children: [ { name: "AGENTS.md", comment: "Global (untuk Anda sebagai pengembang)" }, ], }, { name: "repo-root/", open: true, children: [ { name: "AGENTS.md", comment: "khusus repositori (untuk tim Anda)" }, ], }, ]} />

Instruksi khusus dengan AGENTS.md

Skill

Skill memberi Codex kemampuan yang dapat digunakan kembali untuk alur kerja berulang. Skill sering kali paling cocok untuk alur kerja yang dapat digunakan kembali karena mendukung instruksi, skrip, dan referensi yang lebih lengkap sekaligus tetap dapat digunakan ulang di berbagai tugas. Skill dimuat dan terlihat oleh agen (setidaknya metadatanya), sehingga Codex dapat menemukan dan memilihnya secara implisit. Dengan demikian, alur kerja yang lengkap tetap tersedia tanpa memenuhi konteks sejak awal.

Gunakan folder skill untuk membuat dan menyempurnakan alur kerja secara lokal. Jika plugin untuk alur kerja tersebut sudah tersedia, pasang terlebih dahulu untuk menggunakan kembali penyiapan yang telah teruji. Saat Anda ingin mendistribusikan alur kerja sendiri ke berbagai tim atau menggabungkannya dengan konektor, kemas sebagai plugin. Skill tetap menjadi format penulisan; plugin adalah unit distribusi yang dapat dipasang.

Sebuah skill biasanya berupa file SKILL.md beserta skrip, referensi, dan aset opsional.

<FileTree class="mt-4" tree={[ { name: "my-skill/", open: true, children: [ { name: "SKILL.md", comment: "Wajib: instruksi + metadata" }, { name: "scripts/", comment: "Opsional: kode yang dapat dieksekusi" }, { name: "references/", comment: "Opsional: dokumentasi" }, { name: "assets/", comment: "Opsional: templat, sumber daya" }, ], }, ]} />

Direktori skill dapat menyertakan folder scripts/ dengan skrip CLI yang dipanggil Codex sebagai bagian dari alur kerja (misalnya, mengisi data awal atau menjalankan validasi). Jika alur kerja memerlukan sistem eksternal (pelacak masalah, alat desain, server dokumentasi), pasangkan skill dengan MCP.

Contoh SKILL.md:

---
name: commit
description: Stage and commit changes in semantic groups. Use when the user wants to commit, organize commits, or clean up a branch before pushing.
---

1. Do not run `git add .`. Stage files in logical groups by purpose.
2. Group into separate commits: feat → test → docs → refactor → chore.
3. Write concise commit messages that match the change scope.
4. Keep each commit focused and reviewable.

Gunakan skill untuk:

• Alur kerja berulang (langkah rilis, rutinitas tinjauan, pembaruan dokumentasi)
• Keahlian khusus tim
• Prosedur yang memerlukan contoh, referensi, atau skrip pembantu

Skill dapat bersifat global (di direktori pengguna Anda, untuk Anda sebagai pengembang) atau khusus repositori (di-commit ke .agents/skills, untuk tim Anda). Tempatkan skill repositori di .agents/skills jika alur kerja berlaku untuk proyek tersebut; gunakan direktori pengguna untuk skill yang ingin digunakan di semua repositori.

Codex menggunakan pengungkapan progresif untuk skill:

• Dimulai dari metadata (name, description) untuk penemuan
• Memuat SKILL.md hanya ketika sebuah skill dipilih
• Membaca referensi atau menjalankan skrip hanya saat diperlukan

Skill dapat dipanggil secara eksplisit, dan Codex juga dapat memilihnya secara implisit ketika tugas sesuai dengan deskripsi skill. Deskripsi skill yang jelas meningkatkan keandalan pemicuan.

Buat skill

MCP

MCP (Model Context Protocol) adalah cara standar untuk menghubungkan Codex ke alat eksternal dan penyedia konteks. MCP sangat berguna untuk sistem yang di-host dari jarak jauh seperti Figma, Linear, GitHub, atau layanan pengetahuan internal yang diandalkan tim Anda.

Gunakan MCP ketika Codex memerlukan kemampuan yang berada di luar repositori lokal, seperti pelacak masalah, alat desain, browser, atau sistem dokumentasi bersama.

Salah satu cara memahaminya:

• Host: Codex
• Klien: koneksi MCP di dalam Codex
• Server: alat eksternal atau penyedia konteks

Server MCP dapat menyediakan:

• Alat (tindakan)
• Sumber daya (data yang dapat dibaca)
• Prompt (templat prompt yang dapat digunakan kembali)

Pemisahan ini membantu Anda memahami batas kepercayaan dan kemampuan. Beberapa server terutama menyediakan konteks, sedangkan yang lain menyediakan tindakan yang berdaya besar.

Dalam praktiknya, MCP sering kali paling berguna ketika dipasangkan dengan skill:

• Skill menentukan alur kerja dan menyebutkan alat MCP yang akan digunakan

Model Context Protocol

Subagen

Anda dapat membuat agen berbeda dengan peran berbeda dan meminta mereka menggunakan alat dengan cara yang berbeda. Misalnya, satu agen dapat menjalankan perintah dan konfigurasi pengujian tertentu, sedangkan agen lain memiliki server MCP yang mengambil log produksi untuk debugging. Setiap subagen tetap terfokus dan menggunakan alat yang tepat untuk tugasnya.

Subagen

Menggunakan Skill + MCP bersama-sama

Kombinasi Skill dan MCP menyatukan semuanya: skill menentukan alur kerja yang dapat diulang, sedangkan MCP menghubungkannya ke alat dan sistem eksternal. Jika skill bergantung pada MCP, deklarasikan dependensi tersebut di agents/openai.yaml agar Codex dapat memasang dan menghubungkannya secara otomatis (lihat Buat skill).

Langkah berikutnya

Bangun dalam urutan berikut:

1. Instruksi khusus dengan AGENTS.md agar Codex mengikuti konvensi repositori Anda. Tambahkan hook pre-commit dan linter untuk menegakkan aturan tersebut.
2. Pasang plugin jika alur kerja yang dapat digunakan kembali sudah tersedia. Jika belum, buat skill dan kemas sebagai plugin saat Anda ingin membagikannya.
3. MCP ketika alur kerja memerlukan sistem eksternal (Linear, GitHub, server dokumentasi, alat desain).
4. Subagen ketika Anda siap mendelegasikan tugas yang bising atau khusus kepada subagen.