Dovednosti jsou data v sekci dovedností vrstvy a každý povrch, který nějakou ukazuje, je projekcí

7. Dovednosti jsou data v sekci dovedností vrstvy a každý povrch, který nějakou ukazuje, je projekce

Rozšiřuje ADR 2 a ADR 5.

Kontext

Manifest pojmenovává oddíl skills od doby, kdy vrstva existuje, a obsahoval README a nic jiného. Operátor požádal o první dovednost, repo-review, a o podmínku, že další nesmí stát nic než své vlastní soubory: žádný registr, žádný seznam webu, žádná položka MCP, žádný soubor poskytovatele, žádná větev match v Rustu, kterou by bylo třeba upravit. Zdrojový materiál tohoto nástroje je varování: katalog pěti set čtyřiceti šesti agentů, z nichž jeden byl zaregistrován s čímkoli, co běželo, protože existovat a být zaregistrován byly dva úkony a jen jeden z nich byl kdy proveden.

Rozhodnutí

• Dovednost je adresář. .ai/repo/skills/<id>/SKILL.md — YAML front matter pod share/schemas/skill.schema.json (schema: skill/v1, id rovné adresáři, celočíselné version, title, description, status z uzavřené množiny, volitelné tags, related, inputs, outputs) nad tělem v Markdownu s neprázdnými sekcemi # Purpose, # Procedure a # Output — s volitelným examples/*.md.
• Objevování je stávající, deklarované jednou. share/kinds.yaml deklaruje druh skill; třídy zdrojů skill a skill_example v .ai/repo/knowledge/sources.yaml (a skeleton, který zapisuje čerstvé init) říkají, které sledované soubory ho nesou. Spustitelný soubor v Rustu je indexuje jako každý druh a obsluhuje majordomus://skill/<id> bez kódu, který by druh jmenoval; lib/skills.sh shellového nástroje odvozuje jeden katalog ze stejné třídy přes mj_knowledge_discover a validuje proti allow-listu, který majordomus generate allow odvozuje ze stejného schématu.
• Každý povrch čte katalog. majordomus skills list|show|check, doktrína majordomus.skill-integrity (rozesílaná doctor a watch) a scripts/generate-site-data, který zapisuje site/data/generated/skills.json a jednu stránku na dovednost pod site/content/skills/ a celý ten adresář nahrazuje. Šablony webu se vykreslují z těchto dvou souborů a vlastních stránek sekce; navigace jmenuje sekci, nikdy dovednost.
• Drift selhává. generate --check odmítne zastaralý seznam povolených nebo datovou sadu registru; generate-site-data --check odmítne zastaralá data webu; skills check a doctor odmítnou dovednost, která porušuje svůj kontrakt, jmenují soubor a každý důvod a hlásí počty toho, co zkoumaly; repozitář bez dovedností je WARN, ne úspěch.
• Nic se neregistruje jménem. Žádný soubor v repozitáři nevypisuje dovednosti ručně. Test test/cases/95_skills.sh dovednost přidá, rozbije, přejmenuje a odstraní a ověří, že příkaz, doctor, index v Rustu přes MCP, data webu i sestavené stránky ji následují a že žádná stránka nepřežije svůj soubor.

Důsledky

Přidání dovednosti je zapsání jejího adresáře a jeho sledování. Cena rozhodnutí je v kontraktu: dovednost, které chybí sekce nebo která jmenuje související dovednost, jež neexistuje, shodí doctor pro všechny, což je záměr. Dva čtenáři (shell a Rust) parsují stejný front matter stejným schématem; shell čte projekci schématu, Rust executable čte schéma a případ dokazuje, že odmítají stejný soubor ze stejného důvodu. Co se zde nerozhoduje: kterou dovednost má úloha načíst (generované instrukce říkají „ty, o nichž úloha je“) a zda je dovednost nějak dobrá.