Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Panduan penulisan

Panduan ini adalah pendamping praktis bagi bab-bab arsitektur dan referensi bahasa. Jika arsitektur menjelaskan mengapa Aggrega berbentuk seperti itu dan referensi menetapkan apa arti setiap bidang, panduan ini mengajarkan cara mulai menulis — entitas mana yang Anda pakai, dalam urutan apa, dan bagaimana CLI serta asisten AI membantu Anda mendapatkan file yang benar dengan hambatan paling sedikit.

Panduan ini ditulis untuk dua audiens sekaligus: orang yang menulis secara manual di editor, dan asisten AI yang menulis atas nama seseorang melalui server Model Context Protocol. Keduanya mengikuti siklus yang sama dan membaca permukaan referensi yang sama, sehingga halaman-halaman di bawah ini melayani keduanya.

Baca dalam urutan ini

  1. Menulis file Aggrega — siklus penulisan dari awal hingga akhir: pilih peran Anda, pelajari bentuknya, buat kerangka, isi, validasi, build. Mulai dari sini.
  2. Persona — empat peran penulisan yang berkolaborasi (developer, arsitek, operasi, operator) dan kerangka “panduan, bukan penegakan” di baliknya.
  3. Entitas berdasarkan peran — setiap jenis entitas dipetakan ke peran yang biasanya memilikinya, sehingga Anda tahu di file mana setiap kepentingan berada.
  4. Instalasi — instal biner aggrega, dengan perintah-perintahnya di bagian awal; bagian koneksinya merujuk ke Menghubungkan server MCP.
  5. Menggunakan Aggrega di Visual Studio Code — ekstensi Aggrega untuk Visual Studio Code: apa yang dibutuhkannya, halaman sambutan, panel-panelnya dan graf topologi, serta setiap pengaturan dan perintah.

Impor berangkat dari proyek yang sudah Anda miliki dalam format lain dan menyusun draf file-file ini darinya, untuk Anda tinjau dan bangun.

Pelajari Aggrega menempatkan panduan ini dalam sebuah jalur yang melintasi seluruh dokumentasi.

Bekerja dengan asisten AI

  1. Menyiapkan Aggrega dengan asisten AI Anda — satu prompt untuk ditempelkan ke asisten yang dapat menjalankan perintah, sehingga asisten tersebut memasang Aggrega, menambahkan skill Aggrega, dan menghubungkan dirinya ke server.
  2. Menghubungkan server MCP — entri server untuk setiap klien, tempat setiap klien menyimpannya, server yang dijangkau melalui HTTPS, dan cara memeriksa koneksi.
  3. Skill Aggrega — instruksi yang dimuat asisten untuk Aggrega: cara memasangnya dan menjaganya tetap mutakhir.
  4. Apa yang dapat dilakukan asisten Anda dengan Aggrega — apa saja yang dapat dibaca, diperiksa, di-build, dan dipublikasikan asisten melalui server yang terhubung.

Hubungan permukaan asisten dengan panduan ini

Server aggrega mcp mengekspos panduan ini, referensi bahasa, dan JSON Schema sebagai sumber daya yang dibaca asisten sebelum menulis YAML, serta alat yang membuat kerangka dan memvalidasi entitas. Prompt penulisan bawaan asisten merujuk kembali ke halaman-halaman ini alih-alih mengulanginya, sehingga panduan ini adalah satu-satunya rumah prosa untuk metode penulisan. Lihat Menulis file Aggrega untuk siklusnya dan Menghubungkan server MCP untuk koneksinya.