32 lines
1.7 KiB
Markdown
32 lines
1.7 KiB
Markdown
---
|
|
name: safe-code-edit
|
|
description: Technika bezpiecznej edycji cudzego kodu przez agenta - minimalny diff, zasady użycia narzędzi plikowych, weryfikacja po każdej zmianie i postępowanie przy nieudanej edycji. Użyj przy każdej modyfikacji plików w repozytorium.
|
|
license: Apache-2.0
|
|
metadata:
|
|
owner: pubi-platform
|
|
version: "1.0.0"
|
|
---
|
|
|
|
# Bezpieczna edycja kodu
|
|
|
|
## Twarde zasady
|
|
|
|
1. **Czytaj przed pisaniem.** Nigdy nie wywołuj `replace_in_file` na pliku, którego nie odczytałeś
|
|
w tym przebiegu. Treść z planu nie jest dowodem na aktualny stan pliku.
|
|
2. **Najmniejszy możliwy diff.** Zmieniaj wyłącznie linie, które muszą się zmienić.
|
|
`write_file` (nadpisanie całości) jest dozwolone tylko dla plików, które sam utworzyłeś.
|
|
3. **Jedna intencja na edycję.** Nie łącz migracji API z poprawą literówki w komentarzu.
|
|
4. **Weryfikuj natychmiast.** Po zmianie pliku uruchom `run_verification`.
|
|
Jeśli wynik jest czerwony, napraw przyczynę zanim dotkniesz kolejnego pliku.
|
|
5. **Nie walcz z narzędziem.** Jeśli `replace_in_file` dwa razy nie znajdzie dopasowania -
|
|
odczytaj plik ponownie i dopasuj dokładny fragment ze spacjami. Trzecia porażka = zgłoś
|
|
`requires_human` z treścią fragmentu, zamiast nadpisywać plik w całości.
|
|
6. **Nie dotykaj plików spoza planu.** Rozszerzenie zakresu wymaga nowego planu.
|
|
|
|
## Gdy weryfikacja jest czerwona
|
|
|
|
- Przeczytaj **pełny** komunikat błędu, nie tylko ostatnią linię.
|
|
- Zlokalizuj plik i linię z traceback; napraw przyczynę, nie objaw.
|
|
- Nie modyfikuj testów, żeby przeszły. Test jest kontraktem.
|
|
- Jeśli po trzech próbach ten sam błąd - zatrzymaj się i zgłoś `requires_human` z pełnym logiem.
|