Zed

Vendor: Zed Industries Nama instalasi: zed Status: GA Konfigurasi native: <project>/.rules

InstalasiCopy Anchor Link

apothem install --harness zed --project /path/to/project

Adaptor menulis satu berkas instruksi Zed berlingkup proyek dari aturan dan permukaan tata kelola Apothem bersama. Zed membaca satu berkas instruksi proyek, yaitu kecocokan pertama dalam daftar ini:

.rules
.cursorrules
.windsurfrules
.clinerules
.github/copilot-instructions.md
AGENT.md
AGENTS.md
CLAUDE.md
GEMINI.md

Tidak ada direktori aturan per-alat, sehingga seluruh permukaan Apothem mendarat di berkas .rules datar di urutan teratas daftar tersebut.

Adaptor juga menulis skill Apothem, beserta aturan dan templat yang dikutipnya, ke direktori home pengguna Anda, sebelum menyentuh proyek (lihat Berkas di luar proyek).

Berkas yang ditulis:

• <project>/.rules, berkas instruksi.
• ~/.agents/skills/<name>/SKILL.md untuk setiap skill dan command Apothem, di direktori home pengguna Anda.
• ~/.config/apothem/rules/ dan ~/.config/apothem/templates/, di direktori home pengguna Anda.

Berkas di luar proyekCopy Anchor Link

Instalasi juga menulis skill Apothem ke direktori home pengguna Anda, sebelum mengubah apa pun di dalam proyek:

Folder-folder ini dipakai bersama. Folder ini tidak privat bagi proyek:

• Setiap proyek tempat Anda memasang zed, dan setiap instalasi Apothem lain yang menyebut folder tersebut, memakai salinan yang sama dan menulis berkas yang sama, sehingga urutan pemasangan Anda tidak berpengaruh. Beberapa alat lain juga membaca ~/.agents/skills/; registri harness mencantumkannya.
• --project memilih berkas instruksi yang ditulis dan proyek tempat instalasi itu berada. Opsi ini tidak mengubah ke mana skill ditulis.
• Instalasi tidak menambahkan berkas skill atau aturan ke repositori Anda. Proyek mendapatkan berkas instruksi, ditambah folder data .apothem/ yang dibuat oleh setiap instalasi proyek.
• Folder home ditulis lebih dulu. Jika itu gagal, misalnya karena sebuah folder di jalur tersebut adalah tautan yang keluar dari direktori home Anda (tautan yang tetap berada di dalamnya diikuti) atau tidak dapat ditulisi, instalasi berhenti dengan galat sebelum apa pun di dalam proyek berubah.
• Folder skill dengan nama skill Apothem yang tidak ditulis oleh Apothem dibiarkan, dan instalasi mencetak peringatan yang menyebutkan namanya. Ganti nama atau pindahkan folder itu, lalu jalankan apothem update. apothem verify gagal selama nama itu masih terpakai.
• Total ukuran berkas-berkas tersebut beberapa megabita.

Instalasi mencetak catatan yang menyebutkan folder yang ditulisnya di luar --project, dan --dry-run mencantumkannya.

Pemetaan profil ke konfigurasi nativeCopy Anchor Link

Adaptor membaca profil bersama Apothem dan merender berkas .rules proyek pada setiap kali apothem install atau apothem update dijalankan. Profil bersama adalah sumber kebenaran; setiap .rules yang sudah ada sebelumnya (atau suntingan lokal-proyek pada berkas yang dihasilkan) dicadangkan sebelum sinkronisasi berikutnya mengganti konten yang dikelola Apothem.

Catatan kompatibilitasCopy Anchor Link

Zed menetapkan AGENTS.md sebagai berkas instruksi utamanya dan mempertahankan .rules proyek sebagai berkas kompatibilitas yang didukung (instruksi Zed). Karena Zed hanya membaca kecocokan pertama, .rules yang baru menyembunyikan AGENTS.md, CLAUDE.md, atau berkas lain yang lebih rendah dalam daftar yang sudah diandalkan proyek. Instalasi tidak pernah menyunting berkas-berkas tersebut. Ketika .rules hanya berisi blok Apothem dan sebuah berkas berprioritas lebih rendah berisi teks Anda, install dan update mencetak peringatan yang menyebutkan berkas yang tersembunyi; salin instruksi yang Anda perlukan ke dalam .rules di luar blok Apothem agar instruksi tersebut tetap terbaca di Zed.

Berkas instruksi global ~/.config/zed/AGENTS.md dan blok server konteks MCP (.zed/settings.json context_servers) dimiliki operator; Apothem tidak menulisnya.

Zed memuat skill global hanya dari ~/.agents/skills/, dalam tata letak datar dengan satu folder per skill, yaitu tata letak yang ditulis instalasi. Zed mensyaratkan worktree tepercaya untuk skill lokal-proyek, dan dokumentasinya tidak mengaitkan syarat semacam itu dengan folder global. Satu laporan menyebut adanya batas ukuran pada katalog skill yang dikirim Zed ke model; Apothem belum memastikannya, ataupun apakah skill yang menonaktifkan pemanggilan oleh model ikut terhitung di dalamnya. Nama dan deskripsi skill Apothem berjumlah sekitar 20 KB. Apothem juga belum memastikan bagaimana Zed memperlakukan kunci header SKILL.md yang tidak dicantumkannya.

VerifikasiCopy Anchor Link

apothem verify --harness zed --project /path/to/project

Perintah verify mengonfirmasi bahwa:

1. Konfigurasi native ada di jalur yang diharapkan.
2. Setiap target terkelola ada; berkas terkelola tidak kosong, dan konfigurasi JSON atau YAML dapat diurai. Tambahkan --profile PATH untuk juga memastikan bahwa berkas yang terpasang cocok dengan profil tersebut.
3. Setiap folder skill Apothem ada di tempatnya dengan sebuah SKILL.md, instalasi mana pun yang menulisnya, dan tidak ada folder skill dengan nama Apothem yang milik sesuatu yang tidak ditulis Apothem. Pemeriksaan yang gagal menyebutkan folder yang hilang atau asing.
4. Rutin verifikasi khusus adapter melaporkan keberhasilan.

PembaruanCopy Anchor Link

apothem update --harness zed --project /path/to/project

Menurunkan ulang berkas .rules proyek dari keadaan profil bersama saat ini.

Pembaruan juga menulis ulang setiap folder skill yang berkasnya berbeda dari berkas saat ini. Jika Anda memasang dengan rilis sebelumnya yang tidak menulis skill, pembaruan menambahkannya.

PencopotanCopy Anchor Link

apothem uninstall --harness zed --project /path/to/project

Menghapus blok terkelola Apothem dari berkas konfigurasi native .rules dan mempertahankan teks Anda sendiri. Berkas dihapus hanya ketika tidak ada yang tersisa di dalamnya. Sebelum perubahan, salinan berkas yang diberi cap waktu disimpan di bawah ~/.apothem/backups/; tidak ada berkas cadangan yang tertinggal di proyek. YAML profil bersama dan mesin Apothem tidak terpengaruh.

Pencopotan juga menghapus folder skill yang ditulisnya di ~/.agents/skills/ serta aturan dan templat di ~/.config/apothem/, tetapi hanya ketika tidak ada lagi instalasi Apothem lain yang memakainya. Proyek lain, atau alat lain yang berbagi folder itu, mungkin masih memakainya. Dalam kasus itu pencopotan mempertahankan folder tersebut, mencetak instalasi mana yang memakainya, dan pencopotan terakhir menghapusnya. Berkas yang Anda tambahkan ke folder tersebut tetap ada, dan folder yang menjadi kosong dihapus. Setiap folder dicadangkan di bawah ~/.apothem/backups/ sebelum dihapus.

Gerbang konformitasCopy Anchor Link

python -m apothem.conformity.gate --all .

Pemecahan masalahCopy Anchor Link

Tombol konfigurasiCopy Anchor Link

Lihat jugaCopy Anchor Link

• Semua harness — katalog lengkap alat yang didukung
• Panduan instalasi — pasang Apothem ke dalam harness ini
• Referensi apothem harnesses — mencantumkan dan memeriksa adaptor dari CLI