Co to znamená
majordomus skills check, a doctor a watch skrze doktrínu majordomus.skill-integrity, prověří každou nalezenou dovednost: žádný klíč front-matter mimo schéma, schema: skill/v1, celé číslo version alespoň 1, status z draft, active, deprecated, id shodné s názvem adresáře a neprázdné sekce # Purpose, # Procedure a # Output. V rámci katalogu: žádné dvě dovednosti si nenárokují jedno id, každé id related pojmenovává existující dovednost a každý sledovaný příklad začíná nadpisem první úrovně. Každé porušení je FAIL, které pojmenuje soubor a všechny důvody najednou, a příkaz skončí s kódem 10. Výsledek končí tím, co bylo prověřeno — dovednosti, příklady, reference — a repozitář bez dovedností dostane WARN, nikdy ne OK nad ničím.
Princip
mj_skills_examine v lib/skills.sh projde katalog jednou a pro každé porušení zavolá reportér; skills check předá prostý reportér FAIL, doktrína předá mj_doctrine_fail, který vezme třídu pravidla a pod watch se stane DRIFT s kódem 11. Test neznámého klíče čte share/allow/skill.txt, které majordomus generate allow odvozuje ze schématu, takže shellový nástroj odmítá přesně ty klíče, které odmítá validace JSON Schema spustitelného souboru v Rustu. scripts/generate-site-data provede stejné zkoumání a skončí kódem 10 dřív, než zapíše bajt, když selže jakákoli dovednost.
Jak to vidět
majordomus skills check
# OK skill 1 skill(s) — every one parses, matches its directory and carries its sections
# OK skill 5 reference(s) — every related id and every example resolves
# skills: 1 discovered, 1 valid; examples: 5; references: 5 checked; failures: 0
printf 'owner: me\n' >> .ai/repo/skills/repo-review/SKILL.md # after the front matter's last key
majordomus skills check # FAIL skill .ai/repo/skills/repo-review/SKILL.md — unknown front-matter key(s): owner ...; exit 10
majordomus doctor | grep skill # the same finding, from the doctrine
git checkout .ai/repo/skills/repo-review/SKILL.mdCo nepokrývá
Ověřuje strukturu a odkazy, ne to, zda je postup dobrý; dobře utvořená dovednost, která radí špatně, projde. Příklady nespouští.
Proč existuje
Dovednost se načítá, jen když úloha je o tom, co pokrývá, takže rozbitou objeví worker, který ji potřeboval, uprostřed úlohy. Kontrola každé dovednosti při každém běhu doctor přesouvá objev do stromu, kde je soubor pojmenován a oprava je jedna úprava.