Przewodnik po Skribly Agent
Od instalacji do pierwszego commita zrobionego z agentem. Zajmuje to około dziesięciu minut.
Repozytoria są na razie prywatne, więc nic z tego nie da się jeszcze zainstalować. Te strony opisują, jak aplikacje działają dzisiaj.
Czego potrzebujesz
Tabelę można przewijać
| Co | Do czego | Uwagi |
|---|---|---|
| macOS 12+, Windows 10 lub 11 albo Linux x64 | Sama aplikacja | Wersje dla Apple Silicon i Intel oraz Windows x64 i ARM64 |
git w PATH | Zmiany, commity, drzewa robocze i pobieranie umiejętności | Bez gita można podglądać pliki, ale nie widać zmian |
| Narzędzie agenta w wierszu poleceń | Terminale, czat i potoki | Aplikacja wykryje je sama |
ssh | Tylko zdalne maszyny | Klucze w ssh-agent lub ~/.ssh/config |
Nie potrzebujesz osobnej instalacji Node.js. Na macOS i Linux aplikacja przy starcie czyta środowisko z powłoki logowania, więc agenci zainstalowani przez nvm, Homebrew lub npm -g są znajdowani tak samo jak w Twoim terminalu.
Zainstaluj
Tabelę można przewijać
| System | Plik | Jak zainstalować |
|---|---|---|
| macOS, Apple Silicon | Skribly-mac-arm64.dmg | Otwórz plik i przeciągnij aplikację do folderu Aplikacje |
| macOS, Intel | Skribly-mac-x64.dmg | Otwórz plik i przeciągnij aplikację do folderu Aplikacje |
| Windows 10 lub 11 | Skribly-Setup.exe | Jeden instalator dla x64 i ARM64. Wybierz folder i to, dla kogo instalujesz |
| Windows, wersja przenośna | Skribly-Portable-x64.exe | Działa bez instalacji i nie aktualizuje się sama |
| Linux, dowolna dystrybucja | Skribly-linux-x86_64.AppImage | chmod +x, a potem uruchom |
| Debian i Ubuntu | Skribly-linux-amd64.deb | sudo apt install ./Skribly-linux-amd64.deb |
| Fedora, RHEL i openSUSE | Skribly-linux-x86_64.rpm | sudo dnf install ./Skribly-linux-x86_64.rpm |
Każde wydanie zawiera też SHA256SUMS.txt, więc możesz sprawdzić pobrane pliki.
Ostrzeżenia przy pierwszym uruchomieniu
Instalatory nie są podpisane. Na macOS otwórz aplikację raz, a potem przejdź do Ustawień systemowych, Prywatność i ochrona, i wybierz Otwórz mimo to. Możesz też usunąć flagę kwarantanny:
xattr -dr com.apple.quarantine "/Applications/Skribly Agent.app"Na Windows SmartScreen może pokazać ostrzeżenie. Wybierz Więcej informacji, a potem Uruchom mimo to.
Prezentacja
Przy pierwszym uruchomieniu kursor sam przechodzi przez 15 miejsc w aplikacji. Klawiszami strzałek przechodzisz między krokami, a Esc zamyka prezentację. Możesz ją powtórzyć z Pomocy.
Dodaj projekt
Projekt to katalog, zwykle repozytorium git. Agenci, git, audyty i umiejętności działają w wybranym projekcie.
- Otwórz przełącznik projektów na górnym pasku i wybierz Dodaj projekt.
- Wskaż katalog. Aplikacja wykryje gałąź bazową, sprawdzenia i adres deweloperski.
- Dostosuj je w Ustawieniach, w sekcji Projekty, przyciskiem Konfiguruj, i wybierz Zapisz.
| Ustawienie | Jak jest wykrywane |
|---|---|
| Gałąź bazowa | Pierwsza istniejąca z develop, main i master |
| Sprawdzenia | npm run lint, typecheck i test, jeśli są, composer test, python manage.py test lub pytest |
| Adres deweloperski | Port ze skryptu dev lub start, a w przeciwnym razie 5173 dla Vite i 3000 dla reszty |
| Wzór gałęzi | feature/{key}-{slug} |
| Wzór i język commitów | Wykrywane z historii przy każdej propozycji |
Usunięcie projektu z listy nie rusza jego plików.
Połącz tracker
- Otwórz Ustawienia, potem Trackery zadań, i wybierz Dodaj tracker.
- Wybierz tracker i wpisz jego adres oraz token. Otwórz stronę tokenów prowadzi tam, gdzie go utworzysz.
- Wybierz Zapisz i sprawdź. Aplikacja zaszyfruje token i sprawdzi połączenie.
Uruchom pierwszego agenta
- Otwórz Agenci i wybierz Nowa sesja.
- Wybierz agenta. Niezainstalowani są wyszarzeni i pokazują polecenie instalacji.
- Wybierz projekt i kopię roboczą: główną, drzewo robocze albo nowe drzewo robocze.
- Opcjonalnie nazwij sesję, wybierz Terminal lub Czat i wpisz pierwszą wiadomość.
- Wybierz Uruchom.
Najszybszy start z trackera: otwórz Zadania, wybierz zadanie i wybierz Zacznij z agentem. Aplikacja zapisze opis, utworzy gałąź i wyśle agentowi gotową instrukcję.
Stany panelu
| Stan | Znaczenie |
|---|---|
| startuje | Sesja właśnie powstała |
| pracuje | W terminalu coś się dzieje |
| czeka na decyzję | Agent prosi o zgodę lub wybór |
| skończył | Agent skończył turę, a wyniku jeszcze nie widziano |
| gotowy | Wynik jest już obejrzany, a agent czeka na kolejną instrukcję |
| zakończony | Proces zakończył działanie |
Zrób pierwszy commit
- Otwórz Kod i git, a potem kartę Zmiany.
- Dodaj pliki do indeksu przyciskiem plusa.
- Wybierz Zaproponuj. Aplikacja napisze wiadomość na podstawie historii repozytorium i pokaże, skąd ją wzięła.
- Opcjonalnie wybierz Agent, żeby poprawić wiadomość na podstawie zmian w indeksie.
- Wybierz Commit albo naciśnij
⌘Enter.
Wiadomość nigdy nie dostaje dopisku Co-Authored-By ani Generated with. Żeby czyścić też commity, które agenci robią w terminalu, wybierz Hook bez stopek AI na dole karty Zmiany.
Aktualizacje
Aplikacja sprawdza nową wersję przy starcie i co cztery godziny, pobiera ją w tle i instaluje przy następnym uruchomieniu. Możesz to wyłączyć w Ustawieniach, w sekcji Aktualizacje.
| System | Co się aktualizuje |
|---|---|
| macOS | Pakiet .zip, który aplikacja sprawdza i podmienia, bo nie jest podpisana |
| Windows | Instalator. Wersja przenośna nie aktualizuje się sama |
| Linux | AppImage. .deb i .rpm aktualizujesz, instalując nową wersję |
Czytaj dalej
- Rozwiąż problem
Niewykryty agent, błędy trackera i więcej.
- Steruj agentami ze skryptów
Polecenia i narzędzia MCP.
- Sprawdź, co jest zapisywane
Dane, porty i połączenia.