agentic-codemod-pipeline/.apm/skills/safe-code-edit/SKILL.md

name, description, license, metadata

name	description	license	metadata
safe-code-edit	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.	Apache-2.0	owner version pubi-platform 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.