Řešení potíží

Nejdřív rozlište, zda je problém v instalaci, objevení skillu hostitelem, kvalitě odpovědi nebo ve skutečné XDS validaci. Každá vrstva má jiného vlastníka a jiný bezpečný postup.

Skill není vidět

1. Správce spustí offline --verify nad správným .agents workspace.
2. Zkontroluje, že existuje skills/<skill-id>/SKILL.md a instalační evidence v .xds-installer.
3. Ujistí se, že hostitel otevřel kořen správného projektu.
4. Použije reload skills nebo restart podle konkrétního klienta.
5. Ověří podporovanou lokaci v hostitelském návodu.

Samotné ruční zkopírování SKILL.md nestačí; mohou chybět dependencies a relativní resources.

--verify hlásí chybu digestu

Balíček nepoužívejte a soubor ručně neopravujte. Chyba může znamenat poškozený přenos, lokální změnu, smíšený release nebo neúplnou aktualizaci. Zaznamenejte cestu a očekávaný/skutečný digest, nikoli obsah klientského souboru. Pokud chyba vznikla po update, použijte ověřený --rollback.

Instalátor odmítne obsazenou cestu

Je to ochranné chování. Cesta už obsahuje jiný obsah než publikovaný balíček. Instalátor cizí skill nepřepíše. Správce musí zjistit vlastníka souboru a rozhodnout, zda má zůstat, přesunout se pod jiné ID, nebo být vědomě odinstalován. Neřešte konflikt přepsáním nebo smazáním .agents.

Aktualizace nebo rollback odmítne pokračovat

Adresáře .xds-installer/previous, failed nebo removed se záměrně nepřepisují potichu. Správce nejprve zkontroluje jejich obsah a instalační evidenci, bezpečně je archivuje podle interního postupu a teprve potom operaci zopakuje. Tato ochrana brání ztrátě posledního obnovitelného stavu.

Agent tvrdí, že skill nezná

• aktivujte jej explicitně způsobem daného hostitele;
• použijte přesné ID, například xds-review nebo xds-schema-reader;
• otevřete novou session po instalaci pluginu, pokud to hostitel vyžaduje;
• ověřte, zda dané UI vůbec podporuje pluginy nebo workspace skills;
• nepředpokládejte, že úspěšný CLI test potvrzuje desktopové nebo webové UI.

Agent nenajde schema nebo referenci

To obvykle znamená neúplnou closure, rozbitý relativní odkaz nebo spuštění mimo správný projekt/plugin. Nechte správce provést --verify. Agentovi nevnucujte náhodnou webovou kopii schematu; přesná dostupnost uzlů a syntaxe se má číst z instalovaného aktuálního schema.mxl.

Odpověď je příliš obecná

Upřesněte režim, soubor, uzel a výstup. Například:

Použij xds-schema-reader pro syntaxi a potom xds-review pro read-only kontrolu. Uveď cestu k evidenci, konkrétní nález, jistotu a co ještě nebylo ověřeno. Neuváděj obecná XML doporučení.

Agent chce spustit nástroj bez potvrzení

Požadavek odmítněte a vraťte práci do plánovacího režimu:

Nic nespouštěj. Ukaž přesný příkaz, vstupy, výstupy, pracovní adresář, očekávané mutace a způsob návratu. Počkej na samostatné potvrzení.

Resolve nebo instalace, které samy spustily tool, jsou bezpečnostní incident a nemají se dál používat.

Webový chat požaduje celý projekt

P0 webový profil nemá číst repozitář. Vložte jen anonymizovaný minimální výřez nebo přejděte do schváleného lokálního P1 prostředí. Pokud chat tvrdí, že projekt četl bez vložení nebo autorizované integrace, výsledek nepovažujte za důvěryhodný.

Zveřejněný ZIP se v ChatGPT neobjeví

Je to očekávané, pokud ZIP pouze otevřete nebo stáhnete. Webový release není automatická publikace do OpenAI Plugins Directory. Správce musí ověřit PLUGIN-RELEASE.json, vytvořit marketplace root s marketplace.json a rozbaleným plugins/flexideo-xds, a potom jej přidat podporovanou cestou daného klienta. Postup je v ChatGPT a Codex.

Pokud používáte ChatGPT Work, ověřte ještě, že owner workspace tento zdroj skutečně zpřístupnil. Dokud se plugin v klientovi nezobrazí, nejde o XDS integraci a nepomůže ani vložení přímého URL do promptu.

Digest OpenAI archivu nesouhlasí

Archiv nepoužívejte ani nerozbalujte. Znovu stáhněte PLUGIN-RELEASE.json a ZIP ze stejného stabilního prefixu, spočítejte Get-FileHash -Algorithm SHA256 a porovnejte jej s archive.digest. Při opakovaném nesouladu zaznamenejte URL, očekávaný i skutečný digest a eskalujte vydavateli registry.

Kdy eskalovat

Správci produktu předejte:

• hostitele, jeho přesnou verzi a operační systém;
• čas problému a požadovaný skill;
• zda šlo o P0 nebo P1;
• digest resolution locku nebo adapter provenance;
• výsledek --verify a sanitizovanou chybovou zprávu;
• zda pomohl restart, update nebo rollback;
• potvrzení, že nebyla přiložena credentials ani zákaznická data.

Neposílejte celý projekt, tokeny nebo kompletní konverzaci, pokud k tomu nebyl vytvořen schválený bezpečný kanál.