Patch dari asisten AI tetap perlu diverifikasi sebelum merge. Alur yang efektif dimulai dengan memeriksa diff dan konteks file di Vim, menelusuri perilaku yang berubah, lalu menjalankan test terarah sebelum suite yang lebih luas. Test yang lolos menambah keyakinan, tetapi tidak membuktikan bahwa patch benar untuk semua kasus.

Vim berguna sebagai alat kendali dalam proses ini: tampilkan perubahan, lompat ke bagian relevan, cari pemanggil fungsi, dan cocokkan implementasi dengan test. Jalankan perintah Git dan test dari terminal agar hasilnya dapat diperiksa secara eksplisit, tanpa bergantung pada plugin tertentu.

1. Periksa diff dan konteks file di Vim

Mulai dengan memastikan cakupan perubahan. Jangan langsung membaca patch per baris tanpa mengetahui file apa saja yang disentuh dan apakah ada perubahan lain di working tree.

git status --short
git diff --stat
git diff --check
git diff -- path/to/file.py

git diff --check membantu menemukan whitespace bermasalah, tetapi bukan pemeriksa kebenaran kode. Periksa juga perubahan yang sudah di-stage secara terpisah dengan git diff --cached. Hindari menganggap seluruh diff berasal dari AI jika working tree sudah berisi pekerjaan lain.

Buka file yang berubah di Vim, lalu gunakan navigasi dasar untuk membaca implementasi dan konteks sekitarnya:

vim path/to/file.py
  • /nama_fungsi mencari fungsi atau simbol; tekan n untuk hasil berikutnya.
  • gd menuju definisi lokal simbol di bawah kursor jika Vim dapat mengenalinya.
  • Ctrl-o kembali ke posisi sebelumnya setelah berpindah lokasi.
  • :set number menampilkan nomor baris untuk merujuk bagian tertentu.

Vim standar tidak menyediakan tampilan diff Git terintegrasi untuk semua alur kerja. Baca diff melalui git diff di terminal, atau muat dua versi file ke buffer Vim dan gunakan :diffthis pada masing-masing buffer. Untuk meninjau patch, pastikan tetap membandingkan versi yang benar—misalnya working tree terhadap indeks, bukan dua salinan yang sama.

2. Telusuri perubahan sampai ke perilaku yang terdampak

Untuk setiap perubahan, tanyakan: input apa yang diterima, kondisi apa yang berubah, dan siapa yang bergantung pada perilaku tersebut? Baca fungsi pemanggil, pemanggil balik, validasi, serta test yang terkait. Pencarian lintas repositori dengan git grep sering lebih cepat daripada hanya membaca file yang diubah.

git grep -n "nama_fungsi"
git grep -n "nama_endpoint" -- '*.py'

Periksa batas kasus yang mudah terlewat: nilai kosong atau null, input tidak valid, batas angka dan tanggal, urutan pemrosesan, kegagalan jaringan, izin akses, serta perubahan format data. Jika patch mengubah kontrak API atau skema, telusuri konsumen dan migrasi terkait. Jangan menyimpulkan keamanan atau kompatibilitas hanya dari nama fungsi maupun komentar.

Waspadai risiko regresi ketika patch mengubah kondisi cabang, nilai bawaan, penanganan error, transaksi, caching, atau operasi yang dipakai banyak jalur. Perubahan kecil pada fungsi bersama dapat berdampak lebih luas daripada ukuran diff yang terlihat.

3. Jalankan test terarah, lalu suite relevan

Mulai dari test yang paling dekat dengan perilaku yang berubah. Gunakan perintah proyek yang sudah tersedia; contoh berikut hanya menggambarkan pola umum, bukan asumsi tentang struktur repositori tertentu.

# Python dengan pytest
pytest tests/test_parser.py -k "rejects_invalid_input"

# Node.js dengan skrip test proyek
npm test -- --runInBand

# Go, pada modul atau paket yang relevan
go test ./internal/parser

Sesuaikan sintaks dengan test runner dan skrip proyek. Beberapa runner tidak meneruskan argumen dengan cara yang sama. Periksa dokumentasi lokal atau skrip konfigurasi proyek sebelum mengandalkan opsi tertentu.

Jika test terarah lolos, jalankan suite yang mencakup komponen terdampak, kemudian pemeriksaan lain yang diwajibkan proyek, seperti lint, pemeriksaan tipe, atau test integrasi. Test terarah memberi umpan balik cepat; suite lebih luas membantu menangkap interaksi yang tidak terlihat pada satu unit. Catat perintah dan hasilnya agar reviewer lain dapat mengulang pemeriksaan.

4. Evaluasi kegagalan dan flaky test

Jika test gagal, baca pesan error dan bandingkan kegagalan dengan perilaku patch. Bedakan kegagalan yang diperkenalkan patch dari kegagalan yang sudah ada, masalah lingkungan, atau test yang tidak stabil. Jangan menutupi kegagalan dengan menghapus assertion atau memperlemah test tanpa memahami kontrak yang diuji.

Flaky test dapat gagal secara tidak konsisten karena waktu, konkurensi, urutan eksekusi, ketergantungan eksternal, atau data bersama. Jalankan ulang untuk mengumpulkan bukti, tetapi jangan menjadikan satu kali sukses sebagai bukti bahwa patch benar. Jika memungkinkan, ulangi test yang sama dalam kondisi setara dan periksa log, seed acak, serta ketergantungan jaringan atau waktu. Laporkan kegagalan yang belum terjelaskan; jangan mengubah test menjadi dilewati hanya agar pemeriksaan tampak hijau.

Test yang lolos tetap memiliki batas: test mungkin tidak mencakup jalur baru, assertion mungkin hanya memeriksa sebagian hasil, dan test yang ada dapat mengabadikan asumsi yang salah. Cocokkan hasil test dengan spesifikasi, kode pemanggil, dan kasus batas yang relevan.

5. Checklist review sebelum merge

  • Apakah semua file yang berubah memang diperlukan dan tidak ada perubahan tak terkait?
  • Apakah implementasi sesuai dengan kontrak, termasuk input tidak valid dan kondisi batas?
  • Apakah perubahan memengaruhi pemanggil, API, format data, izin, atau penanganan error?
  • Apakah test terarah mencakup perilaku baru dan kasus kegagalan yang penting?
  • Apakah suite relevan dan pemeriksaan proyek lain sudah dijalankan?
  • Apakah setiap kegagalan atau hasil yang tidak stabil sudah dijelaskan, bukan sekadar diulang sampai lolos?
  • Apakah diff bersih dari perubahan tak disengaja dan dapat dipahami reviewer berikutnya?

Setelah perubahan terakhir, periksa ulang git diff dan status working tree. Review yang baik menghubungkan setiap bagian patch dengan perilaku yang diharapkan, bukti test, dan risiko yang masih tersisa. Jika ada hal yang belum dapat diverifikasi, nyatakan secara jelas sebelum merge.