Tutorial

Mulai proyek dengan /init dan AGENTS.md

Berikan Bob konteks proyek yang persisten di seluruh percakapan dan mode dengan /init, yang secara otomatis menghasilkan file AGENTS.md.

Perintah /init memindai proyek dan menghasilkan file ringkasan terstruktur bernama AGENTS.md yang digunakan Bob sebagai konteks persisten di setiap percakapan. Perintah /init adalah cara kamu memberikan Bob pengetahuan tentang struktur, konvensi, dan codebase proyek, tanpa mengharuskan Bob membaca ulang setiap file di awal setiap interaksi.

Large language model bersifat stateless. Setiap percakapan baru dimulai tanpa memori interaksi sebelumnya. Tanpa konteks proyek yang eksplisit, Bob harus menemukan kembali codebase di setiap interaksi baru, yang tidak efisien dan menjadi tidak praktis pada skala besar.

Dalam tutorial ini, kamu menginisialisasi Bob di direktori root aplikasi demo, menjelajahi konteks yang diperoleh Bob tentang aplikasi, dan mempelajari struktur Bob untuk konteks mode-spesifik.

Prasyarat

Untuk menyelesaikan tutorial ini, kamu memerlukan:

git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels
  • Bob IDE dengan kode demo Galaxium Travels terbuka.

Jalankan /init

Untuk menginisialisasi konteks proyek, navigasi ke antarmuka chat Hi, I'm Bob di Bob IDE. Beralih ke Agent mode di bagian bawah sidebar.

Beralih ke Agent mode

Masukkan perintah /init di antarmuka chat.

 /init

Menjalankan perintah /init di Bob IDE

Bob membaca file yang relevan di proyek. Bob kemudian menghasilkan file AGENTS.md utama di direktori root Galaxium Travels. Bob juga membuat folder .bob yang berisi AGENTS.md untuk setiap mode.

Jelajahi file AGENTS.md

File AGENTS.md berfungsi seperti dokumentasi onboarding untuk Bob. AGENTS.md adalah ringkasan singkat dan actionable yang menyediakan semua yang diperlukan Bob untuk memahami struktur dan konvensi proyek.

Kamu bisa menemukan file AGENTS.md utama di bagian bawah Bob file explorer di sisi kiri. Buka file untuk membaca isinya.

File AGENTS.md di Bob file explorer

File AGENTS.md biasanya berisi komponen-komponen berikut:

  • Ikhtisar dan tujuan proyek
  • Struktur direktori dan lokasi file utama
  • Tech stack dan dependensi
  • Pola arsitektur dan konvensi
  • Workflow pengembangan

Bob secara otomatis menerapkan AGENTS.md ke percakapan baru dan mempelajari konteks proyek.

File AGENTS.md mode-spesifik

Selain AGENTS.md utama di direktori root Galaxium Travels, /init menghasilkan file konteks mode-spesifik di folder .bob untuk setiap mode bawaan. Setiap AGENTS.md mode-spesifik memperluas AGENTS.md utama dengan konteks yang relevan untuk tujuan mode tersebut.

FileMode
.bob/rules-code/AGENTS-code.mdAgent mode
.bob/rules-plan/AGENTS-plan.mdPlan mode
.bob/rules-ask/AGENTS-ask.mdAsk mode

Pertahankan file AGENTS.md

Jalankan ulang /init setelah kamu melakukan penyesuaian proyek berikut:

  • Menambahkan modul atau layanan baru
  • Mengubah struktur direktori
  • Mengadopsi teknologi atau framework baru
  • Onboarding anggota tim baru yang akan menggunakan Bob

Langkah selanjutnya

Dalam tutorial ini, kamu mempelajari bahwa:

  • Large language model bersifat stateless. Menjalankan perintah /init mengatasi masalah ini dengan menghasilkan AGENTS.md, yaitu file konteks persisten yang dibaca Bob di awal setiap percakapan.
  • File AGENTS.md mode-spesifik menyediakan konteks yang ditargetkan untuk mode Agent, Plan, dan Ask.
  • Jalankan ulang /init setelah perubahan proyek besar untuk menjaga konteks tersebut tetap terkini.
Bagaimana topik ini?