Tutorial 1 Orientation pl

Samouczek 1 · Orientacja

Cel: uruchomić projekt, poznać swojego agenta AI i raz uruchomić bramkę testową — aby wszystko po tym było pamięcią mięśniową.

← Powrót do Strona główna · Dalej: Samouczek 2 Jak działa kod

---

1. Dlaczego aplikacja-żart?

Naukę pracy z agentem kodowania najłatwiej zacząć, gdy kod jest mały, prawdziwy i niskiego ryzyka. LockedIn CLI jest wszystkimi trzema:

• Mały: jeden plik rdzenia, jeden punkt wejścia, jeden zestaw testów, zero zależności.
• Prawdziwy: instaluje się jako globalna komenda lockedin i zachowuje jak autentyczne AI CLI.
• Niskiego ryzyka: to satyra. Jeśli Twój agent uczyni humblebragi o 20% skromniejszymi, nikt nie dostanie alertu.

Ta kombinacja pozwala skupić się na prawdziwej umiejętności: dobrze opisać zmianę, pozwolić agentowi wykonać pracę i zweryfikować wynik.

2. Pobierz kod

git clone https://github.com/xjamesmorris/lockedin-cli.git
cd lockedin-cli

Sprawdź swoją wersję Node (potrzeba 18+):

node --version

Nie ma nic do zainstalowania — żadnego npm install zależności, bo ich nie ma. To celowe: mniej ruchomych części, więcej nauki.

3. Uruchom to

Wypróbuj prawdziwą rzecz:

node bin/lockedin.js            # ekran powitalny + baner
node bin/lockedin.js post       # wygenerowany post o „przywództwie myślowym”
node bin/lockedin.js aura       # przeskanuj swoją zawodową aurę
node bin/lockedin.js            # (bez argumentów) przechodzi do sesji czatu

Wpisz /help w sesji, poklikaj, a potem /exit. Wszystko, co widzisz, jest generowane lokalnie z pul słów — bez sieci, bez kont. Pełna lista komend: Podręcznik komend.

4. Uruchom bramkę testową

To najważniejsza komenda w całym samouczku:

npm test

Powinieneś zobaczyć ścianę zielonych ptaszków kończącą się czymś w rodzaju pass 318. Ten zestaw to Twoja siatka bezpieczeństwa. Od tej chwili przepływ jest zawsze taki:

zmień coś → npm test → wysyłaj tylko, jeśli jest zielone.

5. Poznaj swojego agenta

Otwórz swojego agenta kodowania w folderze projektu, aby widział pliki. Z GitHub Copilot CLI to:

copilot

Następnie, aby się zorientować, poproś agenta, aby zorientował Ciebie (jeszcze nic nie zmieniając). Wypróbuj prompt w rodzaju:

„Daj mi dwuakapitowe oprowadzenie po tym repozytorium: do czego służy każdy plik i folder najwyższego poziomu oraz jak uruchamiam aplikację i testy. Nic nie zmieniaj.”

Porównaj jego odpowiedź z tym, co zobaczyłeś w krokach 3–4. Przyzwyczajenie się do proszenia agenta, aby wyjaśnił, zanim edytuje, to kluczowy nawyk — będziemy się na nim mocno opierać.

---

✅ Wypróbuj ze swoim agentem

1. Zapytaj agenta: „Co wypisuje node bin/lockedin.js reflect 'moja kawa była zimna' i który plik decyduje o tym wyjściu?” Potwierdź jego odpowiedź, uruchamiając komendę samodzielnie.
2. Poproś go, aby uruchomił zestaw testów i podał wynik: „Uruchom npm test i powiedz mi, ile testów przechodzi.”

Widziałeś już aplikację, testy i agenta. Następnie przyjrzymy się, dlaczego ta baza kodu jest tak przyjazna agentom — projektowi, który pozwala przekazywać zmiany z pewnością.

Dalej: Samouczek 2 Jak działa kod