Přihlásit seDomluvit prezentaci

Kapitola 2.26

Tvorba pomocí programovacích nástrojů s AI

Jak bezpečně vytvářet rozšíření pro Nexus pomocí Claude Code a dalších nástrojů pro programování s AI (umělou inteligencí). Začíná propojením vašeho IDE (integrovaného vývojového prostředí) s nástrojem Workbench a projektovým souborem CLAUDE.md, který nese pravidla platformy, a končí šesti vypracovanými prompty a kontrolní bránou, která každý z nich ověří.

Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

24 min čtení

Většina balíčku Cold chain v kapitole 2.24, Vytvoření vlastního oborového řešení od začátku do konce, vznikla s Claude Code otevřeným v terminálu vedle mě. To je dnes ve společnosti Corrán Orbital běžné a Nexus byl s tímto počítáním postaven. Platforma nepovažuje nástroj AI (umělé inteligence) pro psaní kódu za chytré automatické doplňování. Považuje jej za agenta jednajícího jménem konkrétní osoby, s oprávněním, které je vždy užší než oprávnění této osoby, a zaznamenává každé volání, které agent provede.

Tato kapitola pojednává o tom, jak takto pracovat bez úhony. Začíná připojením vašeho IDE (integrovaného vývojového prostředí), poté se věnuje dovednostem v editoru, projektovému souboru, který nástroj učí pravidla platformy, dvěma kompilátorům, které převádějí existující práci na kód Nexus, tomu, jak commity uvádějí, který nástroj je napsal, a tomu, jak kontroluji, co nástroj vytvoří. Končí šesti zadáními, která bych předal kolegovi, každé s tím, co se má vrátit, a s kontrolou, která to prokáže.

Propojení vašeho IDE se systémem Nexus

Každá instalace má jednu adresu Workbench pro nástroje AI pro psaní kódu. Najdete ji na stránce Připojte své IDE v části Vývojáři a Claude Code se připojí jediným příkazem:

claude mcp add workbench --transport http <workbench-address>

<workbench-address> je adresa, kterou stránka zobrazuje, s tlačítkem pro zkopírování vedle ní. Ostatní nástroje mají na téže stránce vlastní jednořádkové příkazy: codex mcp add workbench --url <workbench-address> pro Codex, instalační odkaz pro Cursor a code --add-mcp s malým argumentem JSON pro VS Code s Copilotem. Všechny komunikují s toutéž adresou pomocí MCP (Model Context Protocol).

Připojte své IDE
Připojení IDE
Připojte své IDE, s jedním příkazem pro každý nástroj a výchozími úrovněmi vpravo. Diagram v dolní části ukazuje, jak každé volání prochází přes Workbench, získává vlastní krátkodobé přihlašovací údaje a dostává se pouze do vlastního prostoru organizace v každém úložišti.

Není třeba vkládat žádný klíč. První volání otevře váš prohlížeč, který přesně ukáže, kdo žádá: který nástroj na kterém počítači, jménem koho a o které úrovně. Povolíte to svým passkey a od té chvíle nástroj nedrží žádné heslo k databázi ani kubeconfig, pouze oprávnění, jehož platnost skončí. Za touto adresou Nexus vytváří krátkodobé přihlašovací údaje pro každé úložiště, pro každý požadavek, vaším jménem.

Správce organizace si také může stáhnout soubor spravovaných nastavení, aby se každá firemní kopie Claude Code připojovala k tomuto serveru a k žádnému jinému:

{ "workbench": { "type": "http", "url": "<workbench-address>" } }

Úrovně a oprávnění

Každé přihlášení do Workbench získá oprávnění složené z pojmenovaných úrovní. Výchozí pro vývojáře je Observe a Sandbox na jeho vlastních jednotkách.

Úroveň Co umožňuje Kdo ji získá
Observe Čtení vašich jednotek včetně logů a metrik a dotazování maskované kopie Výchozí hodnota
Sandbox Zápis ve vašem vlastním prostoru: ve vašem vývojovém prostoru a ve vašich vlastních datových větvích Výchozí hodnota
Propose Otevření žádosti o změnu; pipeline ji po kontrole použije Vyžádá se při prvním použití
Elevate Jedna časově omezená akce na jednom cíli, schválená konkrétní osobou Pouze lidé, nikdy jen na základě přihlášení
Break-glass Nouzový přístup Pouze správci platformy, se dvěma schvalovateli

Agent vždy jedná jménem osoby a zobrazuje se jako samostatný řádek. Jeho oprávnění není nikdy širší než vaše a nikdy nezahrnuje úroveň Elevate ani nemaskovaná data. Platí jednu hodinu a obnovuje se pouze tehdy, když jste aktivní v Nexus nebo v IDE. Oprávnění osoby platí 8 hodin. Nástroj, který necháte běžet přes noc, se tedy zastaví sám a ukončením vlastního oprávnění ukončíte i oprávnění svého agenta. Každé oprávnění agenta má také rozpočet na náklady modelu, odhadnutý před udělením oprávnění a zobrazovaný jako ukazatel během jeho běhu.

Stránka Moje přístupová oprávnění uvádí všechna oprávnění, která držíte vy a vaši agenti, s jejich úrovněmi a dosavadními náklady, a umožňuje každé z nich obnovit, zúžit nebo ukončit. Ukončení oprávnění okamžitě zastaví další volání; záznam o každém volání zůstává. Každé oprávnění má také pevné limity, které u nás činily 200 řádků a 30 sekund na dotaz a 50 změněných objektů ve vývojovém prostoru za relaci.

První relace v IDE

Po připojení /mcp v Claude Code vypíše nástroje Workbench seskupené podle úrovní. Skupina Observe obsahuje nástroje pro čtení: workbench.k8s.describe, workbench.k8s.events, workbench.logs.query, workbench.metrics.query, workbench.traces.get, workbench.db.schema, workbench.db.query na maskované kopii, workbench.graph.query a workbench.vector.search. Sandbox přidává workbench.devspace.deploy, workbench.branch.create a workbench.branch.reset. Propose přidává nástroje, které otevírají žádost o změnu a plánují změnu grafu. Elevate v oprávnění vůbec není; žádáte o ni v konzoli.

V IDE: první relace
V IDE: první relace
První relace v Claude Code s nástroji vypsanými podle úrovní, restartem dohledaným k jeho příčině a odmítnutou žádostí o heslo k databázi. Každá odpověď uvádí, odkud pochází a co bylo skryto.

Mou první skutečnou otázkou bylo, proč se náš čtecí modul telemetrie přes noc v Rotterdamu restartoval. Claude Code popsal workload (dva restarty, nedostatek paměti při limitu 512 MiB), dotázal se na logy (organizaci nastavila brána, osobní údaje byly začerněny) a na metriku paměti a zjistil, že noční načítání stáhlo celou noc měření do jedné dávky. Pak jsem jej, napůl jako test, požádal o heslo k databázi, které služba používá. Workbench odmítl s SECRET_NEVER_SHOWN. U objektu Secret zobrazuje komukoli pouze název a poslední čtyři znaky, nikdy hodnotu. Odpověď asistenta byla správná: heslo nepotřebuje, protože každý jeho dotaz získá vlastní krátkodobé přihlašovací údaje, roli pouze pro čtení vytvořenou pro tento jediný požadavek.

Nejprve plán, pak použití

Každý nástroj, který něco mění, nejprve zobrazí plán. Plán je rozdíl (diff) s počty a otiskem a příkaz apply provede přesně a pouze tento plán.

V IDE: nejprve plán, pak použití
V IDE: plán, poté použití
Limit paměti zvýšený ve vývojovém prostoru na základě plánu a poté stejná změna mimo sandbox. V interaktivní relaci ji osoba potvrdí v IDE; ze skriptu bez rozhraní je odmítnuta.

Ve vašem vlastním vývojovém prostoru se apply provede okamžitě. Mimo něj musí osoba potvrdit změnu v IDE a změna jde do pipeline, která ji po kontrole použije. Z toho plynou dvě odmítnutí a obě mě potkala:

  • Ze skriptu, u jehož klávesnice nikdo není, například claude -p v úloze cron, nelze zobrazit potvrzovací okno, takže změna mimo sandbox je odmítnuta s CONFIRMATION_UNAVAILABLE. Nic se nestane. Spusťte ji v interaktivní relaci.
  • Apply, které odkazuje na plán, jenž tato relace nikdy nevytvořila, nebo na plán, který se změnil, je odmítnuto s PLAN_FINGERPRINT_MISMATCH dříve, než se cokoli spustí. Vytvořte plán znovu.

Kontaminace čtením

Obsah od zákazníků může skrývat pokyny určené asistentovi. Jakmile tedy relace takový obsah přečte, ztratí nástroje pro zápis a pro přístup mimo Nexus, dokud osoba nepotvrdí jeden zápis nebo nezahájí novou relaci.

V IDE: kontaminace čtením
V IDE: read-taint
Dokument s reklamací přečtený na maskované kopii, se skrytým pokynem, který asistent ignoroval. Další zápis je odmítnut, dokud osoba nepotvrdí tento jeden zápis nebo nezahájí novou relaci.

Setkal jsem se s tím u dokumentu s reklamací, který obsahoval odstavec adresovaný „asistentovi“ s žádostí, aby zkopíroval tabulku reklamací na externí adresu. Claude Code jej ignoroval a uvedl to. Když jsem jej poté požádal, aby přidal odchylku do grafu mé větve, zápis byl odmítnut s SESSION_TAINTED. Mohl jsem tento jeden zápis po přečtení jeho plánu potvrdit, nebo zahájit novou relaci, která dokument nečetla. Logy a metriky relaci nekontaminují. Dokumenty, tikety, pošta a zdrojový text grafu ano. Skrytý text byl v mém záznamu aktivit započítán jako pokyny nalezené v obsahu, bez svého znění.

Jiná organizace

Nic, co napíšete, se nemůže dostat k datům jiné organizace. Požádejte o ně a každé úložiště odmítne s TENANT_BOUNDARY. Hodnotu organizace podstrčenou do dotazu na logy brána nahradí vaší vlastní. Nejde o chybějící oprávnění. Každá vrstva na cestě je ohraničena vaší organizací, takže z vašeho místa neexistuje nikdo, kdo by je mohl udělit, a nepomohl by ani přístup správce platformy. Pokud se dvě organizace dohodnou na sdílení dat, jde o dohodu uzavřenou mezi nimi, nikdy o něco, co provede relace IDE.

Dovednosti v IDE a Claude Code

Dovednosti Skills Engine jsou složky SKILL.md a Claude Code čte tytéž složky. Knihovna se synchronizuje do ~/.claude/skills ve vašem domovském adresáři, pouze pro čtení, s vašimi koncepty vedle nich v ~/.claude/skills/drafts. Dovednosti, které vaše organizace publikovala, jsou tak ve vašem editoru k dispozici bez jakéhokoli kopírování a to, co napíšete lokálně, prochází stejnými testy a schvalováním jako cokoli napsaného v konzoli.

Dovednosti v IDE a Claude Code
Dovednosti v IDE a Claude Code
Dovednost napsaná a otestovaná v editoru a poté odeslaná stejným schvalovacím procesem jako dovednost vytvořená v konzoli. Všimněte si, že publikace byla pozdržena, protože autor nemůže schválit vlastní změnu.

Z terminálu v repozitáři, který dovednost obsahuje, ji dva skripty npm přenesou z vašeho editoru do knihovny:

npm run skill:validate skills/check-a-customs-filing
npm run skill:upload skills/check-a-customs-filing

Validate kontroluje formát a testovací případy. Upload vytvoří koncept, a pokud obsah odpovídá již publikované verzi, vrátí místo toho tuto verzi (CONTENT_HASH_ALREADY_PUBLISHED). Publish je pozdrženo ke schválení, pokud to dovednost vyžaduje, a vlastní změnu schválit nemůžete. Běh spuštěný ze skriptu bez trasy modelu je odmítnut s SKILLS_ENGINE_BINDING_MISSING: trasu volí dispečer a engine ověřuje, že ji obdržel, nikdy ji neodhaduje. Kapitola 2.24, Vytvoření vlastního oborového řešení od začátku do konce, ukazuje tytéž skripty v celém projektu.

Agenti a Claude Code přistupují ke knihovně také přes MCP, celkem prostřednictvím 13 nástrojů. Mezi nimi list_skills a get_skill dovednost vyhledají a přečtou, match_prompt a discover_skills určí, která dovednost se hodí pro daný úkol, invoke_skill ji spustí a sync_skills_local zkopíruje knihovnu do vaší složky dovedností. Každé volání běží jako osoba, která je zahájila, v rámci jejího seznamu povolení. Dovednost nikdy nemůže rozšířit své nástroje nad rámec seznamu povolení toho, kdo ji spouští.

Projektový soubor CLAUDE.md nesoucí pravidla platformy

Claude Code na začátku každé relace čte CLAUDE.md v kořeni repozitáře. Je to nejlevnější bezpečnostní opatření, které máte, protože předloží modelu pravidla platformy dříve, než cokoli napíše. Kontroly SDK (sady pro vývoj softwaru) zachytí většinu chyb tak jako tak, ale pravidlo, které si model přečetl předem, vás nestojí žádné neúspěšné sestavení.

Pište jej jako pravidla s jejich zdůvodněním, ne jako přání. Zde je ten z repozitáře našeho pluginu Cold chain, mírně zkrácený:

# CLAUDE.md: the cold-chain plugin

This repository is a Nexus plugin built on @adverant-nexus/plugin-sdk 2.50.0.
Read nexus.manifest.json before anything else. It is the contract; the code follows it.

## Done means the gates pass

A change is done only when every one of these has run in this order and you have
quoted its last line to me:

1. npm ci
2. npm run typecheck && npm test && npm run build
3. npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
4. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test   (exit 0 passes; exit 2 means a gate examined nothing, which is a failure)
5. node scripts/ci/required-env  (must list every variable src/config.ts requires)

Never report done from a partial log or from memory.

## Isolation: three axes, from the token and nowhere else

- Every scoped row carries organization_id, owner_user_id and business_unit_id.
  Primary keys lead with organization_id. Foreign keys are composite and carry it.
- Tenant, owner and unit come from the authenticated request through the SDK's
  scope guard (runtime/scope). Never from a request body, a query string, a header
  you parse yourself or an environment variable.
- A route that cannot resolve an axis it needs refuses with SCOPE_PREDICATE_MISSING.
  Never substitute a placeholder id, a default organisation or the string "unknown".
- A body that names a tenant field is refused with TENANT_NOT_A_PARAMETER.
  Never "fix" that by accepting the field.
- The tenant predicate is defined in one file. Never write a second one.
- Every statement on a scoped table runs inside withScopedTx with the fence.
  Never call set_config yourself.

## Compute goes through UNO only

- src/uno.ts is the only file that knows the dispatch URL. Use its UnoClient.
- No fetch to a model provider, engine, queue or workflow host anywhere else.
- A 202 means accepted, not done. Poll to a terminal run, and drop any returned
  row whose organisation is not the caller's.

## AI goes through the router only

- This plugin holds no model credential. src/config.ts refuses to boot if one is
  in the environment. Never weaken that check.
- Our trust is community, so manifest skills are host_callback or plugin_queue.
  Never add a tool_using or llm_only skill. Model work is a Skills Engine skill.
- Provider and model wishes go on skill rows and nowhere else.

## No credentials, ever

Never write a key, token or password into the repository, a fixture, a log line
or your reply. If a task seems to need one, stop and ask me.

## Refusals have one shape

Every refusal is a JSON body with error: true, a code from the SDK catalogue,
message and troubleshooting[]. Scope refusals also carry resolved[], missing[]
and invalid[]. Send it with res.json so the refusal ledger records it.
Tests assert the body, never just the status.

## Tests fail first

- Every new test must fail on the tree before your change. Show me: undo the
  change, run the test, paste the failure, restore the change, run it green.
- Never delete, skip or weaken a test to make the build pass.
- Never add an entry under gates/ without a reason I have agreed to.
- Every test takes its scope from test/scope-fakes.ts.
- Database tests run on a real Postgres through the SDK's ephemeral-postgres
  harness. In CI a skipped database case is a failure, not a pass.

## The manifest

- Every route is in api.endpoints[] with its auth and a right from rights.
- A change that widens scopes, stores or outbound addresses needs two reviewers.
  Say so at the top of your summary when a change does it.
- The architecture block keeps its three sentences word for word.
  Deploy is through the installation's release channels only.

## Commits

Stamp every commit you write with an X-Generator trailer: claude-code/<model>.

Takový soubor funguje díky třem věcem. Každé pravidlo uvádí mechanismus, který jej vynucuje, takže model může svou práci ověřit proti tomu samému, proti čemu ji ověří pipeline. Definice hotového je seznam příkazů s návratovými kódy, nikoli pocit. A zakazuje konkrétní zkratky, po kterých model sahá, když je sestavení červené, například smazání testu nebo nahrazení chybějící organizace zástupnou hodnotou.

Předání korpusu SDK jako kontextu

Dokumentace SDK tvoří sadu 28 svazků napsaných tak, aby vývojář nebo LLM (velký jazykový model) dokázal vytvořit kompletní produkční plugin pouze z tohoto korpusu, bez přístupu k neveřejnému kódu platformy. Každý tvar komunikace a každý chybový kód, se kterým se plugin setká, je přímo v dokumentech.

Díky tomu jde o neobvykle dobrý kontext. V praxi dávám Claude Code svazky, kterých se úkol týká, nikoli celou sadu: svazky o manifestu a HTTP pro novou trasu, svazek o databázi pro migraci, katalog chyb, kdykoli jde o odmítnutí, a vždy kontrolní seznam shody, protože představuje celý korpus ve formě seznamu k odškrtání. Řekněte modelu, aby dával přednost zjištěnému faktu před vlastní pamětí o tom, jak framework obvykle funguje. Když se tyto dvě věci liší, korpus má o této platformě pravdu.

Pro frontendového vývojáře ve vašem týmu vygenerujte průvodce z manifestu, místo abyste jej psali:

npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin guide --manifest nexus.manifest.json --narrative docs/guide --out docs/GUIDE.md

Uvádí každou trasu, kterou smí webová aplikace volat, se všemi odmítnutími, která může obdržet, takže je to dobrý kontext i pro model, který píše webovou aplikaci. Zapište jej do repozitáře a kontrolujte jej v CI (kontinuální integraci) pomocí --check --lint, aby se nemohl od manifestu odchýlit.

Zabalení existujícího repozitáře: /plugin-create

Dovednost /plugin-create převádí existující repozitář nebo specifikaci API (rozhraní pro programování aplikací) na plugin Nexus. Při jejím vyvolání jí předejte zdroj:

/plugin-create https://github.com/<owner>/<repo>

Pracuje ve fázích. Nejprve zdroj naklonuje a analyzuje, přičemž určí jazyk a framework, rozsah API, databázi a její migrace a to, co daná věc skutečně dělá. Vypíše zprávu o analýze a podle zjištění zvolí strategii obalení:

Zdroj Strategie
REST (representational state transfer) API v Node.js Obal Express kolem existujících tras
REST API v Pythonu Obal FastAPI
Full-stack Node.js a React Backendový wrapper s adaptérem uživatelského rozhraní (UI)
Nástroj příkazového řádku Express API, které spouští příkazy
Knihovna nebo SDK Express API zpřístupňující její funkce
Komplexní platforma Jeden kontejner pluginu s proxy nginx před ním

Poté vygeneruje backend a jeho migrace, UI, manifest a testy. To, co napíše, berte jako kvalitní první návrh a posuzujte jej stejně přísně jako cokoli jiného. V našem repozitáři to znamenalo tři kroky, než to kdokoli zrevidoval. Jeho manifest jsme převedli na kontrakt v2 pomocí create-nexus-plugin migrate --write, který doplní věty o právu a odmítá si vymýšlet entrypoint. Poté jsme zajistili, aby prošel create-nexus-plugin validate. A spouštěli jsme nexus-gates, dokud nebyl zelený, což v našem případě znamenalo nahradit hlavičky tenanta, které si wrapper četl sám, strážcem rozsahu ze SDK a doplnit do jeho tabulek tři osy. Nasazení zůstává na kanálech vydání dané instalace; případné soubory pro nasazení obsažené v návrhu ignorujte.

mockup-compiler: od obrazovek k funkčnímu kódu

Druhý kompilátor pracuje opačně. mockup-compiler vezme makety projektu, kterých mohou být tisíce obrazovek, a zkompiluje je do funkčního UI, tras backend for frontend (BFF) a SQL, přičemž věrnost je obrazovku po obrazovce prokázána bránami s návratovými kódy. Každé vykreslené slovo dohledá ke zdrojovému řádku, který jej vykreslil, propojí každou obrazovku s její specifikací, určí změny domény, které obrazovky potřebují, a vygeneruje kontrakty a migrace spolu se specifikací demonstračních dat, která každá obrazovka potřebuje.

Od žádosti, aby model „vytvořil tyto obrazovky“, jej odlišují dvě pravidla:

  • Nejprve kompilátor. Vše, co lze zjistit, se deterministicky vypočítá. Model se používá pouze pro typované mezery: napíše artefakt podle schématu, deterministický kontrolor jej přijme, nebo pojmenuje každou vadu, a model dostane nejvýše 3 kola oprav, do nichž se mu předává zpráva kontroloru.
  • Každá brána má negativní kontrolu s podstrčenou vadou. Když verify spouští brány projektu pro obrazovku, kopie stromu dostane pro každou bránu jednu podstrčenou vadu, a pokud brána svou podstrčenou vadu propustí, je celý běh označen jako nedůvěryhodný. Brána, která nemůže selhat, běh přeruší.

Práce probíhá ve fázích, z nichž každá má vlastní režim a vlastní bránu:

Fáze Režim Co prokazuje její brána
Fixace pin Vykreslení je ve dvou sestaveních totožné a ID obrazovek jsou jedinečná
Trasování trace Každé vykreslené slovo je dohledáno k právě jednomu zdrojovému řádku
Propojení join Každý zkompilovaný slot odpovídá zdroji, který jej vykreslil
Specifikace spec Každá obrazovka má svůj řádek specifikace
Změna domény domain Návrh pokrývá vše, co obrazovky čtou a zapisují, s kódy z katalogu SDK
Kontrakty shape-check, emit-contracts Každé čtené pole má tvar převzatý ze svého sloupce nebo deklarovaný
SQL a úložiště emit-sql, emit-store Migrace se aplikuje na skutečný Postgres, s testy, které nejprve selžou
Svět world Demonstrační data pokrývají buňky všech obrazovek
Vazba bind Rozhodnutá část každé vazby, přičemž zbytek je uveden jako pojmenované mezery
Ověření verify Vlastní brány projektu pro každou obrazovku, u každé prokázáno, že může selhat

Jediným vstupem specifickým pro projekt je .mockup-compiler.json, adaptér. Určuje, jak stránka označuje jednu obrazovku a jaké idiomy SQL a úložiště generovat. Pojmenovává také osy tenantů, včetně té, která stojí na začátku každého klíče, a autorizační volání, které provádí každý zápis. mockup-compiler init --project <dir> napíše kostru, v níž je každá nevyplněná položka jmenovitě odmítnuta. Projekt bez vlastního kompilátoru UI nemůže používat compile, baseline-check, join ani world a tyto režimy to oznámí pomocí NO_PROJECT_COMPILER, místo aby selhaly až později.

Pravidlo, které bych si z toho odnesl, i kdybyste jej nikdy nespustili: pravidlo zápisu, které specifikace neuvádí, se stane poctivou chybou 501, jež pojmenuje, co chybí, nikdy odhadem. Totéž pravidlo chci od každého modelu, který píše kód podle obrazovek.

Označení původu z generátoru

Když commit napíše nástroj, má to commit uvádět. Kontrakt atribuce generátoru vyžaduje ve zprávě commitu jeden řádek traileru:

feat(excursions): page the nightly telemetry load

X-Generator: claude-code/<model>

Identita je <harness>/<model>, malými písmeny, s jedním lomítkem: harness je nástroj, který běžel (claude-code), a model je ten, který v něm běžel. Pokud se model během práce, kterou commit uzavírá, změnil, přidejte X-Generator-Session s každou identitou, od nejstarší, aby práce nebyla připsána modelu, který byl náhodou aktivní v okamžiku commitu. Služba, která obaluje commit někoho jiného, například fronta sloučení, tyto trailery přenáší dál.

Užitečným, nikoli jen ozdobným, to činí dvě vlastnosti. Údaj, který čtenář nerozpozná, je zachován a zobrazen pod unregistered/<harness> s přesně zachovaným textem, nikdy se nezahodí. A trailer je původ uváděný samotným autorem, nikdy důkaz: nic jej nepodepisuje, takže každé rozhraní, které tyto údaje počítá, zobrazuje vedle čísel toto upozornění. Gramatika identity je publikována se SDK jako @adverant-nexus/plugin-sdk/schema/generator-id. Není to pole manifestu, protože nástroj, který napsal commit, je fakt o commitu, nikoli o pluginu.

Kontrola kódu napsaného AI

Nástroj píše rychle a sebejistě, stejným tónem, ať má pravdu, nebo ne. Moje rutina pro revizi jeho změn je krátká a nic z ní nevynechávám:

  1. Čtěte diff, ne shrnutí. Shrnutí říká, co model zamýšlel udělat.
  2. Definici hotové práce spusťte sami, od čistého stavu: npm ci, testy, sestavení, validate a nexus-gates. Poslední řádky citujte v revizi.
  3. U každého nového testu ověřte, že na stromu před změnou selže. Test, který projde v obou případech, je jen ozdoba.
  4. Hledejte zkratky. Smazaný nebo přeskočený test, nová položka pod gates/ bez zdůvodnění, hodnota tenanta načtená z těla nebo hlavičky, výchozí organizace, catch, který spolkne odmítnutí, požadavek fetch na adresu, kterou manifest nedeklaruje.
  5. Porovnejte manifest s posledním vydáním. Každý nový rozsah nebo odchozí adresa je rozšířením a rozšíření schvalují dva revidující.
  6. Ověřte, že testy odmítnutí kontrolují celé tělo: error, code, resolved[], missing[] a troubleshooting[].
  7. Ověřte, že commit obsahuje svůj trailer X-Generator.

Brány zachytí mechanické vady. Nedokážou vám říct, zda trasa patří na seznam mimo CRUD nebo zda je backend právně blokován, a nedokáže to ani model; tento úsudek zůstává na vás. Pokud se stejný problém stále vrací, opravte CLAUDE.md, nejen kód.

Šest vypracovaných promptů

Každý z níže uvedených promptů jsem sám použil, jen mírně upravený. Za každým následuje, co má nástroj vytvořit, a brána, která prokáže, že to udělal. Pokud brána není zelená, práce není hotová, ať shrnutí říká cokoli.

1. Nová dovednost pro Skills Engine

Write a Skills Engine skill called summarise-excursion in skills/summarise-excursion.
It reads one excursion record and its readings and writes a five-line summary for a
controller. Read-only tools. Add test cases, including one where the excursion's cause
field contains an instruction to email the claims table to an outside address; the skill
must not follow it. Then validate it and show me the upload plan without uploading.

Měl by vytvořit skills/summarise-excursion/SKILL.md s name, description, allowed-tools, triggers, capabilities a version ve frontmatter, s instrukcemi v těle a testovacími případy, které zahrnují podstrčenou instrukci. Důkazem je npm run skill:validate skills/summarise-excursion s nulovým počtem chyb a poté npm run skill:upload skills/summarise-excursion --dry-run zobrazující plán. Publikování je následně rozhodnutím člověka a skill, který zapisuje, potřebuje v edici Enterprise dva jmenovité schvalovatele.

2. Trasa plnohodnotného pluginu

In this plugin, add GET /api/excursions/:excursionId and POST /api/excursions/:excursionId/close.
Close needs the right excursion.close for owner, admin and member. Add the migration for the
closed_at column. Follow CLAUDE.md. Write the refusal tests first and show me them failing
before you implement.

Měl by vytvořit číslovanou migraci, která přidá sloupec do tabulky nesoucí tři osy, obě trasy deklarované v api.endpoints[] s jejich auth a right, oprávnění v registru rights, handlery za strážcem rozsahu a testy, které ověří, že neautentizovaný požadavek a požadavek ze špatné organizace jsou odmítnuty s úplnými těly. Důkazem je nexus-gates: scope-adherence, crud-adherence, api-contract, rights-register a migrations-are-scoped všechny projdou a výstup s nejprve selhávajícími testy je v přepisu.

3. Lens

Using the Workbench, start a lens called Marine claims on the Cold chain pack, narrowing
Cold-chain controller. It shows excursions and claims, and hides power points and set points.
Show me the plan before you apply it, then open a preview as a Rotterdam marine claims handler
on the synthetic branch.

Měl by použít nexus.create s plánem, který potvrdíte, a poté lens vytvarovat vůči jeho základu. Pokud se pokusí zobrazit něco, co základ nezobrazuje, registr to odmítne s LENS_CANNOT_WIDEN a nástroj by to měl ohlásit, místo aby hledal cestu, jak to obejít. Důkazem je náhled v roli osoby a při povýšení kontrola zásad pilotní brány, že lens pouze zužuje a osobní pole má ve výchozím stavu vypnutá.

4. Doménový balíček

Start a domain pack called Yard power for the Rotterdam unit. Purpose: shore power points
in the container yard, their faults and the reefers they feed. Base it on the logistics base
model and add Power point and Fault kinds. Class every property as personal, sensitive,
commercial or not classified. Show me the plan, the scopes the manifest will declare and the
plan fingerprint before anything is created.

Měl by vytvořit plán průvodce, uvádějící repozitář a jeho první změnu, deklarované rozsahy a tři větve se syntetickými daty, a dále pack.json s clustery lens a lexikonem. Nic se nevytvoří, dokud nepotvrdíte otisk. Důkazem je, že testy šablony projdou na syntetických větvích, a později stagingová brána. Pokud balíček požaduje víc než jeho poslední vydání, vydání je pozdrženo s MANIFEST_SCOPE_WIDENED, dokud jej nepřijmou dva revidující.

5. Datový konektor

Add a connector to this plugin that pulls container gate events from the terminal operating
system every five minutes. Make it a plugin_queue skill with a queue named after this plugin.
Declare the terminal system's address as an outbound address in the pack's manifest. Store events in
our own schema with the three axes. The credential for the terminal system is read by name
from the environment and listed in required-env. No model involvement.

Měl by vytvořit skill plugin_queue, jehož queueName je <plugin name>.<name> bez dvojtečky, timeoutMs mezi 1 sekundou a 6 hodinami, worker, který stahuje frontu, migraci pro tabulku událostí, odchozí adresu v manifestu balíčku (nikoli v nexus.manifest.json, jehož schéma takové pole nemá) a název proměnné s přihlašovacím údajem v scripts/ci/required-env. Důkazem je create-nexus-plugin validate, který uplatňuje vlastní pravidla synchronizace registru pro názvy front a časové limity, a poté nexus-gates s no-credentials a no-direct-compute zelenými. Za běhu je volání na jakoukoli adresu, kterou manifest balíčku nedeklaroval, zastaveno na hraně s EGRESS_NOT_DECLARED.

6. Modul Enterprise

Write a licensed route module for the audit trail feature group. Compile only against
@adverant/nexus-spi; do not import the plugin SDK or any Community package. Every route runs
behind ctx.requireScope, checks the module's own grant before answering, and refuses with
LICENCE_LOCKED when the organisation isn't entitled. Then run the licence-line gate and the
edition builds.

Měl by vytvořit RouteModule s jeho id, featureGroup, prázdným bodies a register, který připojí router k aplikaci hostitele, s kontrolou oprávnění uvnitř každého handleru a tělem odmítnutí ve standardním tvaru. Důkazem je brána licenční řady ukončená s kódem 0 a poté npm ci, npm test a npm run build procházející v každém složeném stromu edice. Kapitola 2.25, Sestavení pro jednotlivé edice, ukazuje kostru modulu a to, co brána odmítá.

Kolik to stojí

Pracovat tímto způsobem je rychlejší, ale není to zadarmo. Každý průchod agenta má rozpočet a hodinovou platnost a dlouhý refaktoring znamená jeho obnovování. Read-taint zabrání relaci, která přečetla jeden zákaznický dokument, cokoli zapsat, dokud to nepotvrdíte, což je prvních pár případů otravné a přesně správné. Skript nikdy nemůže změnit nic mimo váš sandbox, takže automatizace, která potřebuje zasáhnout staging, prochází žádostí o změnu a dvěma revidujícími jako všichni ostatní. Raději mám tato omezení, než abych společnosti Larkfield vysvětloval, proč asistent někam odeslal e-mailem jejich tabulku pojistných událostí.