wastech-orchestrator
Ператварае апісаную задачу ў pull request для вашага рэв’ю.
Праўкі ўносяць агенты, а аркестратар вядзе сцэнарый і ўсю працу з Git вакол іх, ад галіны да pull request. Кожны крок захоўваецца ў лакальнай базе SQLite, таму ў любога запуску застаецца запіс, па якім яго можна потым прасачыць.
Чаму ён тут
Я сам карыстаюся гэтым аркестратарам для распрацоўкі, напісання тэкстаў і аналізу ідэй. Гэта адзін з прыкладаў таго, што я мог бы наладзіць для вас і вашай каманды. Код і дакументацыя адкрытыя, таму можна разабрацца, як ён уладкаваны, перш чым нешта вырашаць.
Праблема
Каб чалавек, які робіць рэв’ю, мог разабрацца ў праўцы агента, вакол яе патрэбна некалькі крокаў. Калі за гэтыя крокі ніхто не адказвае, pull request ад агента цяжка праверыць, а вынік цяжка паўтарыць. Гэта адна з прычын, чаму праца з агентамі буксуе, нароўні з якасцю кантэксту, які агент чытае.
Рашэнне
Аркестратар бярэ на сябе працэс і працу з Git, і агентаў не просяць рабіць commit і push. Сцэнарый апісвае крокі, а задачы пішуцца пад яго. Pull request адкрываецца, калі пройдзеныя наладжаныя вамі праверкі і рэв’ю агентам, і да яго дадаецца апісанне таго, што змянілася.
- Задача сыходзіць агенту і вяртаецца ў выглядзе pull request, калі пройдзеныя праверкі, наладжаныя для вашага рэпазіторыя.
- Крокі запісаныя ў выглядзе сцэнарыя, таму кожны запуск праходзіць тыя этапы, якія вы для яго задалі.
- Неабавязковы аўдыт-каміт кладзе файл задачы і яе вынік побач з кодам.
Ключавыя магчымасці
- Ад задачы да pull requestЗадача ў Markdown ператвараецца ў галіну, праўку, праверкі вашага рэпазіторыя і pull request з апісаннем.
- Два агенты, адзін інтэрфейсOpenAI Codex і Anthropic Claude Code узаемазаменныя, і калі наладжаныя абодва, пры інфраструктурным збоі запуск пераходзіць на другі.
- Git застаецца за аркестратарамАгентаў не просяць рабіць commit і push. Пры строгай ізаляцыі на хосце, які ўмее запускаць іх у пясочніцы, яны не могуць пісаць у .git, а preflight папярэджвае, калі такой абароны няма.
- Перапыненыя запускі працягваюццаКожны крок захоўваецца ў кантрольнай кропцы, таму пасля перазапуску незавершаная задача працягваецца без паўторнага каміта і без другога pull request.
Пайплайн
- ЗадачаMarkdown-файл у вашым рэпазіторыіВы
- ГалінаСтвараецца ад вашай базавай галіныАркестратар
- Крокі сцэнарыяПланаванне і праўкі, па адным крокуШІ-агенты
- ПраверкіВашы каманды тэстаў і лінтара пасля кожнай праўкіАркестратар
- Рэв’юЧытаюць змену і вяртаюць заўвагі на дапрацоўкуШІ-агенты
- КамітКаміт у межах задачы, потым pushАркестратар
- Pull requestАдкрываецца з апісаннем для вашага рэв’юАркестратар
Для каго
- Людзі і каманды, якія хочуць працаваць з ШІ-агентамі.
- Тэхліды, якім трэба, каб кожная змена агента праходзіла рэв’ю і пакідала след.
Стэк
- Ядро
- Python 3.12+
- Агенты
- OpenAI Codex CLI
- Anthropic Claude Code CLI
- Стан
- SQLite (кантрольныя кропкі, табліцы аўдыту)
- Git
- git
- GitHub CLI (gh)
Усталяванне
pipx install "git+https://github.com/VladimirMakarevich/wastech-orchestrator.git"cd path/to/your-repoworc install .worc preflightАбмежаванні
- Выконвае адну задачу за раз, ад пачатку да канца.
- Адкрывае pull request толькі на GitHub, праз gh CLI.
- Крок праверак спыняе задачу, толькі калі вы ўказалі ў канфігурацыі свае каманды тэстаў і лінтара. Адразу пасля ўсталявання іх там няма.
- Адразу пасля ўсталявання строгая ізаляцыя выключаная, а хост без пясочніцы на ўзроўні АС, напрыклад натыўны Windows, не можа забараніць запіс у .git.