Menggunakan dengan Asisten AI
Pasang plugin codeknit di Claude Code, Codex, atau Kiro, tetap perbarui, dan ajukan pertanyaan tentang struktur dan kode duplikat kepada asisten. Plugin ini berisi satu keterampilan, codeknit. Keterampilan ini memberi tahu asisten kapan harus menjalankan codeknit parse, codeknit graph analyze, dan codeknit fingerprint, serta cara membaca keluaran .skt.
Anda tidak perlu memasang biner codeknit sendiri. Pertama kali keterampilan dijalankan, ia akan menjalankan scripts/install-codeknit.sh yang terikat, yang melakukan hal berikut:
- Keluar segera jika
codeknitsudah ada diPATHatau di~/.local/bin. - Jika tidak, mengunduh rilis GitHub terbaru untuk OS dan arsitektur Anda.
- Memverifikasi unduhan terhadap
checksums.txtrilis. - Memasang biner ke
~/.local/bindan mencetak jalur absolutnya pada baris terakhir keluaran.
Jika ~/.local/bin tidak ada di PATH, asisten akan memanggil codeknit dengan jalur lengkap tersebut selama sisa sesi.
Untuk mengontrol pemasangan, atur variabel lingkungan ini:
| Variabel | Efek |
|---|---|
CODEKNIT_VERSION |
Memperbaiki rilis, misalnya 0.6.0. |
CODEKNIT_INSTALL_DIR |
Mengubah lokasi pemasangan. |
Untuk memasang biner sendiri, lihat Pemasangan.
Pasang plugin
Section titled “Pasang plugin”Pilih bagian sesuai dengan asisten Anda.
Claude Code
Section titled “Claude Code”Jalankan perintah berikut di shell Anda. Di dalam sesi Claude Code, jalankan perintah yang sama sebagai /plugin ....
claude plugin marketplace add awslabs/codeknit --sparse .claude-plugin skillsclaude plugin install codeknit@codeknitcodex plugin marketplace add awslabs/codeknit --sparse .agents --sparse .codex-plugin --sparse skillscodex plugin add codeknit@codeknitKiro IDE
Section titled “Kiro IDE”- Buka panel Powers.
- Pilih Add Custom Power, lalu Import power from GitHub.
- Masukkan
https://github.com/awslabs/codeknit.
Kiro CLI
Section titled “Kiro CLI”Kiro CLI memasang dari jalur lokal, jadi klon repositori terlebih dahulu:
git clone --depth 1 --filter=blob:none --sparse https://github.com/awslabs/codeknit ~/.codeknit-powergit -C ~/.codeknit-power sparse-checkout set skillskiro-cli powers install ~/.codeknit-powerTentang --sparse
Section titled “Tentang --sparse”Opsi --sparse bersifat opsional. Opsi ini membatasi klon hanya pada manifes plugin dan skills/ alih-alih seluruh pohon sumber.
Pasang keterampilan secara manual
Section titled “Pasang keterampilan secara manual”Jika asisten Anda membaca Agent Skills tetapi tidak mendukung plugin, salin skills/codeknit/ ke direktori keterampilan untuk asisten Anda:
~/.claude/skills/~/.codex/skills/~/.kiro/skills/
Perbarui plugin
Section titled “Perbarui plugin”| Asisten | Perintah atau tindakan |
|---|---|
| Claude Code | claude plugin marketplace update codeknit |
| Codex | codex plugin marketplace upgrade |
| Kiro IDE | Pilih Check for updates di panel Powers. |
| Kiro CLI | Jalankan git -C ~/.codeknit-power pull, lalu jalankan kiro-cli powers install ~/.codeknit-power lagi. |
Memperbarui plugin tidak akan memperbarui biner yang sudah terpasang. Untuk mengubah versi biner, atur CODEKNIT_VERSION seperti dijelaskan di atas.
Jika Anda meningkatkan codeknit dan ekstraksi berubah, ID simbol juga dapat berubah. Minta asisten untuk menghasilkan ulang semua keluaran alih-alih mencampur potongan dari berbagai eksekusi.
Apa yang diajarkan keterampilan kepada asisten
Section titled “Apa yang diajarkan keterampilan kepada asisten”Keterampilan ini memberikan aturan berikut kepada asisten, sehingga Anda tidak perlu mengulanginya di setiap permintaan:
- Pilih perintah berdasarkan pertanyaan.
parsemenjawab apa yang ada, di mana lokasinya, dan apa yang memanggil, mewarisi, atau mengandung apa.graph analyzemenemukan siklus, hub, kode mati, god class, dan hambatan.fingerprintmenemukan kandidat salin-tempel dan refaktor.
- Gunakan
directory-flatsebagai mode keluaran default. Asisten menulis file terpotong ke./skeleton/dan hanya membaca potongan yang diperlukan. Asisten menggunakan mode keluaraninlinehanya untuk satu file atau beberapa file, karenainlinemembuang semuanya ke jendela konteks. - Baca keluaran
.skt, bukan sumber mentah, untuk pertanyaan struktural. Asisten membuka file sumber hanya untuk memeriksa atau mengubah detail implementasi, menggunakan rentang baris dari keluaran.references/output-format.mdketerampilan berisi format lengkap. Lihat juga referensi format keluaran. - Pilih rentang kemiripan dan perlakukan kecocokan sebagai sinyal. Fingerprint membandingkan bentuk struktural, bukan maksud. Asisten membaca kedua simbol dari setiap pasangan sebelum mengusulkan refaktor.
Minta analisis struktural
Section titled “Minta analisis struktural”- Minta asisten untuk menganalisis struktur basis kode Anda. Misalnya: “Petakan struktur
./srcdan beri tahu saya modul mana yang bergantung pada paket auth.” - Asisten memastikan biner terpasang, lalu menjalankan
codeknit parsedengan sisi diaktifkan dan membaca keluaran.skt. - Ajukan pertanyaan lanjutan tentang dependensi, rantai panggilan, atau kode mati. Asisten menjawab dari keluaran.
- Untuk analisis yang lebih mendalam, minta tinjauan struktural. Misalnya: “Temukan dependensi siklik dan god class di
./src.” Asisten menjalankancodeknit graph analyzedan membaca laporan.
Hubungan yang ditandai [unresolved] atau [ambiguous] dalam keluaran tidak pasti, bukan dependensi yang dikonfirmasi. Perlakukan jawaban yang bergantung padanya sebagai kandidat untuk diverifikasi.
Untuk perintah di balik permintaan ini, lihat panduan perintah parse dan panduan perintah graf.
Minta deteksi duplikat
Section titled “Minta deteksi duplikat”- Minta asisten untuk menemukan kode yang diduplikasi. Misalnya: “Temukan fungsi salin-tempel di
./src.” - Asisten menjalankan
codeknit fingerprintdan membaca bagian[duplicates]dari./skeleton/fingerprints.skt. - Asisten membuka kedua simbol dari setiap pasangan yang ditandai, lalu mengusulkan refaktor.
- Jika hasilnya bising, minta asisten untuk menyesuaikan rentang kemiripan atau menambahkan pemeringkatan semantik ulang. Pemeringkatan ulang memerlukan server Ollama lokal dengan model embedding yang diunduh.
Untuk opsi di balik permintaan ini, lihat panduan perintah fingerprint.
- Ingatkan asisten untuk membaca file
.skt, bukan sumber mentah, untuk pertanyaan struktural. Hal ini menjaga konteks tetap kecil, karena formatnya ringkas dan menyimpan simbol, hubungan, dan rentang baris. - Gunakan
graph analyzeuntuk mendapatkan wawasan kualitas kode. Temuan adalah kandidat tinjauan, karena pemanggil eksternal dan pengiriman dinamis dapat mengubah hasil. - Jalankan fingerprint sebelum refaktor besar untuk menemukan salin-tempel yang harus dikonsolidasikan.
- Jika asisten menjalankan ulang
parseke direktori yang sudah berisi keluaran.skt, codeknit akan menolak untuk menulis. Minta asisten untuk menambahkan--cleanuntuk mengganti keluaran sebelumnya. - Jika unduhan biner gagal (offline atau platform tidak didukung), dapatkan rilis secara manual dari halaman rilis, atau lihat Pemasangan.
- Jika suatu eksekusi melaporkan hasil parsial, periksa stderr dan bagian
[errors]. Lihat keandalan analisis untuk detailnya.