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.
majordomus skills
Dovednosti repozitáře — postupy nezávislé na provideru pod sekcí dovedností — vypsané, zobrazené a zkontrolované z jediného katalogu, který čtou všechny plochy.
Dovednosti repozitáře — postupy nezávislé na provideru pod sekcí dovedností — vypsané, zobrazené a zkontrolované z jediného katalogu, který čtou všechny plochy.
jen pro čtení
paměť
--json
Objevování je třída zdrojů `skill` ve zdrojích znalostí repozitáře, tatáž deklarace, kterou indexuje spustitelný soubor v Rustu, takže dovednost existuje pro každé rozhraní, nebo pro žádné. check validuje každou dovednost proti povolenému seznamu odvozenému ze schématu, její adresář, sekce a reference a vypíše, co zkoumal.
Jen kódy, které tento příkaz může vrátit. Úplný kontrakt je na indexu příkazů.
0ok
2použití
10kontrakt nesplněn
12chybějící artefakt
13interní chyba
Dovednosti jsou data
Dovednost je adresář v sekci dovedností repozitáře obsahující SKILL.md: front matter splňující schéma dovednosti nad tělem, které je postupem. Nic ji neregistruje. Třída zdroje `skill` ve zdrojích znalostí ji objeví, toutéž deklarací, ze které ji poskytuje spustitelný soubor v Rustu, takže list, check, web i MCP čtou jeden katalog.
Dovednost existuje, protože existuje její soubor
dovednost sledována
ano
Pro tento repozitář platí
# Installed, with one skill written the way a repository writes its own: a directory under
# the skills section holding SKILL.md and one example, both tracked. Nothing registers it;
# the source class `skill` in the knowledge sources is what makes it exist.
. "$FIXTURE_SETUP/installed.sh"
mkdir -p .ai/repo/skills/release-notes/examples
cat > .ai/repo/skills/release-notes/SKILL.md <<'S'
---
schema: skill/v1
id: release-notes
version: 1
title: Release notes
description: Write the release notes for a tagged version from the ledger and the closed issues, never from memory.
status: active
tags: [release, documentation]
inputs:
- the tag being released and the previous tag
outputs:
- a release-notes section per closed issue, each naming its evidence
---
# Purpose
Turn what the ledger and the plan record into the notes a reader of the tag needs.
# Procedure
1. List the issues closed between the two tags with `majordomus plan list`.
2. For each, quote its outcome and the evidence attached to it.
3. Refuse to describe a change that no closed issue records.
# Output
One section per issue: title, what changed, the evidence, in plan order.
S
cat > .ai/repo/skills/release-notes/examples/notes-for-a-tag.md <<'S'
# Notes for one tag
```text
Apply the release-notes skill to the range v0.1.0..v0.2.0.
```
S
git add .ai/repo/skills && git commit -qm "a skill" >/dev/null
Spustit
$ majordomus skills list
Výstup obsahuje
release-notes
aktivní
v1
ukončení0
Výpis se odvozuje z objevování, ne z registru: přidat adresář a sledovat ho je celá registrace.
Co kontrola zkoumala
dovednost sledována
ano
Pro tento repozitář platí
# Installed, with one skill written the way a repository writes its own: a directory under
# the skills section holding SKILL.md and one example, both tracked. Nothing registers it;
# the source class `skill` in the knowledge sources is what makes it exist.
. "$FIXTURE_SETUP/installed.sh"
mkdir -p .ai/repo/skills/release-notes/examples
cat > .ai/repo/skills/release-notes/SKILL.md <<'S'
---
schema: skill/v1
id: release-notes
version: 1
title: Release notes
description: Write the release notes for a tagged version from the ledger and the closed issues, never from memory.
status: active
tags: [release, documentation]
inputs:
- the tag being released and the previous tag
outputs:
- a release-notes section per closed issue, each naming its evidence
---
# Purpose
Turn what the ledger and the plan record into the notes a reader of the tag needs.
# Procedure
1. List the issues closed between the two tags with `majordomus plan list`.
2. For each, quote its outcome and the evidence attached to it.
3. Refuse to describe a change that no closed issue records.
# Output
One section per issue: title, what changed, the evidence, in plan order.
S
cat > .ai/repo/skills/release-notes/examples/notes-for-a-tag.md <<'S'
# Notes for one tag
```text
Apply the release-notes skill to the range v0.1.0..v0.2.0.
```
S
git add .ai/repo/skills && git commit -qm "a skill" >/dev/null
Spustit
$ majordomus skills check
Výstup obsahuje
OK skill
dovednosti: 1 objevena, 1 platná
reference: 1 zkontrolována
ukončení0
Čistý výsledek uvádí, co zkoumal — dovednosti, příklady, odkazy — aby průchod nad ničím nemohl vypadat jako úspěch.
Požadavek na neexistující
dovednost sledována
ne
Pro tento repozitář platí
# A repository with Majordomus installed and projections generated, and one commit of work.
"$MJ" init >/dev/null
"$MJ" update >/dev/null
mkdir -p lib docs
echo a > lib/a
echo d > docs/d
git add . && git commit -qm base
Spustit
$ majordomus skills show nosuch
Výstup obsahuje
žádná dovednost
skills list
ukončení12
Exit 12 je MISSING_ARTIFACT a zpráva jmenuje příkaz, který vypíše, co existuje.
Reference
Dovednosti repozitáře: poskytovatelsky neutrální postupy, každý pro jeden vymezený druh práce, v sekci skills vrstvy. Pouze pro čtení.
Dovednost je adresář .ai/repo/skills/<id>/ obsahující SKILL.md — YAML front matter splňující share/schemas/majordomus/skill/skill.v1.schema.json nad tělem v Markdownu, které je postupem — a volitelně examples/*.md. Nic ji neregistruje. Třída zdrojů skill v .ai/repo/knowledge/sources.yaml ji objeví, a to je táž deklarace, kterou indexuje spustitelný soubor v Rustu, takže dovednost existuje pro skills list, pro doctor, pro web a pro MCP (majordomus://skill/<id>), nebo pro nic z toho. Smlouvu o souboru viz SCHEMAS.md.
majordomus skills list [--json] every skill: id, status, version, descriptionmajordomus skills show <id> [--json] the repository-relative path, then the file as writtenmajordomus skills check [--json] validate every skill and every reference it makes
list vypíše jeden řádek na každou objevenou dovednost v pořadí objevení, včetně neplatných (výpis, který by tiše zkrácen, by skryl soubor vyžadující opravu). --json přidá URI, tagy, související id, vstupy, výstupy, cestu, hash obsahu a sledované příklady.
show vypíše cestu na prvním řádku a soubor pod ní; --json přidá tělo jako pole. Id, které není dovednost, skončí s kódem 12 a uvede skills list.
check ověřuje každou dovednost proti seznamu povolených klíčů generovanému ze schématu (žádný neznámý klíč), schema: skill/v1, celému číslu version, hodnotě status z uzavřené množiny, id shodnému s názvem adresáře, neprázdným sekcím # Purpose, # Procedure a # Output; odmítne dvě dovednosti nárokující jedno id, dvě dovednosti, jejichž popisy je nelze odlišit, id related, které nepojmenovává žádnou dovednost, a příklad bez nadpisu první úrovně. Popisy se porovnávají po převodu na malá písmena, se sloučenými posloupnostmi mezer a bez koncové interpunkce věty, takže rozdíl musí být v tom, co popis říká, ne v tom, jak je napsán. Každý nález uvádí soubor a každý důvod. Končí počty toho, co prověřil — dovednosti, příklady, reference — a při jakémkoli selhání skončí s kódem 10. Repozitář bez dovedností je WARN, nikdy ne průchod přes nic. Chybějící seznam povolených klíčů (share/allow/skill.txt, distribuce, která nebyla vygenerována) je 13 a uvádí majordomus generate allow.
doctor a watch provádějí stejné zkoumání přes doktrínu majordomus.skill-integrity; scripts/generate-site-data čte stejný katalog a odmítne sestavit web z dovednosti, která neprojde validací.
$ majordomus skills checkOK skill 1 skill(s) — every one parses, matches its directory and carries its sectionsOK skill 5 reference(s) — every related id and every example resolvesskills: 1 discovered, 1 valid; examples: 5; references: 5 checked; failures: 0
Důkazy
Každý případ níže běží v CI na Linuxu i macOS. Web se odmítne sestavit, pokud veřejný příkaz nemá behaviorální případ, negativní případ nebo ukázku.