Přeskočit na obsah

Tato stránka byla automaticky přeložena z angličtiny, jediného jazyka, ve kterém se tento web píše. Číst originál.

Několik agentů na jednom repozitáři, aniž by si šlapali po palcích

Každý worker deklaruje cesty, kterých se smí dotknout, každá relace vidí, kdo další je připojen a co oznámil, a kolize se hlásí dřív, než se commitne.

status
stav funkce: stabilní
doména
Koordinace
na domovské stránce
zvýrazněné

Co dělá

Paralelní práce potřebuje izolaci a viditelnost a nástroj dává obojí bez ručního koordinování člověkem. majordomus start zaznamenává cesty, kterých se úloha smí dotknout; check a finish selžou na dotčeném souboru mimo ně a hlásí překrývající se nárok jakéhokoli jiného worktree téhož repozitáře na stejném stroji. Každá větev, na které se pracuje, má jeden worktree na cestě odvozené z identity gitu, takže dvě relace nemohou omylem obsadit jednu cestu a předávka může pojmenovat, kde práce je.

Sdílený server činí živou polovinu viditelnou: každý připojený klient — Claude Code, Codex, Gemini CLI, skript — je peer pojmenovaný svým vlastním handshakem a majordomus_announce sdělí ostatním jednu větu záměru a cesty, kterých se hodlá dotknout, před prvním voláním nástroje.

Co nedělá

Překryv se hlásí, nikdy neblokuje: nástroj odmítne přijmout práci jako dokončenou, když je soubor mimo deklarovaný rozsah, a editoru nebrání v zápisu souboru, zatímco úloha běží. Oznámení je informativní a žije v paměti serveru; trvalou, vynucovanou podobou je záznam úlohy a její rozsah.

Proč existuje

Provozní okamžiky z katalogu Why, které pojmenovávají některý z mechanismů této funkce. Nic zde nebylo přiděleno: okamžik se objeví, protože pojmenovává pravidlo, příkaz, schopnost nebo tvrzení, které pojmenovává i tato funkce.

Každý okamžik, na který odpovídá (14)

proai-native-teamplatform-team

Princip

Moduly schopností spustitelného souboru, které tato funkce pojmenovává, každý se schopnostmi, které skládá. Rozhraní, jichž každý dosahuje, jsou uvedena níže v části Rozhraní: jde o projekce jedné deklarace, ne o samostatné registrace.

Peery peers ověřeno chováním

Workeři tohoto repozitáře, pojmenovaní podle vlastního initialize, a co každý oznámil, že dělá — sesbíráno z nástěnky každého checkoutu, protože server obsluhuje jeden checkout a repozitář, na kterém se pracuje přes propojené worktrees, má jednu nástěnku na worktree. V paměti; zaniká s procesy.

Server server ověřeno chováním

Sdílený server tohoto checkoutu i každého dalšího checkoutu téhož git repozitáře: co říká každý lease, zda server, který pojmenovává, odpovídá, zda to, co odpovídá, je kód na disku ve verzi tohoto spustitelného souboru, a kolik peerů každý drží.

Topologie worktree worktree ověřeno chováním

Kam patří každý propojený git worktree tohoto repozitáře a kde který je. Kontejner je sourozenec primárního checkoutu pojmenovaný s `-wt`, cesta pod ním je název větve se zachovanou hierarchií a obojí se odvozuje z vlastní identity gitu — společného adresáře, registrovaných worktrees, větví — nikdy z registru, konfigurace nebo aktuálního adresáře. Worktree jinde je typovaná diagnostika s nápravou; migrace, která ji opraví, je operace příkazové řádky téže služby.

Integrace pull requestů integration experimentální

Každý otevřený pull request klasifikovaný proti aktuálnímu master — připravený, vyžaduje obnovu, čeká na kontroly, revizi nebo závislost, koncept, vyžaduje opravu, v konfliktu, blokovaný, nebezpečný (zapnuté auto-merge), redundantní (jeho práce už je na master), nahrazený (deklarovaným nástupcem, který přistál, jmenovaným v superseded_by), možná redundantní, jiná báze nebo neznámý — každý s master a hlavou, proti nimž byl rozhodnut, jeho důvody, důkazy, rizikem a překryvy, deterministicky seřazený; a auditní stopa exekutoru, který slučuje další prokazatelně bezpečný, po jednom. Vztah k master rozhoduje git s vlastními merge drivery tohoto repozitáře, protože forge nedokáže spustit driver odvozených souborů. Čte se z posledního zaznamenaného pozorování forge; jedinou výjimkou je důkaz nanečisto, který forge pozoruje sám, protože pozorování je součástí toho, co dokazuje, že nic nepřesouvá.

Ochrana úprav guard experimentální

Zda je zápis do souboru tohoto checkoutu pokrytý claimem: rozsahem aktivní úlohy, nebo živým mesh claimem píšící relace. Posouzení, na které se před každou úpravou ptá pre-tool hook providera (majordomus guard hook), přepínané session.edits_require_claim.

Monitor monitor experimentální

Vše, co se kolem tohoto repozitáře děje, sledované v jednom proudu: žurnál meshe (relace na každém propojeném stroji, mezi nimi nástěnka tohoto checkoutu, jejich claimy, předávky a revize), stopa exekutora (merge, obnovy, opravy, uzavření, selhání) a GitHub (otevřené, mergnuté a uzavřené pull requesty, dokončené běhy workflow), složené tak, že relace, která se beze změny znovu ohlásí, a krok, který nic nerozhodl, se počítají, ne zobrazují, a to, co je určeno čtenáři, je označeno (ADR 0133).

Kde se nachází

doména
Koordinace — Každý worker deklaruje cesty, kterých se dotkne, vidí, kdo jiný pracuje a kde, a o kolizi se dozví ještě před commitem.
oblasti práce
koordinace

Rozhraní

Každá schopnost za ní, na každém rozhraní, na které je promítnuta. Odkaz vede na referenci tohoto webu pro dané rozhraní; HTTP route a nástroj MCP odpovídá běžící majordomus serve, ne tento web.

Schopnosti za touto funkcí podle rozhraní
schopnostpříkazová řádkaHTTPnástroj MCP
peers.announce —žádné POST /api/v1/peers/announce majordomus_announce
peers.list —žádné GET /api/v1/peers majordomus_peers
server.status majordomus serve status GET /api/v1/server majordomus_server
worktree.inspect majordomus worktree inspect GET /api/v1/worktrees/inspect majordomus_worktree_inspect
worktree.migration_plan majordomus worktree migrate GET /api/v1/worktrees/migration majordomus_worktree_migration_plan
worktree.status majordomus worktree status GET /api/v1/worktrees/status majordomus_worktree_status
worktree.topology majordomus worktree topology GET /api/v1/worktrees majordomus_worktrees
worktree.trunk majordomus worktree trunk GET /api/v1/worktrees/trunk majordomus_worktree_trunk
worktree.uncommitted majordomus worktree uncommitted GET /api/v1/worktrees/uncommitted majordomus_worktree_uncommitted
integration.cleanup —žádné GET /api/v1/pull-requests/cleanup majordomus_pull_requests_cleanup
integration.events majordomus prs events GET /api/v1/pull-requests/events majordomus_integration_events
integration.explain majordomus prs explain GET /api/v1/pull-requests/explain majordomus_pull_request_explain
integration.prove_dry_run majordomus prs prove-dry-run GET /api/v1/pull-requests/prove-dry-run majordomus_pull_requests_prove_dry_run
integration.queue majordomus prs status GET /api/v1/pull-requests majordomus_pull_requests
integration.timings —žádné GET /api/v1/pull-requests/timings majordomus_ci_timings
integration.trains majordomus prs trains GET /api/v1/pull-requests/trains majordomus_pull_request_trains
guard.edit —žádné GET /api/v1/guard/edit majordomus_guard_edit
monitor.stream —žádné GET /api/v1/monitor majordomus_monitor
v Cockpitu, běžícího serveru
/cockpit/worktrees Worktrees
/cockpit/peers Peery
/cockpit/integration Integrace
poskytováno spustitelným souborem
/mcp MCP přes HTTP pro připojené klienty

Důkazy

Co je zaručeno

Každé tvrzení, které tato funkce pojmenovává, se stavem, který deklaruje jeho řádek, verdiktem, který podporují zaznamenané běhy, a testem, který o něm rozhoduje.

Spustitelné případy užití

Pravidla, která jej drží

  • blokující Integrita rozsahumajordomus.scope-integrity
  • poradní Paralelní práce vyžaduje izolacimajordomus.isolated-parallelism
  • poradní Jeden pracovník, jeden jasný rozsahmajordomus.one-worker-one-scope
  • blokující Worktree branche je v <repo>-wt/<branch>, odvozený z gitu, nikdy neregistrovanýproject.worktree-topology
  • blokující Nic, co klient zanechá, nezamkne jiného klientaproject.shared-server-resilience

Rozhodnutí za ním

Použití

Příkazy, které to spouštějí

  • majordomus start begin

    Zahájí jednu úlohu s rozsahem pod profilem a odmítne to, dokud je aktivní jiná.

  • majordomus check verify · jen pro čtení

    Je aktuální úloha stále konzistentní se svou politikou, rozsahem a tímto checkoutem?

  • majordomus finish conclude

    Vyhodnotí smlouvu o dokončení a odmítne výsledek, pokud je jakýkoli její řádek nesplněn.

Z příkazové řádky spustitelného souboru

Synopse každého, jak ji vypisuje nápověda samotného spustitelného souboru.

  • majordomus serve status [OPTIONS]

    Kde stojí server tohoto checkoutu (chybí, startuje, připraven, zastaralý nebo mrtvý) a každý server repozitáře

  • majordomus worktree status [OPTIONS]

    Kde toto volání je — větev, worktree, zda kanonický, necommitovaná práce — a kolik chyb nese celá topologie; exit 10, když je tento worktree na nesprávném místě

  • majordomus worktree topology [OPTIONS]

    Celá topologie: repozitář, kontejner, trunk, každý worktree, každá větev bez worktree, každá diagnostika; exit 10, když obsahuje chybu

  • majordomus worktree inspect [OPTIONS] <BRANCH>

    Jedna větev: její kanonická cesta, zda existuje, co cestu zabírá, worktree, který ji drží, a co stojí v cestě

  • majordomus worktree migrate [OPTIONS]

    Přenese každý špatně umístěný worktree na jeho kanonickou cestu, včetně necommitovaného stavu, s otiskem pořízeným před každým přesunem a po něm; --plan ukáže kroky a nic nezmění

  • majordomus worktree uncommitted [OPTIONS]

    Každý propojený worktree s necommitnutou prací: kolik cest, jak stará je nejstarší změna, co ji drží (aktivní úloha, otevřená epizoda, proces uvnitř) a zda je opuštěná, s příkazem, který by ji dostal na vzdálený ref. Čte každý worktree a žádný nezapisuje

  • majordomus worktree trunk [OPTIONS]

    Jak daleko je tento checkout a lokální trunk od vzdáleného trunku, k poslednímu fetchi, posuzováno podle checkout.trunk_distance v politice: aktuální, zaostává, zastaralý, neposouzeno nebo neměřeno, s příkazy, které jej zaktualizují. Nic nestahuje; exit 10, když je zastaralý

  • majordomus prs status [OPTIONS]

    Každý otevřený pull request s jeho dispozicí, rizikem a důvodem, v pořadí podle priority, z posledního zaznamenaného pozorování; exit 10, když je pozorování zastaralé nebo chybí

  • majordomus prs explain [OPTIONS] <NUMBER>

    Proč je jeden pull request tam, kde je: revize, proti kterým se rozhodovalo, každý důkaz, jeho pořadí a faktory za ním

  • majordomus prs events [OPTIONS]

    Auditní stopa: každý výběr, sloučení, odmítnutí, zastaralé rozhodnutí a uzavření, které executor tohoto checkoutu zaznamenal

  • majordomus prs trains [OPTIONS]

    Řetězy navazujících pull requestů v pořadí přistání: povaha každého článku, vztah k masteru, připravený head pod `refs/prep/<n>` (odeslaný nebo čekající) a řada. Offline a pouze pro čtení, z posledního zaznamenaného pozorování; exit 10, pokud je zastaralé nebo chybí

  • majordomus prs prove-dry-run [OPTIONS]

    Dokázat, že nemutující cyklus nic nepřesune: pořídit snímek refů originu, otevřených pull requestů, auditní stopy, lease a lokálních refů, spustit refresh, plan, drain --dry-run a cleanup (výpis), pořídit snímek znovu a porovnat; stažená zrcadla refresh musí odpovídat tomu, co origin servíruje. Exit 10 s pojmenováním toho, co se pohnulo. Nemá žádný přepínač: není co zapínat

Odkud tato stránka pochází

soubor
.ai/repo/features/coordination.md
stejná odpověď
majordomus product show coordination

Prohledává názvy a popisy všech stránek, které tento web publikuje.