Instalace, ověření a aktualizace

Tuto kapitolu používá správce pilotu nebo technický pracovník. Běžný uživatel nemá registry ručně stahovat ani kopírovat. V pilotu se instalátor remote_resolver.py získává ze schválené distribuce XDS Authoring produktu; samostatný veřejný podepsaný instalátor zatím není publikován.

Výsledek instalace

Pro lokální prostředí se doporučuje projektový scope:

<consumer-repository>/.agents/
├── skills/
│   ├── xds-authoring/
│   │   └── SKILL.md
│   ├── xds-schema-reader/
│   │   └── SKILL.md
│   └── ... deklarované závislosti
├── references/ nebo jiná logická umístění closure
├── contracts/
└── .xds-installer/
    ├── installs/
    ├── previous/
    ├── failed/
    └── removed/

Přesnou topologii určuje resolver a lock. Neupravujte ji ručně. Stejný .agents/skills layout je první společnou cestou pro Codex, GitHub Copilot ve VS Code, Visual Studio a Gemini CLI.

Požadavky

schválená kopie XDS Authoring produktu obsahující product/tools/skills-registry/remote_resolver.py;
Python podporovaný danou produktovou distribucí;
HTTPS přístup ke kanonickému registry.json;
existující klientský repozitář a oprávnění vytvořit či spravovat jeho .agents;
čistý nebo známý Git stav klientského projektu;
osoba oprávněná rozhodnout o instalaci a aktualizaci.

Příklady níže předpokládají spuštění z kořene checkoutu XDS Authoring workspace. Cestu ke klientskému projektu vždy nahraďte skutečnou explicitní cestou.

Doporučená instalace do existujícího projektu

Režim --workspace zachovává cizí obsah v .agents a spravuje pouze balíčky XDS:

python product/tools/skills-registry/remote_resolver.py `
  --registry https://authoring.flexideo.cloud/registries/xds/registry.json `
  --skill xds-authoring `
  --workspace C:\work\consumer\.agents

Instalátor:

stáhne descriptor;
ověří stav a schema;
resolveuje closure xds-authoring;
ověří cesty a SHA-256;
odmítne kolizi s jiným obsahem;
zapíše skills a jejich resources;
uloží evidence do .xds-installer/installs/xds-authoring/;
nespustí žádný distribuovaný nástroj.

Povinné ověření po instalaci

Offline kontrola nepotřebuje síť:

python product/tools/skills-registry/remote_resolver.py `
  --skill xds-authoring `
  --workspace C:\work\consumer\.agents `
  --verify

Potom otevřete klientský repozitář v cílovém hostiteli a ověřte:

discovery xds-authoring;
explicitní aktivaci xds-schema-reader;
načtení instalovaného schema.mxl a významové reference;
že agent bez dalšího potvrzení nic nespustil;
zda hostitel vyžadoval reload nebo restart.

Wholly-managed target

Režim --target použijte pouze tehdy, když má celý cílový .agents spravovat XDS instalátor a adresář je prázdný:

python product/tools/skills-registry/remote_resolver.py `
  --registry https://authoring.flexideo.cloud/registries/xds/registry.json `
  --skill xds-authoring `
  --target C:\work\consumer\.agents

Instalátor odmítne neoznačený neprázdný target. Pro běžné repozitáře s vlastními skills vždy preferujte --workspace.

Aktualizace

Aktualizaci provádějte vědomě, nikoli při startu hostitele:

python product/tools/skills-registry/remote_resolver.py `
  --registry https://authoring.flexideo.cloud/registries/xds/registry.json `
  --skill xds-authoring `
  --workspace C:\work\consumer\.agents `
  --update

Před aktualizací:

ověřte současnou instalaci;
zkontrolujte čistotu klientského pracovního stromu;
přečtěte release informaci a zvažte dopad maturity;
ukončete nebo restartujte hostitele podle jeho pravidel;
po update zopakujte offline verify a hostitelský smoke.

Předchozí spravovaná closure zůstane v .xds-installer/previous/. Instalátor ji potichu nepřepíše další aktualizací.

Rollback

Pokud nové skills neprojdou verify nebo hostitelským smoke testem:

python product/tools/skills-registry/remote_resolver.py `
  --skill xds-authoring `
  --workspace C:\work\consumer\.agents `
  --rollback

Rollback obnoví předchozí ověřenou closure. Neúspěšný stav ponechá ve failed/ pro kontrolu. Po návratu znovu spusťte --verify a zaznamenejte verzi hostitele a digest locku.

Odinstalování

python product/tools/skills-registry/remote_resolver.py `
  --skill xds-authoring `
  --workspace C:\work\consumer\.agents `
  --uninstall

Odinstalování nejprve ověří spravovaný stav. V režimu workspace přesune vlastní unikátní balíčky do .xds-installer/removed/; sdílený balíček potřebný jiným managed skillem ponechá. V wholly-managed režimu přesune celý cíl do obnovitelného <target>.xds-removed. Neprovádí nevratné smazání.

Konflikty a cizí obsah

Pokud cílovou cestu obsadil soubor s jiným digestem, instalace skončí bez jeho změny. Správný postup je zjistit původ a vlastníka konfliktu. Ruční přepsání, spojení dvou balíčků nebo smazání celého .agents by zrušilo bezpečnostní a rollback záruky.

Uživatelská a globální instalace

Někteří hostitelé podporují uživatelský scope, například $HOME/.agents/skills. Pro pilot preferujte repository scope: schopnost je viditelná jen v určeném projektu, její evidence může být auditována s projektem a nehrozí nechtěná aktivace nad jiným klientem. Globální instalaci používejte pouze podle schválené organizační politiky.

Pluginy a host adaptery

Claude, OpenAI a Gemini mohou pro týmovou nebo nativní distribuci používat generovaný plugin/extension. Adapter se vytváří pouze z ověřeného resolution locku do nového prázdného adresáře. Obsahuje hostitelský manifest, nezměněné portable skills, povolené resources, ADAPTER-PROVENANCE.json, README a policy. Neobsahuje credentials, zákaznické soubory, automatické hooks ani aktivní MCP konfiguraci.

Lokální sestavení adapteru není publikace. Marketplace, plugin directory nebo tenant upload provádí až pověřený vlastník po hostitelské acceptance.

OpenAI: instalovat celý read-only registry balíček

Pro pilot ChatGPT/Codex není nutné sestavovat vlastní výběr skills. Zveřejněný P0 package je celá aktuální registry closure a je dostupný na stabilném prefixu:

Správce nejdříve ověří SHA-256 archivu proti archive.digest v release metadatech, potom jej rozbalí pod plugins/flexideo-xds vedle staženého marketplace.json. Přesný PowerShell postup a očekávaná struktura jsou v kapitole ChatGPT a Codex. Teprve vzniklý marketplace root se přidá do Codex CLI nebo poskytne do schváleného hostitelského procesu ChatGPT Work.

Nerozbalujte tento archiv do .agents: P0 plugin a P1 workspace instalace mají rozdílné hranice oprávnění i životní cyklus. Pro VS Code zůstává správnou cestou resolver s --workspace.

Instalační checklist

Používám kanonickou HTTPS registry.
Instalátor pochází ze schválené produktové distribuce.
Cíl je explicitní a leží v zamýšleném klientském repozitáři.
Pro existující .agents používám --workspace.
Po instalaci prošel offline --verify.
Hostitel objevil requested skill a přečetl lokální referenci.
Resolve ani instalace nic nespustily.
Znám postup rollbacku a odinstalování.
Evidence neobsahuje klientská data ani credentials.

Při chybě pokračujte Řešením potíží.

Výsledek instalace​

Požadavky​

Doporučená instalace do existujícího projektu​

Povinné ověření po instalaci​

Wholly-managed target​

Aktualizace​

Rollback​

Odinstalování​

Konflikty a cizí obsah​

Uživatelská a globální instalace​

Pluginy a host adaptery​

OpenAI: instalovat celý read-only registry balíček​

Instalační checklist​