Bagaimanakah ejen pengekodan boleh membaiki pepijat, menjalankan ujian, dan melakukan commit sementara anda kekal mengawal?

Question

Accepted Answer

**Ejen** pengekodan boleh memacu pembaikan pepijat dari hujung ke hujung — menghasilkan semula, mencari lokasi, membaiki, mengesahkan, melakukan commit — tetapi anda kekal mengawal dengan mengehadkan gelung itu menggunakan **kebenaran berskop, kelulusan manusia, dan langkah kecil yang boleh diterbalikkan**. Ejen melakukan penaipan; anda memutuskan apa yang sebenarnya mendarat.

## Gelungnya

```text
1. REPRODUCE  → write/run a failing test that demonstrates the bug (red)
2. LOCATE     → search the codebase, read the relevant files, form a hypothesis
3. PROPOSE    → draft a minimal fix (you can review the plan before any edit)
4. VERIFY     → run tests + lint/typecheck → fix is proven by the test going green
5. REVIEW     → show the DIFF for your approval (nothing committed yet)
6. COMMIT     → only after approval, on a branch, with a clear message
```

Idea utamanya ialah **pengesahan dipacu ujian**: ejen tidak mendakwa "sudah dibaiki" — ia membuktikannya dengan membuat ujian yang gagal menjadi lulus. Ujian gagal dari langkah 1 ialah isyarat objektif bahawa perubahan itu berjaya.

## Mekanisme kawalan

```text
- SCOPED PERMISSIONS → allowlist safe commands (test, lint); prompt for the rest
- APPROVAL GATES     → human confirms destructive/irreversible actions + the final commit
- SMALL STEPS        → one focused change at a time → easy to review and revert
- BRANCH / WORKTREE   → work isolated from main; throw it away if it goes wrong
- DIFF REVIEW        → read the actual diff before commit, not just the agent's summary
```

```bash
# The agent runs the suite itself and reports the result before proposing a commit
npm test -- --runInBand   # red before the fix, green after → objective verification
git diff                  # you review every line that will be committed
```

Menjalankannya dalam **branch atau git worktree** bermaksud kes terburuk ialah `git checkout main` — eksperimen itu tidak pernah menyentuh keadaan kerja anda. Commit yang kecil dan boleh diterbalikkan menjadikan mana-mana langkah tunggal mudah diperiksa dan dibatalkan.

## Mengapa ia penting

Pengekodan agentik mengalihkan anda daripada menaip setiap baris kepada **menyemak dan mengemudi**. Leverage itu nyata, tetapi begitu juga risiko ejen menghantar perubahan yang salah atau merosakkan dengan yakin. Mengekalkan gerbang kelulusan manusia sebelum commit, mengesahkan dengan ujian dan bukannya mempercayai prosa, serta mengasingkan kerja dalam branch membolehkan anda menangkap kelajuan automasi sambil kekal sebagai orang yang memutuskan apa yang mencapai `main`.