Co zrobić, gdy to samo polecenie działa lokalnie, ale w Agent ma błędy składni?
Najpierw potwierdź rzeczywistą powłokę Agent, potem popraw parametry, cytowanie i ścieżki.
Punkt wykonania może używać innej powłoki
Nie oceniaj powłoki Agent tylko według systemu lub ręcznie otwartego terminala. W Windows zarówno aplikacja, jak i CLI preferują Git Bash, a przy jego braku używają cmd; nie jest to na stałe PowerShell. Aplikacje Unix wybierają dostępną powłokę użytkownika na hoście, a CLI używa bash dla zwykłych ścieżek poleceń. Zmiana punktu wejścia może zmienić interpretację tego samego tekstu.
Najpierw sprawdź ścieżki i cytowanie
Poproś Agent o potwierdzenie powłoki, potem obsłuż ścieżki ze spacjami, adresy z pytajnikami lub łącznikami i składnię parametrów danej platformy. Niektóre powłoki traktują nieujęte w cudzysłów znaki jako wzorce, powodując błędy podobne do braku pliku. Nie poprawiaj tylko jednego podejrzanego znaku, by dalej wykonywać serię; najpierw wydziel jedno sprawdzalne polecenie tylko do odczytu i obejrzyj wynik.
Odróżniaj składnię od brakujących narzędzi
Przy 'program not found' najpierw sprawdź instalację i ścieżki; przy odmowie dostępu — uprawnienia; dopiero błędy parsowania wymagają skupienia na składni powłoki. Nawet jeśli ostatnia część polecenia zakończyła się sukcesem, sprawdź wcześniejsze błędy, aby nie pominąć częściowego niepowodzenia. Potwierdź pojedynczy krok przed przywróceniem pełnego zadania; nie wymaga to domyślnie resetu tokenów ani podwyższenia uprawnień klienta.