Peta dahulu, semakan kemudian

Dua tugas berbeza berada di kedua-dua belah pull request. Sebelum ejen menulis, ia memerlukan peta pokok yang bakal diubahnya. Selepas ejen membuka PR, sesuatu perlu membaca perubahan itu berbanding selebihnya sistem dan meninggalkan komen yang boleh dijadikan tindakan oleh manusia.

Tugas-tugas ini kelihatan serupa dari jauh kerana kedua-duanya melibatkan ‘memahami pangkalan kod’. Ia bukan produk yang sama. Satu menjawab ‘di manakah perubahan ini sepatutnya mendarat?’. Satu lagi menjawab ‘apa yang dirosakkan diff ini yang akan terlepas pandang oleh linter baris demi baris?’. Mencampurkannya menghasilkan draf pertama yang lebih teruk dan semakan yang lebih bising.

Tulisan ini ialah panduan aliran kerja bersama. Maguyva ialah peta yang disoal ejen dahulu. Greptile ialah ejen semakan yang mengulas PR selepas itu. Pasangan ini saling melengkapi mengikut binaan: Maguyva tidak menyemak pull request, dan Greptile tidak menggantikan lapisan konteks yang digunakan ejen untuk menulisnya.

Kenapa pembahagian ini berguna

Ejen pengekodan yang bermula daripada prasyarat latihan ditambah beberapa fail yang ditampal akan mereka-reka laluan yang munasabah dan mengeditnya. Itu adalah kegagalan ‘fail yang salah’, dan ia adalah masalah pengambilan semula. Maguyva ialah lapisan konteks pangkalan kod MCP jauh: pengambilan semula semantik, struktur (AST), graf/kebergantungan dan teks digabungkan menjadi hasil berperingkat, ditambah carian simbol dan pengambilan fail. Jawapan yang berasas kembali sebagai path/file.ext:line, supaya anda boleh menolak kesilapan sebelum tampalan wujud. Dakwaan itu kekal sederhana: perubahan berhalusinasi yang lebih sedikit. Model masih boleh meneka. Cuma langkah pertama berhenti menjadi tekaan.

Greptile ialah ejen semakan kod berkuasa AI. Dengan kata-kata mereka sendiri, ia secara automatik menyemak setiap pull request dengan pemahaman penuh tentang pangkalan kod, dan meletakkannya bertentangan dengan linter tradisional yang menyemak fail secara berasingan berbanding keseluruhan sistem. Persediaan terdiri daripada memasang aplikasi GitHub atau GitLab dan memilih repositori. Tiada indeks tempatan yang perlu anda jalankan. Pengehosan ialah Greptile Cloud (mereka menyatakan pematuhan SOC 2 Type II, dengan laporan yang tersedia atas permintaan), dengan pilihan hos sendiri yang ditawarkan kepada perusahaan.

Aliran bernombor mereka sendiri ialah: sambung dan bina graf kebergantungan bagi setiap fungsi, kelas dan kebergantungan; pada setiap pull request, analisis perubahan menggunakan graf repo penuh itu dan terbitkan penemuan sebagai komen PR dengan pembetulan yang dicadangkan, dalam kira-kira tiga minit; setiap komen boleh menyerahkan isu kepada ejen pengekodan yang sudah digunakan pasukan. Mereka juga menyatakan membaca komen PR manusia terdahulu dari semasa ke semasa untuk mempelajari standard kod sesebuah pasukan dan mengurangkan cadangan yang bising. Sistem pembelajaran mereka, menurut mereka sendiri, memerlukan 2-3 minggu untuk menyesuaikan diri.

Itu adalah semakan, bukan penulisan draf. Kekuatan Greptile ialah konteks graf repo penuh terhadap perubahan yang sudah mendarat dalam PR, diikuti gelung tertutup yang menghantar penemuan itu ke Claude Code, Codex, Conductor, Cursor, atau Devin. Kekuatan Maguyva ialah peta berperingkat yang disoal ejen sebelum perubahan itu ditulis. Gunakan kedua-duanya. Jangan minta salah satu melakukan kerja yang lain.

Integrasi produk pihak pertama antara Maguyva dan Greptile tidak dinyatakan. Anda juga tidak memerlukannya. Maguyva bercakap dengan ejen melalui MCP. Greptile bercakap dengan GitHub atau GitLab melalui aplikasi mereka sendiri. Mereka bertemu di pull request. Tiada skrip pelekat, tiada cron yang menyalurkan satu alat ke alat yang lain. Pasangan ini tidak memerlukan bash kerana setiap produk sudah duduk pada permukaan yang menjadi miliknya.

Apa ini bukan

Ini bukan penghancuran Greptile. Ini bukan halaman ‘tukar penyemak anda’. Greptile dilancarkan di Hacker News pada 5 Mac 2024 sebagai syarikat Y Combinator W24, dan thread itu adalah cara ramai orang mula-mula mengenali produk ini. Jika begitulah caranya anda menemui mereka, teruskan menggunakan mereka. Halaman ini ialah separuh depan yang hilang daripada gelung itu: mensauhkan ejen terlebih dahulu supaya PR yang dilihat Greptile sudah menyasarkan fail yang betul.

Bahan pemasaran Greptile diketuai dengan dakwaan kelajuan semakan dan penangkapan pepijat. Anggap itu sebagai dakwaan Greptile sendiri, bukan angka yang disahkan secara bebas. Tulisan ini tidak mengulanginya sebagai fakta.

Liputan bahasa adalah kejujuran jenis yang sama. Greptile membingkai sokongan sebagai meliputi semua bahasa pengaturcaraan berbanding senarai yang disenaraikan; angka tepat tidak dinyatakan. Maguyva menerbitkan sokongan untuk lebih daripada 279 bahasa dan teknologi berasaskan teks, dengan pembahagian teknikal (AST disokong parser berbanding teks sahaja) di laman sesawang apabila soalannya teknikal. Ini adalah produk berbeza yang membuat dakwaan berbeza. Jangan campurkannya.

Harga Greptile tidak dinyatakan dalam bahan yang boleh digunakan tulisan ini. Pelan berbayar wujud; lihat halaman harga mereka. Maguyva mengenakan bayaran mengikut ruang kerja, bukan mengikut tempat duduk. Pelan bermula secara percuma. Halaman harga menyenaraikan peringkat yang diterbitkan jika anda memerlukan angka ruang kerja.

Aliran kerja

Tiga peringkat yang dinamakan. Laksanakan mengikut susunan ini. Jangan langkau mana-mana daripadanya pada kali pertama anda mencuba pasangan ini.

1. Konteks Maguyva

Indeks satu repositori yang sudah anda kenali. Sambungkan klien MCP tempat anda sudah menulis — Claude Code, Cursor, Codex CLI, VS Code, Windsurf, atau klien serasi MCP lain. Maguyva mempunyai panduan persediaan untuk 24 klien MCP yang didokumenkan dan boleh berhubung dengan klien lain yang menyokong konfigurasi MCP standard.

Tanya satu soalan yang boleh anda nilai sebelum sesiapa menulis satu baris. ‘Di manakah tamat tempoh sesi dikendalikan, dan apa yang memanggilnya?’ adalah langkah pertama yang lebih baik daripada ‘betulkan auth’. Tuntut petikan. Buka hasil file.ext:line. Ikuti simbol itu. Sahkan kebergantungan yang bakal anda sentuh.

Maguyva mendedahkan 11 alat MCP yang berorientasikan pelanggan merentasi carian, simbol, analisis kebergantungan, pengambilan fail, konteks repositori dan aliran kerja alat utiliti deterministik. Empat mod pengambilan semula digabungkan menjadi hasil berperingkat; find_symbol ialah alat berasingan apabila anda sudah tahu namanya. Dokumentasi menerangkan laluan terpendek: mula secara percuma, indeks repo yang sudah anda kenali, sambungkan klien, kemudian tanya satu soalan yang boleh anda sahkan.

Snapshot mempunyai cap masa, supaya ejen boleh memberitahu versi pokok mana yang sedang dibacanya. Batasan yang jujur ialah kerja tempatan yang tidak diselaraskan. Jika perubahan hanya wujud dalam pokok kerja dan belum di-push, peta yang dihoskan masih belum mengandungi perubahan itu. Fail arahan (CLAUDE.md, AGENTS.md) masih mempunyai tempat di sini, untuk konvensyen dan apa yang tidak sepatutnya disentuh. Ia bukan peta yang hidup. Gunakan untuk tingkah laku. Gunakan Maguyva untuk fakta.

Jangan benarkan ejen membuka PR sebelum petikan bertahan sentuhan dengan repo. Pintu gerbang itu adalah keseluruhan tujuan peringkat ini.

2. PR ejen

Ejen yang sama kini menulis perubahan dalam klien yang sudah anda bayar. Maguyva bukan editor mahupun penyemak. Ejen masih menghasilkan diff. Anda masih membuka pull request pada GitHub atau GitLab sebagaimana yang sudah anda lakukan.

Apa yang sepatutnya berbeza ialah fail pertama. PR sepatutnya menamakan pengendali yang benar-benar melaksanakan tingkah laku itu, pemanggil yang akan rosak, dan ujian yang akan gagal jika perubahan itu salah. Jika peringkat 1 dilangkau, peringkat 3 akan membazir komennya pada perubahan yang mendarat di pakej yang salah. Greptile masih boleh menemui masalah sistemik. Ia tidak sepatutnya turut perlu pulih daripada laluan yang berhalusinasi.

Kekalkan PR terhad. Fail pertama yang berasas bukan lesen untuk menulis semula modul. Pasangan yang saling melengkapi ini berfungsi apabila ejen melakukan satu kerja dengan peta, kemudian meminta penyemak melakukan kerja lain pada diff yang terbatas.

3. Semakan Greptile

Greptile sudah bersambung dengan repositori melalui aplikasi GitHub atau GitLab. Pada pull request baharu, ia menganalisis perubahan menggunakan graf repo penuh yang dibinanya, dan menerbitkan penemuan sebagai komen dengan pembetulan yang dicadangkan. Bahan mereka sendiri meletakkan langkah ini pada kira-kira tiga minit.

Baca komen sebagaimana anda akan membaca rakan sepasukan yang teliti: buka lokasi yang dipetik, putuskan sama ada penemuan itu benar, kemudian bertindak. Di mana Greptile menawarkan ‘Fix with your Agent’, ia menghantar isu — laluan fail, nombor baris, kod yang dicadangkan — kepada Claude Code, Codex, Conductor, Cursor, atau Devin. ‘Fix All’ menghantar semua isu dalam semakan itu sekali gus. Mereka juga menyediakan Greptile MCP dan pemalam Claude Code untuk penyerahan itu. Maguyva tiada dalam senarai sasaran bernama itu; ketiadaan itu bukan masalah. Maguyva sudah melakukan kerjanya di peringkat 1. Ejen pengekodan yang menulis PR itu ialah pihak yang sepatutnya menerima muatan pembetulan.

Harapkan bunyi bising pada 2-3 minggu pertama sementara sistem pembelajaran Greptile menyesuaikan diri dengan komen yang benar-benar ditinggalkan pasukan anda. Itu jadual yang mereka nyatakan, bukan kecacatan pasangan itu. Semakan manusia kekal dalam gelung itu. Greptile ialah langkah pertama automatik, bukan butang gabung.

Jika komen Greptile menunjuk kepada fail yang tidak pernah disoal ejen di peringkat 1, itu isyarat yang berguna. Sama ada peta terlepas pandang seorang pemanggil, atau ejen melangkau satu petikan. Betulkan draf itu mengikut komen. Jangan lumpuhkan penyemak itu.

Cara mengekalkan pelengkap ini jujur

• Maguyva sentiasa dahulu. Semakan PR dengan fail yang salah tetap sahaja semakan fail yang salah.
• Greptile sentiasa selepas itu. Draf yang dipetik dengan baik masih memerlukan bacaan diff pada peringkat keseluruhan sistem.
• Jangan minta Maguyva menerbitkan komen PR. Ia tidak melakukan itu.
• Jangan minta Greptile menjadi lapisan pengambilan semula pertama ejen sementara ia masih memilih laluan. Itu bukan kerja yang direka untuk aplikasi GitHub atau GitLab mereka.
• Jangan reka-reka saluran paip bash yang ‘menyegerakkan’ kedua-duanya. PR ialah antara muka itu.
• Sahkan kedua-dua belah secara berasingan. Indeks repo yang sudah anda kenali. Tanya satu soalan yang boleh anda sahkan. Kemudian buka PR kecil dan baca apa yang sebenarnya dikomen Greptile.

Gelung itu menjadi biasa sebaik sahaja diberi nama. Peta dahulu. PR ejen. Semakan selepas itu. Setiap produk kekal pada sisi pull request yang menjadi kepakarannya.

// map first. review second. in that order.