
# Mengelola dan Mengedit Pull Request Kontributor di GitHub
Table of Contents
Sebagai pemilik atau pengelola repositori open-source, kamu sering kali menerima Pull Request (PR) yang konsepnya bagus tetapi masih memiliki kekurangan kecil. Kekurangan tersebut bisa berupa typo nama variabel, format kode yang melenceng dari konfigurasi linter, atau tes unit yang kurang satu skenario.
Menunggu kontributor merespons review hanya untuk perbaikan satu baris kode dapat memperlambat proses rilis. Opsi yang jauh lebih cepat adalah turun tangan mengedit branch PR tersebut secara langsung tanpa menghilangkan hak atribusi kontributor asli.
Berikut panduan teknis mengelola, mengedit, dan menegakkan hak akses pada PR kontributor di GitHub.
1. Mengedit PR Kontributor Secara Langsung
GitHub memungkinkan maintainer repositori upstream untuk mengirim commit langsung ke branch milik kontributor selama izin akses diberikan.
Menggunakan GitHub CLI (gh)
Cara tercepat dan paling minim konfigurasi adalah menggunakan GitHub CLI. Perintah ini otomatis menambahkan remote fork kontributor, mengambil branch terkait, dan berpindah ke branch lokal:
gh pr checkout 42Ganti 42 dengan nomor PR yang ingin kamu edit. Setelah berada di branch lokal tersebut, lakukan perbaikan kode:
# Lakukan perubahan file, lalu simpan ke staginggit add src/config.tsgit commit -m "fix(config): perbaiki format url endpoint"
# Kirim perubahan langsung ke branch fork kontributorgit pushGit akan otomatis mengarahkan proses push ke remote fork milik kontributor tempat PR tersebut berasal.
Menggunakan Git Standar (Tanpa gh)
Jika kamu tidak menggunakan GitHub CLI, tambahkan repositori fork kontributor sebagai remote baru secara manual:
# 1. Daftarkan remote fork milik kontributorgit remote add kontributor https://github.com/username-kontributor/nama-repo.git
# 2. Ambil referensi branch dari fork tersebutgit fetch kontributor nama-branch-fitur
# 3. Buat branch lokal yang melacak branch kontributorgit checkout -b review-pr-42 kontributor/nama-branch-fitur
# 4. Lakukan revisi kode dan commitgit add src/config.tsgit commit -m "fix(config): sesuaikan tipe data port"
# 5. Push commit ke branch di fork kontributorgit push kontributor HEAD:nama-branch-fiturAlternatif lain untuk membaca kode tanpa remote tambahan adalah memanfaatkan refspec tersembunyi GitHub:
git fetch origin pull/42/head:pr-42git checkout pr-42Namun, perintah refspec di atas hanya bersifat read-only dari sisi remote origin. Untuk melakukan push balik, remote fork kontributor tetap wajib didaftarkan dengan kredensial akunmu yang memiliki hak tulis ke repositori upstream.
2. Mempertahankan Atribusi Kontributor dan Maintainer (Co-Author)
Ketika maintainer mengambil alih penyelesaian branch atau melakukan squash merge, nama kontributor tidak boleh hilang dari riwayat git. GitHub mendukung metadata co-author melalui trailer commit message standar.
Format Trailer Co-authored-by
Format trailer harus diletakkan pada bagian paling bawah commit message, dipisahkan oleh minimal satu baris kosong dari badan pesan:
feat(auth): tambahkan verifikasi token oauth2
Implementasikan validasi payload jwt dan penanganan error token expired.
Co-authored-by: Budi Santoso <[email protected]>Co-authored-by: Dika Ardnt <[email protected]>Aturan penulisan co-author agar dikenali oleh GitHub:
- Awali baris dengan tulisan persis
Co-authored-by:(perhatikan tanda titik dua dan huruf kapital). - Tulis nama kontributor diikuti alamat email di dalam kurung siku (
<email>). - Email yang digunakan harus sesuai dengan email yang terhubung ke akun GitHub kontributor agar foto profil mereka muncul di samping commit.
- Jangan meletakkan teks apa pun di bawah baris trailer co-author.
Membuat Commit Co-Author Lewat Terminal
Kamu bisa menyusun commit co-author langsung melalui argumen -m bertingkat:
git commit -m "feat(api): validasi skema payload" \ -m "Menambahkan pengecekan tipe data pada field webhook." \Mempertahankan Kredit Saat Squash Merge
Jika kamu menggabungkan PR melalui fitur Squash and merge di web UI GitHub, riwayat commit di branch PR akan dilebur menjadi satu commit tunggal di branch utama (main).
Secara default, GitHub otomatis menambahkan baris Co-authored-by untuk setiap kontributor yang memiliki commit di branch tersebut ke dalam kotak teks deskripsi merge. Pastikan kamu tidak menghapus baris trailer tersebut sebelum menekan tombol konfirmasi merge.
3. Mengatur Izin Allow edits from maintainers
Fitur Allow edits from maintainers (properti API: maintainer_can_modify) memberi hak tulis sementara kepada maintainer upstream untuk melakukan push ke branch fork kontributor.
Batasan Arsitektur GitHub
Dari sisi arsitektur otorisasi GitHub:
- Centang izin ini berada di form pembukaan PR pada antarmuka kontributor.
- Secara default, GitHub selalu mencentang opsi ini secara otomatis setiap kali kontributor membuat PR dari fork akun personal.
- Maintainer repositori upstream tidak memiliki akses tombol untuk mencentang opsi ini jika kontributor sengaja mematikannya. Nilai izin ini sepenuhnya dipegang oleh pembuat PR.
Menegakkan Izin Secara Otomatis (CI Enforcement)
Karena maintainer tidak bisa mencentang opsi tersebut dari UI sendiri, cara terbaik untuk memaksa kepatuhan adalah menggunakan GitHub Actions. Workflow ini akan memvalidasi status maintainer_can_modify. Jika kontributor mematikan izin tersebut, CI akan langsung gagal dan bot memberikan komentar peringatan.
Buat file alur kerja baru di .github/workflows/pr-maintainer-edit-check.yml:
name: Check Maintainer Edit Permission
on: pull_request_target: types: [opened, synchronize, reopened]
jobs: verify-permission: runs-on: ubuntu-latest if: github.event.pull_request.head.repo.full_name != github.repository steps: - name: Validasi Opsi maintainer_can_modify env: CAN_MODIFY: ${{ github.event.pull_request.maintainer_can_modify }} PR_NUMBER: ${{ github.event.pull_request.number }} GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} run: | if [ "$CAN_MODIFY" != "true" ]; then gh pr comment "$PR_NUMBER" --body "Halo @${{ github.event.pull_request.user.login }}, repositori ini mewajibkan opsi **Allow edits from maintainers** diaktifkan agar tim maintainer dapat membantu memperbaiki kode atau menyelaraskan branch sebelum merge. Silakan centang kotak tersebut di sidebar kanan PR ini." gh pr edit "$PR_NUMBER" --add-label "need-maintainer-access" echo "Error: Opsi 'Allow edits from maintainers' belum dicentang oleh kontributor." exit 1 fi echo "Izin edit maintainer aktif."Dengan alur kerja ini:
- Trigger menggunakan
pull_request_targetagar memiliki izin membaca context PR dari fork luar dengan aman. - Kondisi
github.event.pull_request.head.repo.full_name != github.repositorymemastikan pengecekan hanya berjalan untuk PR yang berasal dari fork, bukan branch internal repo. - Status check akan berstatus merah (failing status check), sehingga aturan branch protection di branch utama (
main) dapat memblokir tombol merge sampai kontributor mencentang izin tersebut.
Solusi Saat Kontributor Tidak Merespons
Jika kontributor tidak kunjung mengaktifkan izin tersebut dan perbaikan harus segera dirilis, maintainer dapat menyalin commit mereka ke branch internal baru:
# Ambil patch dari PR kontributor ke branch lokal barugit checkout -b fix/salinan-pr-42 maingit pull https://github.com/username-kontributor/nama-repo.git nama-branch-fitur
# Lakukan perbaikan tambahangit commit -am "fix: perbaiki typo konfigurasi"
# Push ke repositori upstream utamagit push origin fix/salinan-pr-42Tutup PR lama milik kontributor dengan menyertakan tautan ke PR baru atau commit baru, dan pastikan commit tetap menyematkan atribusi Co-authored-by kontributor.
4. Mengelola Akses Maintainer Terhadap Branch Fork
Bekerja langsung pada branch milik repositori orang lain memiliki aturan dan dinamika akses yang berbeda dibanding branch internal.
Fork Personal vs Fork Organisasi
Aturan penting yang sering membingungkan maintainer:
- Fork dari akun personal: Mendukung
maintainer_can_modify. Maintainer repositori upstream otomatis diberi izin push jika opsinya aktif. - Fork di bawah akun Organisasi GitHub: GitHub tidak mendukung opsi
Allow edits from maintainersuntuk PR yang dibuat dari fork milik organisasi. Jika sebuah tim mengirim PR dari repositori organisasi mereka, maintainer upstream tidak akan pernah bisa melakukan push langsung ke branch tersebut. Perbaikan harus dikomunikasikan lewat review code atau maintainer membuat branch internal sendiri.
Masa Berlaku Hak Akses
Izin push ke branch fork bersifat sementara. Hak akses maintainer terhadap branch kontributor otomatis dicabut segera setelah PR ditutup atau selesai di-merge. Maintainer juga tidak memiliki hak akses ke branch lain atau pengaturan repositori fork milik kontributor.
Pengaruh Branch Protection di Fork
Meskipun kontributor sudah mencentang Allow edits from maintainers, maintainer tetap bisa gagal melakukan push jika kontributor mengaktifkan Branch Protection Rule pada repositorinya sendiri. Misalnya:
- Mewajibkan signed commits (GPG/SSH sign).
- Melarang force push.
Jika kamu mencoba menjalankan git push --force ke branch fork yang dilindungi, Git akan menolak dengan pesan error GH006: Protected branch update failed.
Praktik Aman Saat Mengedit Branch Kontributor
- Hindari Force Push Sembarangan: Jangan menjalankan
git push --forceatau melakukan rebase agresif di branch kontributor tanpa berdiskusi terlebih dahulu. Kontributor yang masih aktif bekerja di branch lokal mereka akan mengalami konflik riwayat (diverged branches). - Gunakan Commit Tambahan: Tambahkan commit baru di atas commit kontributor alih-alih meng-amend commit mereka. Riwayat commit akan lebih transparan dan kontributor bisa mempelajari perbaikan yang kamu lakukan lewat
git pull. - Komunikasikan Perubahan di Kolom Komentar PR: Beri tahu kontributor bahwa kamu telah menambahkan commit perbaikan ke branch mereka agar mereka mengetahui status kode terbaru sebelum melanjutkan pengujian.
