wastech-orchestrator
Zamienia opisane zadanie w pull request do twojego przeglądu.
Zmiany wprowadzają agenci, a orkiestrator prowadzi scenariusz i całą pracę z Gitem wokół nich, od gałęzi po pull request. Każdy krok jest zapisywany w lokalnej bazie SQLite, więc po każdym uruchomieniu zostaje zapis, dzięki któremu można je później prześledzić.
Dlaczego tu jest
Sam używam tego orkiestratora do tworzenia nowych funkcji, pisania tekstów i sprawdzania pomysłów. To jeden z przykładów tego, co mógłbym skonfigurować dla ciebie i twojego zespołu. Kod i dokumentacja są publiczne, więc możesz sprawdzić, jak działa, zanim cokolwiek zdecydujesz.
Problem
Zanim osoba przeglądająca kod zrozumie zmianę agenta, wokół tej zmiany potrzeba kilku kroków. Gdy nikt za nie nie odpowiada, pull request od agenta trudno przejrzeć, a jego wynik trudno powtórzyć. To jeden z powodów, dla których praca z agentami utyka, obok jakości kontekstu, który agent czyta.
Rozwiązanie
Orkiestrator bierze na siebie proces i pracę z Gitem, a agenci nie są proszeni o commit ani push. Scenariusz opisuje kroki, a zadania pisze się pod niego. Pull request otwiera się, gdy przejdą skonfigurowane przez ciebie kontrole i przegląd wykonany przez agenta, a razem z nim przychodzi opis tego, co się zmieniło.
- Zadanie trafia do agenta i wraca jako pull request, gdy przejdą kontrole skonfigurowane dla twojego repozytorium.
- Kroki są zapisane jako scenariusz, więc każde uruchomienie przechodzi przez etapy, które w nim określasz.
- Opcjonalny commit audytowy umieszcza plik zadania i jego podsumowanie obok kodu.
Najważniejsze funkcje
- Od zadania do pull requestuZadanie w Markdownie staje się gałęzią, zmianą, kontrolami twojego repozytorium i pull requestem z opisem.
- Dwóch agentów, jeden interfejsOpenAI Codex i Anthropic Claude Code są wymienne, a gdy skonfigurowane są oba, przy awarii infrastruktury uruchomienie przechodzi na drugi.
- Git zostaje przy orkiestratorzeAgenci nie są proszeni o commit ani push. Przy ścisłej izolacji na hoście, który potrafi uruchamiać ich w sandboxie, nie mogą zapisywać do .git, a preflight ostrzega, gdy takiej ochrony brakuje.
- Wznawiane uruchomieniaKażdy krok jest zapisywany w punkcie kontrolnym, więc po restarcie przerwane zadanie rusza dalej, a commit i pull request nie powstają drugi raz.
Pipeline
- ZadaniePlik Markdown w twoim repozytoriumTy
- GałąźTworzona z twojej gałęzi bazowejOrkiestrator
- Kroki scenariuszaPlanowanie i zmiany, krok po krokuAgenci AI
- KontroleTwoje polecenia testów i lintera po każdej zmianieOrkiestrator
- PrzeglądCzytają zmianę i odsyłają uwagi do poprawyAgenci AI
- CommitCommit w zakresie zadania, potem pushOrkiestrator
- Pull requestOtwierany z opisem do twojego przegląduOrkiestrator
Dla kogo
- Osoby i zespoły, które chcą pracować z agentami AI.
- Liderzy techniczni, którzy chcą, żeby każda zmiana agenta przechodziła przegląd i zostawiała ślad.
Technologie
- Rdzeń
- Python 3.12+
- Agenci
- OpenAI Codex CLI
- Anthropic Claude Code CLI
- Stan
- SQLite (punkty kontrolne, tabele audytu)
- Git
- git
- GitHub CLI (gh)
Instalacja
pipx install "git+https://github.com/VladimirMakarevich/wastech-orchestrator.git"cd path/to/your-repoworc install .worc preflightOgraniczenia
- Wykonuje jedno zadanie naraz, od początku do końca.
- Otwiera pull requesty tylko na GitHubie, przez gh CLI.
- Krok kontroli zatrzymuje zadanie dopiero wtedy, gdy wpiszesz w konfiguracji swoje polecenia testów i lintera. Świeża instalacja nie ma żadnych.
- Świeża instalacja zostawia ścisłą izolację wyłączoną, a host bez sandboxa na poziomie systemu, na przykład natywny Windows, nie może zablokować zapisu do .git.