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.

Zpráva commitu je hodnota, kterou tento repozitář posuzuje, ne konvence, v kterou doufá

Zpráva commitu má jednu gramatiku, jednu politiku a jeden verdikt; rozsah, pod kterým se píše, se učí z vlastní historie repozitáře místo vedení v tabulce a zpráva, která politiku nesplňuje, je odmítnuta ještě během psaní.

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

Co dělá

majordomus commit validate posuzuje jednu zprávu podle politiky deklarované v .ai/repo/policy.yaml a hlásí typované nálezy — gramatiku, šířku subjektu, rozsah, který historie nepoužila, id záznamu, které vrstva nedrží, fix bez testu mezi soubory, breaking change, který nic nevysvětluje. .githooks/commit-msg se ptá s cestami ve stagingu, což je jediný okamžik, kdy zpráva i soubory existují, a git commit přeruší, je-li nález chybou. scripts/ci/commit-policy se ptá stejného soudce na historii přes majordomus commit history, který přečte 1788 commitů přibližně za sekundu.

majordomus commit scopes odpovídá, jaké rozsahy tento repozitář píše o kterých adresářích, naučené z logu. majordomus commit plan říká, co by pracovní strom commitnul, rozdělené do commitů, které podporuje vlastní členění historie, každý s důkazy pro něj a celek pod otiskem, který zastaralý plán umožní odmítnout.

Všechny čtyři jsou deklarace schopností jen pro čtení, takže příkazová řádka, MCP, HTTP, OpenAPI, Cockpit i vygenerovaná reference se odvozují z jednoho místa a žádné z nich nevede seznam.

Co nedělá

Nevytváří commit. git commit je mutace repozitáře a politika vystavení zastaví každý strojový povrch u lokální mutace: agent se smí zeptat, co by commit byl a zda zpráva projde, a commituje člověk. Subsystém je k tomu přizpůsoben — plánovač i soudce jsou čisté funkce stromu a zprávy, takže fungují offline, nemohou částečně uspět a každou odpověď lze přepočítat a zkontrolovat.

Neposuzuje, zda je předmět dobrá věta, zda je změna atomická ani zda stálo za to práci dělat. To rozhoduje revizor. Ani předmět nenavrhuje: co změna udělala, je jediná věc, kterou žádný důkaz ve stromu nevysloví, a plánovač, který by o ní napsal sebejistou větu, by do historie psal fikci.

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.

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.

Commit commit ověřeno chováním

Commit jako hodnota: slovník rozsahů, který dává historie tohoto repozitáře, co by pracovní strom commitoval a jak se dělí, a verdikt o jedné zprávě podle politiky commitů repozitáře.

Kde se nachází

doména
Governance — Pravidla se píšou jednou, v repozitáři, promítají se do instrukcí každého nástroje a blokující pravidlo příkaz zastaví, místo aby mu radilo.
oblasti práce
governancework-tracking

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
commit.history majordomus commit history GET /api/v1/commit/history majordomus_commit_history
commit.plan majordomus commit plan GET /api/v1/commit/plan majordomus_commit_plan
commit.scopes majordomus commit scopes GET /api/v1/commit/scopes majordomus_commit_scopes
commit.validate majordomus commit validate GET /api/v1/commit/validate majordomus_commit_validate

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í Zpráva commitu je hodnota, kterou tento repozitář posuzuje, ne konvence, v kterou doufáproject.conventional-commits
  • blokující Odvozené soubory se regenerují, nikdy neupravujíproject.derived-files-regenerated
  • blokující Externí rozhraní jsou projekce jedné definice schopnostiproject.interfaces-are-projections

Rozhodnutí za ním

Použití

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

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

  • majordomus commit plan [OPTIONS]

    Co by pracovní strom commitnul: větev, upstream, rozchod, každá stagovaná, nestagovaná i nesledovaná cesta, jakýkoli probíhající merge nebo rebase a commity, které podporuje vlastní členění historie, pod otiskem, který činí plán odmítnutelným, jakmile se strom pohne

  • majordomus commit scopes [OPTIONS]

    Každý rozsah, který historie commitů tohoto repozitáře používá, jak často a o kterých adresářích se píše

  • majordomus commit history [OPTIONS] [RANGE]

    Posoudí jedním průchodem každý commit v rozsahu historie proti politice commitů; při chybě v některém návratový kód 10

  • majordomus commit validate [OPTIONS] [FILE]

    Posoudit jednu zprávu commitu podle politiky commitů repozitáře; kód 10, pokud je nález chyba

Odkud tato stránka pochází

soubor
.ai/repo/features/commit.md
stejná odpověď
majordomus product show commit
číst dál

Commit

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