Как агент кодирования может исправить ошибку, запустить тесты и сделать коммит, оставаясь под вашим контролем?

Question

Accepted Answer

**Агент** кодирования может провести исправление ошибки от начала до конца — воспроизвести, найти, исправить, проверить, сделать коммит — но вы остаетесь в контроле, ограничивая цикл **ограниченными разрешениями, человеческим одобрением и небольшими обратимыми шагами**. Агент печатает код; вы решаете, что на самом деле попадает в `main`.

## Цикл

```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
```

Ключевая идея — **проверка, управляемая тестами**: агент не претендует на "исправлено" — он доказывает это, заставляя падающий тест пройти. Падающий тест из шага 1 — это объективный сигнал того, что изменение сработало.

## Механизмы контроля

```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
```

Запуск на **ветке или git worktree** означает, что в худшем случае это `git checkout main` — эксперимент никогда не трогал ваше рабочее состояние. Небольшие обратимые коммиты упрощают проверку и отмену любого отдельного шага.

## Почему это важно

Автоматизированное кодирование переводит вас с печати каждой строки на **проверку и управление**. Преимущество реально, но также реален риск того, что агент уверенно отправит неправильное или разрушительное изменение. Сохранение шлюза человеческого одобрения перед коммитами, проверка тестами вместо доверия к тексту и изоляция работы в ветке позволяют вам получить скорость автоматизации, оставаясь тем, кто решает, что попадает в `main`.