CodeBuddy
Adaptor harness Apothem untuk Tencent CodeBuddy (GA).
Vendor: Tencent
Nama instal: codebuddy
Status: GA
Konfigurasi native: <project>/.codebuddy/rules/apothem-rules.md
Instalasi
apothem install --harness codebuddy --project /path/to/projectAdaptor menulis satu berkas aturan berlingkup-proyek dari permukaan aturan dan tata kelola Apothem bersama.
Berkas yang ditulis: <project>/.codebuddy/rules/apothem-rules.md
Pemetaan profil ke konfigurasi native
Adaptor membaca profil bersama Apothem dan merender berkas aturan proyek pada setiap
jalannya apothem install atau apothem update. CodeBuddy membaca setiap berkas
*.md di bawah .codebuddy/rules/ sebagai Markdown dengan frontmatter YAML opsional
(alwaysApply, paths, enabled) sesuai
dokumentasi CodeBuddy Rules; berkas Apothem
membawa alwaysApply: true, sehingga permukaan tata kelola diterapkan pada setiap
interaksi. Profil bersama adalah sumber kebenaran; suntingan lokal-proyek pada berkas
yang dihasilkan dicadangkan sebelum sinkronisasi berikutnya mengganti konten yang
dikelola Apothem.
Catatan kompatibilitas
Permukaan aturan CodeBuddy berlingkup-proyek di bawah .codebuddy/rules/. Adaptor
menulis berkas apothem-rules.md khusus yang berdampingan dengan berkas aturan apa pun
yang ditulis operator di direktori yang sama. Berkas memori proyek CODEBUDDY.md dan
.codebuddy/settings.json (izin, MCP) milik operator; Apothem tidak menulisnya. Skill,
perintah, agen, dan hook dirujuk sebagai disiplin di dalam berkas aturan — CodeBuddy
tidak mengekspos permukaan berkas milik adaptor untuk mereka. Konvensi permukaan vendor
yang menjadi sandaran adaptor disematkan di
src/apothem/harnesses/codebuddy/STANDARD-CONVENTION-PIN.md, di-snapshot terhadap
dokumentasi CodeBuddy langsung.
Verifikasi
apothem verify --harness codebuddy --project /path/to/projectPerintah verify mengonfirmasi bahwa:
- Konfigurasi native ada di jalur yang diharapkan.
- Berkas aturan terkelola hadir dan tidak kosong.
- Rutin verifikasi khusus adaptor melaporkan keberhasilan.
Pemutakhiran
apothem update --harness codebuddy --project /path/to/projectMenurunkan-ulang berkas aturan proyek dari keadaan profil bersama saat ini. install
dan update bersifat idempoten — menjalankan ulang menimpa berkas terkelola dengan
konten terender terbaru.
Pencopotan
apothem uninstall --harness codebuddy --project /path/to/projectMenghapus berkas konfigurasi native yang ditulis oleh adaptor, mengganti nama berkas aturan terkelola menjadi cadangan bertanda waktu. YAML profil bersama dan mesin Apothem tidak terpengaruh.
Gerbang konformitas
python -m apothem.conformity.gate --all .Pemecahan masalah
| Gejala | Perbaikan |
|---|---|
| Berkas konfigurasi tidak ditemukan | Jalankan ulang apothem install --harness codebuddy --project /path/to/project |
| Verifikasi gagal | Jalankan apothem update --harness codebuddy --project /path/to/project, lalu verifikasi lagi |
| Konten konfigurasi tak terduga | Periksa ~/.config/apothem/profile.yaml atau --profile PATH, lalu jalankan ulang apothem update --harness codebuddy --project /path/to/project |
Tombol konfigurasi
| Flag | Default | Deskripsi |
|---|---|---|
--dry-run | false | Pratinjau instalasi tanpa menulis berkas. |