Přejít na obsah
Skip to main content

ChatGPT a Codex

OpenAI dnes rozlišuje jednotlivé Agent Skills a pluginy. Skills jsou vhodné pro lokální práci v repozitáři; plugin je distribuční balíček více skills a případných konektorů pro podporované ChatGPT a Codex povrchy. XDS registry zůstává zdrojem integrity a Flexideo instalátor nebo adapter builder z něj materializuje hostitelský formát.

Codex CLI a lokální projekt

Správce nainstaluje xds-authoring do <repo>/.agents pomocí XDS instalátoru. Codex hledá repository skills v <repo>/.agents/skills/; uživatelský scope je $HOME/.agents/skills/. Pro klientský pilot preferujte repository scope.

Po instalaci spusťte offline verify a otevřete novou Codex session v kořeni klientského repozitáře. Podle verze lze skill aktivovat jeho názvem, $xds-authoring nebo přes nabídku skills.

První bezpečné zadání:

Použij xds-authoring. Nejprve pouze analyzuj požadavek a dotčené XDS soubory. Ověř syntax pomocí xds-schema-reader, navrhni minimální změnu a plán validace. Nic nezapisuj ani nespouštěj, dokud nepotvrdím konkrétní krok.

Pro revizi:

Použij xds-review nad souborem .... Pracuj read-only. Odděl schema chyby, doménová rizika, dopady a chybějící evidence. Uveď lokální zdroje, které jsi skutečně četl.

Do projektového AGENTS.md patří jen stručná provozní pravidla a případný odkaz na instalační evidenci. Nekopírujte tam celý obsah skills. Codex má číst SKILL.md a resources z ověřené closure.

Ověřený stav Codexu

Interní P1 smoke prošel na Codex CLI 0.149.0-alpha.4.1: Codex objevil a explicitně použil xds-authoring i xds-schema-reader, přečetl instalované schema.mxl a nic automaticky nespustil. Tento výsledek nepotvrzuje Codex IDE, desktop nebo všechna budoucí vydání; jejich stav je na stránce Stav podpory.

Codex ve VS Code

Codex IDE rozšíření může pracovat se stejným repository layoutem .agents/skills, ale OpenAI pluginy nejsou totéž co skills načtené IDE rozšířením. Podle dokumentace OpenAI Plugins IDE extension pluginy nepodporuje. Pro VS Code proto používejte instalované workspace skills a proveďte samostatnou UI acceptance.

Plný P0 release pro OpenAI

Pro pilot je publikován jeden plný, neměnný P0 release flexideo-xds. Obsahuje kompletní aktuální registry closure (včetně matrixu a všech dalších deklarovaných skills), registry descriptor a metadata původu. Není to instalátor do projektu a není to MCP server.

ArtefaktÚčel
PLUGIN-RELEASE.jsonaktuální release, SHA-256 archivu i source registry a bezpečnostní profil
flexideo-xds.zipobsah pluginu: .codex-plugin, skills, registry a provenance
marketplace.jsonkatalog, který odkazuje na ./plugins/flexideo-xds
registry.jsonkanonický zdroj aktuálního XDS registru

P0 znamená profil 0: smí vysvětlovat XDS, analyzovat uživatelem vložený anonymizovaný úryvek, používat přibalené reference a připravit checklist nebo plán. Nesmí automaticky číst či zapisovat pracovní repozitář, resolveovat registry, spustit shell, validátor, Replicator, nástroj ani MCP. Plugin proto nezískává tato oprávnění ani tehdy, je-li viditelný více uživatelům.

Připravení lokálního marketplace pro Codex CLI nebo ChatGPT desktop

Stažení samotného ZIP souboru nestačí: OpenAI marketplace potřebuje katalog a plugin v očekávané topologii. Následující postup vytvoří lokální marketplace root; je vhodný pro pilot, protože odkazuje na celý zveřejněný balíček a před rozbalením ověří jeho digest.

$releaseBase = 'https://authoring.flexideo.cloud/registries/xds/adapters/openai/flexideo-xds'
$marketplaceRoot = 'C:\work\flexideo-xds-marketplace'
$zipPath = Join-Path $marketplaceRoot 'flexideo-xds.zip'
$pluginPath = Join-Path $marketplaceRoot 'plugins\flexideo-xds'

New-Item -ItemType Directory -Force -Path $marketplaceRoot, $pluginPath | Out-Null
Invoke-WebRequest "$releaseBase/PLUGIN-RELEASE.json" -OutFile (Join-Path $marketplaceRoot 'PLUGIN-RELEASE.json')
Invoke-WebRequest "$releaseBase/marketplace.json" -OutFile (Join-Path $marketplaceRoot 'marketplace.json')
Invoke-WebRequest "$releaseBase/flexideo-xds.zip" -OutFile $zipPath

$release = Get-Content -Raw (Join-Path $marketplaceRoot 'PLUGIN-RELEASE.json') | ConvertFrom-Json
$actual = 'sha256:' + (Get-FileHash -Algorithm SHA256 $zipPath).Hash.ToLowerInvariant()
if ($actual -ne $release.archive.digest) { throw "Digest archivu nesouhlasí: $actual" }

Expand-Archive -Force -Path $zipPath -DestinationPath $pluginPath

Výsledek musí mít přesně tuto strukturu:

C:\work\flexideo-xds-marketplace\
├── marketplace.json
├── PLUGIN-RELEASE.json
└── plugins\
└── flexideo-xds\
├── .codex-plugin\plugin.json
├── skills\
├── registry\
└── ADAPTER-PROVENANCE.json

V Codex CLI přidejte tento root jako marketplace a vyberte plugin v /plugins:

codex plugin marketplace add C:\work\flexideo-xds-marketplace
codex plugin marketplace list

Potom otevřete novou session. Pro explicitní použití lze v podporovaném klientu uvést plugin nebo konkrétní skill znakem @; konkrétní nabídka se liší podle hostitele. Tento postup je lokální a reverzibilní: odstranění marketplace pouze odebere registraci v klientovi, nepublikuje nic do veřejného katalogu.

ChatGPT web, desktop a mobil

Pro týmovou distribuci je cílem generovaný OpenAI plugin. Flexideo adapter builder umí vytvořit:

  • P0 web advisory – vysvětlení, rozbor vloženého úryvku, schema dotaz, checklist a plán bez přístupu k repozitáři či nástrojům;
  • P1 local authoring – skills pro lokální povrchy s přístupem k projektu podle oprávnění hostitele.

Plugin se generuje z ověřeného locku a obsahuje provenance. Tento plný release je již na stabilní webové cestě uvedené výše, ale není tím automaticky publikován do OpenAI public directory ani přidán do konkrétního ChatGPT Work workspace. Běžný ChatGPT chat proto nepovažujte za XDS integraci, dokud v něm správce plugin skutečně nezpřístupní a uživatel jej neuvidí v Plugins Directory.

Oficiální dokumentace OpenAI rozlišuje veřejné pluginy od lokálních/repository marketplace; jejich dostupnost se může lišit podle povrchu a nastavení workspace. Pro ChatGPT Work postupuje vlastník workspace podle podporovaného Plugins Directory: přidá ověřený marketplace/repository zdroj nebo zvolí schválený plugin, restartuje desktopovou aplikaci, pokud to klient vyžaduje, nainstaluje flexideo-xds a otevře novou Chat/Work konverzaci. Dokud tento hostitelský acceptance krok není zaznamenán, je stav pouze „release publikován“, nikoli „ChatGPT Work podporován“.

Po instalaci OpenAI uvádí explicitní aktivaci pluginu v ChatGPT pomocí @; Codex CLI používá správu pluginů přes /plugins. V každém případě ověřte, že vidíte název flexideo-xds, profil P0 a že požadovaný skill pochází z pluginu, nikoli z náhodné konverzační paměti.

P0 příklad:

Použij schválený Flexideo XDS plugin v poradenském profilu. Analyzuj pouze přiložený anonymizovaný úryvek, odděl jistá fakta od předpokladů a napiš další lokální ověření. Nepřistupuj k repozitáři, nestahuj registry a nic nespouštěj.

Podrobnosti jsou ve Webovém chatu.

Aktualizace a odstranění

Workspace skills aktualizujte pouze Flexideo instalátorem; použijte verify, update a případně rollback. P0 plugin aktualizujte jako celek: znovu načtěte PLUGIN-RELEASE.json, porovnejte SHA-256 archivu, vytvořte nový čistý marketplace root a teprve potom v klientu změňte zdroj nebo plugin přeinstalujte. Každá publikovaná verze je svázaná s ADAPTER-PROVENANCE.json a ověřeným resolution lockem. Ruční spojování souborů z pluginu a workspace instalace není podporované.

Oficiální zdroje hostitele