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.

Deklarujte jednou, odvoďte každé rozhraní

Schopnost se píše na jednom místě a příkazová řádka, HTTP API, dokument OpenAPI, MCP, Cockpit, reference i tento web jsou její projekce.

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

Co dělá

Spustitelná schopnost je jeden blok capability! v souboru jejího modulu, s typovaným vstupem, typovaným výstupem a handlerem. Deklarativní objekt — pravidlo, dovednost, rozhodnutí, případ užití, provozní okamžik, funkce jako tato — je jeden soubor pod .ai/, jehož druh a schéma deklaruje distribuce nástroje. Registr se při každém startu staví z obojího, validuje se a otiskuje a vše, k čemu se člověk nebo program dostane, je jeho čtení: nástroje a zdroje MCP, routy pod /api/v1/, dokument OpenAPI a nad ním Swagger UI, slova po majordomus, cíle měření výkonu, stránky Cockpit, generovaná reference pod docs/generated/ a datasety, ze kterých se tento web vykresluje.

majordomus generate zapíše každou commitnutou projekci z jednoho plánu; majordomus generate --check odmítne strom, v němž se kterákoli liší od toho, co produkují zdroje, a CI takový strom odmítne sloučit i nasadit. Funkce, kterou čtete, je sama jedním souborem pod vrstvou a povrchy uvedené vedle ní byly odvozeny z toho souboru, ne napsány na tuto stránku.

Co nedělá

Neobjevuje schopnost, kterou nikdo nedeklaroval: handler bez bloku capability! není nikde zveřejněn, záměrně. Nedovozuje vztah z názvu ani podřetězce; každý odkaz, který soubor činí, je typovaný a vyřešený proti věci, kterou jmenuje, a ten, který nevede nikam, selže ve validaci, místo aby se stal odkazem do prázdna.

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á (15)

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.

Schopnosti capabilities ověřeno chováním

Registr viděný sám přes sebe: každá schopnost s jejím druhem, stabilitou, původem, expozicemi, měřením výkonu a politikou cache a jedna schopnost celá.

Generované artefakty artifacts ověřeno chováním

Co zapisuje `majordomus generate`: každý dokument s kódováními, ve kterých je commitován — JSON pro program, YAML vedle něj, Markdown pro čtenáře — každý se svým schématem, zdrojem a hashem, sladěný s pracovním stromem. Deklarací je vlastní manifest generátoru; nic zde neudržuje seznam.

Produkt product ověřeno chováním

Co produkt tohoto repozitáře dělá pro člověka, jak to deklarují funkce v sekci features vrstvy: každá funkce se skládá z modulů, příkazů, druhů, pravidel, dokumentů, rozhodnutí, tvrzení, případů užití, oblastí Cockpitu a webových povrchů, které pojmenovává, s rozhraními, kterými je vystavena, každým počtem, okamžiky, na které odpovídá, a tím, co je zaručeno, vše odvozené z těchto referencí. Matice funkcí vůči rozhraním, provideři, pro které má nástroj adaptér, a vlastní validace modelu. Domovská stránka je čtenářem tohoto modulu a nedrží žádný vlastní inventář.

Kvalita veřejného API quality ověřeno chováním

Čemu musí vyhovovat veřejný povrch tohoto spustitelného souboru, měřeno z jeho syntaktického stromu: dokumentace, která říká víc než signatura, spustitelný příklad u všeho, co nese chování, hranice modulu, kterou něco procvičuje, a každý příkaz příkazové řádky zúčtovaný proti registru schopností. Pravidla jsou project.rust-public-api-quality a project.operation-transport-parity; toto je jejich měření.

Objekty, z nichž se skládá

Druhy objektů vrstvy. Každý je schéma, třída zdroje a soubor na disku; číslo vedle něj říká, kolik jich tento repozitář dnes obsahuje, spočítáno při sestavení.

  • feature29
  • domain6
  • command31
  • claim250

Kde se nachází

doména
Povrchy — Jedna deklarace v repozitáři se stane příkazovou řádkou, HTTP API, MCP, UI, Cockpitem, dokumentací i tímto webem a projekce, která se s ní rozchází, shodí build.
oblasti práce
dokumentacegovernance

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.

v Cockpitu, běžícího serveru
/cockpit/capabilities Schopnosti
/cockpit/artifacts Artefakty
poskytováno spustitelným souborem
/openapi.json Dokument OpenAPI registru schopností

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í Externí rozhraní jsou projekce jedné definice schopnostiproject.interfaces-are-projections
  • blokující Jedna kanonická deklarace; moduly skládají schopnosti; kořen skládá modulyproject.rust-canonical-declaration
  • blokující Odvozené soubory se regenerují, nikdy neupravujíproject.derived-files-regenerated
  • blokující Generovaný artefakt deklaruje svůj dokument, kódování, kontrakt a zdrojproject.generated-artifacts-are-typed
  • poradní Odvozený stav se počítá jednou na verzi stavuproject.derived-once

Rozhodnutí za ním

Použití

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

  • majordomus update nastavení

    Deterministicky vygenerovat každý instrukční soubor providerů z jedné politiky.

  • majordomus doctor inspect · jen pro čtení

    Kontroluje pouze správu: je samotný Majordomus v pořádku a je každé vynucování, které deklaruje, skutečně zapojeno i tady?

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

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

Odkud tato stránka pochází

soubor
.ai/repo/features/declare-once.md
stejná odpověď
majordomus product show declare-once

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