Verzia 1.0.0-alpha.1najnovšia
Kapitola 2.26
Tvorba pomocou programovacích nástrojov s AI
Ako bezpečne zostavovať rozšírenia pre Nexus pomocou Claude Code a iných nástrojov na programovanie s AI (umelou inteligenciou). Začína sa pripojením vášho IDE (integrovaného vývojového prostredia) k prostrediu Workbench a projektovým súborom CLAUDE.md, ktorý nesie pravidlá platformy, a končí šiestimi praktickými zadaniami a kontrolnou bránou, ktorá každé z nich overí.
Táto stránka bola preložená pomocou AI z anglického originálu. V prípade akýchkoľvek nejasností je rozhodujúca anglická verzia stránky. Prečítať túto stránku v angličtine

Väčšina balíka Cold chain v kapitole 2.24, Budovanie vlastného vertikálneho riešenia od začiatku do konca, vznikla s Claude Code otvoreným v termináli vedľa mňa. To je dnes v Corrán Orbital bežné a Nexus bol postavený s tým, že sa to bude diať. Platforma nepovažuje nástroj na programovanie s AI (umelou inteligenciou) za šikovné automatické dopĺňanie. Považuje ho za agenta, ktorý koná v mene konkrétnej osoby, s povolením, ktoré je vždy užšie ako povolenie tejto osoby, a zaznamenáva každé volanie, ktoré agent vykoná.
Táto kapitola je o tom, ako takto pracovať bez ujmy. Začína pripojením vášho IDE (integrovaného vývojového prostredia), potom sa venuje zručnostiam v editore, projektovému súboru, ktorý nástroj naučí pravidlá platformy, dvom kompilátorom, ktoré menia existujúcu prácu na kód Nexus, tomu, ako commity uvádzajú, ktorý nástroj ich napísal, a tomu, ako kontrolujem, čo nástroj vytvorí. Končí šiestimi zadaniami, ktoré by som odovzdal kolegovi, pričom pri každom je uvedené, čo by sa malo vrátiť, a kontrola, ktorá to dokazuje.
Pripojenie vášho IDE k systému Nexus
Každá inštalácia má jednu adresu Workbench pre nástroje na programovanie s AI. Nájdete ju na stránke Pripojte svoje IDE v časti Vývojári a Claude Code sa pripojí jedným príkazom:
claude mcp add workbench --transport http <workbench-address><workbench-address> je adresa, ktorú stránka zobrazuje, s tlačidlom na kopírovanie vedľa nej. Ostatné nástroje majú na tej istej stránke vlastné jednoriadkové príkazy: codex mcp add workbench --url <workbench-address> pre Codex, inštalačný odkaz pre Cursor a code --add-mcp s malým argumentom JSON pre VS Code s Copilotom. Všetky komunikujú cez MCP (Model Context Protocol) s tou istou adresou.
Nie je potrebné vkladať žiadny kľúč. Prvé volanie otvorí váš prehliadač, ktorý presne ukáže, čo žiada o prístup: ktorý nástroj na ktorom počítači, v mene koho a o ktoré úrovne žiada. Povolíte to svojím prístupovým kľúčom (passkey) a odvtedy nástroj nedrží žiadne heslo k databáze ani kubeconfig, iba povolenie s obmedzenou platnosťou. Za touto adresou Nexus vytvára krátkodobé poverenie pre každé úložisko, pre každú požiadavku, vo vašom mene.
Správca organizácie si môže stiahnuť aj súbor spravovaných nastavení, aby sa každá firemná inštalácia Claude Code pripájala k tomuto serveru a k žiadnemu inému:
{ "workbench": { "type": "http", "url": "<workbench-address>" } }Úrovne a povolenia
Každé prihlásenie do Workbench dostane povolenie zložené z pomenovaných úrovní. Predvolenými úrovňami pre vývojára sú Observe a Sandbox na jeho vlastných jednotkách.
| Úroveň | Čo umožňuje | Kto ju dostane |
|---|---|---|
| Observe | Čítanie vašich jednotiek vrátane logov a metrík a dotazovanie maskovanej kópie | Predvolené |
| Sandbox | Zápis vo vašom vlastnom priestore: vo vašom vývojovom priestore a vo vašich vlastných dátových vetvách | Predvolené |
| Propose | Otvorenie žiadosti o zmenu; po kontrole ju aplikuje pipeline | Vyžiada sa pri prvom použití |
| Elevate | Jedna časovo obmedzená akcia na jednom cieli, schválená konkrétnou osobou | Iba ľudia, nikdy nie len na základe prihlásenia |
| Break-glass | Núdzový prístup | Iba správcovia platformy, s dvoma schvaľovateľmi |
Agent vždy koná v mene osoby a zobrazuje sa ako samostatný riadok. Jeho povolenie nie je nikdy širšie ako vaše a nikdy nezahŕňa úroveň Elevate ani nemaskované dáta. Platí jednu hodinu a obnovuje sa iba vtedy, keď ste aktívni v Nexus alebo v IDE. Povolenie osoby platí 8 hodín. Nástroj, ktorý necháte bežať cez noc, sa teda zastaví sám a ukončenie vášho vlastného povolenia ukončí aj povolenie vášho agenta. Každé povolenie agenta má tiež rozpočet na náklady modelov, ktorý sa odhadne pred udelením povolenia a počas behu sa zobrazuje ako ukazovateľ.
Stránka Moje prístupové povolenia uvádza každé povolenie, ktoré máte vy a vaši agenti, s jeho úrovňami a doterajšími nákladmi, a umožňuje každé z nich obnoviť, zúžiť alebo ukončiť. Ukončenie povolenia okamžite zastaví nasledujúce volanie; záznam o každom volaní zostáva. Každé povolenie má aj pevné limity, ktoré u nás predstavovali 200 riadkov a 30 sekúnd na dotaz a 50 objektov zmenených vo vývojovom priestore za reláciu.
Prvá relácia v IDE
Po pripojení /mcp v Claude Code zobrazí nástroje Workbench zoskupené podľa úrovne. Skupina Observe obsahuje nástroje na čítanie: workbench.k8s.describe, workbench.k8s.events, workbench.logs.query, workbench.metrics.query, workbench.traces.get, workbench.db.schema, workbench.db.query na maskovanej kópii, workbench.graph.query a workbench.vector.search. Sandbox pridáva workbench.devspace.deploy, workbench.branch.create a workbench.branch.reset. Propose pridáva nástroje, ktoré otvárajú žiadosť o zmenu a plánujú zmenu grafu. Elevate v povolení vôbec nie je; žiadate oň v konzole.
Moja prvá skutočná otázka bola, prečo sa náš čítač telemetrie v Rotterdame cez noc reštartoval. Claude Code opísal záťaž (dva reštarty, nedostatok pamäte pri limite 512 MiB), dotazoval logy (organizáciu nastavila brána, osobné údaje boli redigované) a metriku pamäte a zistil, že nočné načítanie natiahlo celú noc meraní do jednej dávky. Potom som ho, napoly na skúšku, požiadal o heslo k databáze, ktoré služba používa. Workbench to odmietol s SECRET_NEVER_SHOWN. Z objektu Secret zobrazuje komukoľvek iba názov a posledné štyri znaky, nikdy hodnotu. Odpoveď asistenta bola správna: heslo nepotrebuje, pretože každý jeho dotaz dostane vlastné krátkodobé poverenie, rolu iba na čítanie vytvorenú pre túto jednu požiadavku.
Najprv plán, potom aplikácia
Každý nástroj, ktorý niečo mení, najprv zobrazí plán. Plán je rozdiel (diff) s počtami a odtlačkom a aplikácia spustí presne a iba tento plán.
Vo vašom vlastnom vývojovom priestore sa aplikácia spustí okamžite. Mimo neho musí osoba potvrdiť zmenu v IDE a zmena ide do pipeline, ktorá ju po kontrole aplikuje. Z toho vyplývajú dve odmietnutia a obe ma zaskočili:
- Zo skriptu, pri ktorom nikto nesedí pri klávesnici, napríklad
claude -pv úlohe cron, nie je možné zobraziť potvrdzovacie okno, takže zmena mimo sandboxu je odmietnutá sCONFIRMATION_UNAVAILABLE. Nič sa nestane. Spustite to v interaktívnej relácii. - Aplikácia, ktorá uvádza plán, ktorý táto relácia nikdy nevytvorila, alebo plán, ktorý sa zmenil, je odmietnutá s
PLAN_FINGERPRINT_MISMATCHskôr, ako sa čokoľvek spustí. Vytvorte plán znova.
Kontaminácia čítaním
Obsah zákazníkov môže skrývať pokyny určené asistentovi. Preto keď ho relácia raz prečíta, stratí svoje nástroje na zápis a na prístup mimo Nexus, kým osoba nepotvrdí jeden zápis alebo nespustí novú reláciu.
Stretol som sa s tým pri dokumente k reklamácii, ktorý obsahoval odsek adresovaný „asistentovi“ so žiadosťou, aby skopíroval tabuľku reklamácií na externú adresu. Claude Code ho ignoroval a uviedol to. Keď som ho potom požiadal, aby pridal odchýlku do grafu mojej vetvy, zápis bol odmietnutý s SESSION_TAINTED. Mohol som tento jeden zápis potvrdiť po prečítaní jeho plánu alebo spustiť novú reláciu, ktorá dokument nečítala. Logy a metriky reláciu nekontaminujú. Dokumenty, tikety, pošta a zdrojový text grafov áno. Skrytý text bol v mojom zázname aktivity započítaný ako pokyny nájdené v obsahu, bez jeho slov.
Iná organizácia
Nič, čo napíšete, sa nemôže dostať k dátam inej organizácie. Ak o ne požiadate, každé úložisko odmietne s TENANT_BOUNDARY. Hodnotu organizácie podstrčenú do dotazu na logy brána nahradí vašou vlastnou. Nejde o chýbajúce oprávnenie. Každá vrstva na ceste je ohraničená na vašu organizáciu, takže z vášho miesta neexistuje nikto, kto by ho mohol udeliť, a nepomohol by ani prístup správcu platformy. Ak sa dve organizácie dohodnú na zdieľaní dát, ide o dohodu zriadenú medzi nimi, nikdy nie o niečo, čo robí relácia IDE.
Zručnosti v IDE a Claude Code
Zručnosti Skills Engine sú priečinky SKILL.md a Claude Code číta tie isté priečinky. Knižnica sa synchronizuje do ~/.claude/skills vo vašom domovskom adresári, iba na čítanie, s vašimi konceptmi vedľa nich v ~/.claude/skills/drafts. Zručnosti, ktoré vaša organizácia zverejnila, sú teda dostupné vo vašom editore bez akéhokoľvek kopírovania a to, čo napíšete lokálne, prechádza rovnakými testami a schvaľovaním ako čokoľvek napísané v konzole.
Z terminálu, v repozitári, ktorý obsahuje zručnosť, ju dva skripty npm prenesú z vášho editora do knižnice:
npm run skill:validate skills/check-a-customs-filing
npm run skill:upload skills/check-a-customs-filingValidate kontroluje formát a testovacie prípady. Upload vytvorí koncept a ak sa obsah zhoduje s už zverejnenou verziou, vráti namiesto toho túto verziu (CONTENT_HASH_ALREADY_PUBLISHED). Publish je pozdržané na schválenie, keď to zručnosť vyžaduje, a vlastnú zmenu schváliť nemôžete. Beh spustený zo skriptu bez trasy modelu je odmietnutý s SKILLS_ENGINE_BINDING_MISSING: trasu vyberá dispečer a engine kontroluje, či ju dostal, nikdy ju neháda. Kapitola 2.24, Budovanie vlastného vertikálneho riešenia od začiatku do konca, ukazuje tie isté skripty v celom projekte.
Agenti a Claude Code sa ku knižnici dostanú aj cez MCP, celkovo prostredníctvom 13 nástrojov. Medzi nimi list_skills a get_skill vyhľadajú a prečítajú zručnosť, match_prompt a discover_skills určia, ktorá zručnosť sa hodí na úlohu, invoke_skill ju spustí a sync_skills_local skopíruje knižnicu do vášho priečinka zručností. Každé volanie beží ako osoba, ktorá ho spustila, v rámci jej zoznamu povolených nástrojov. Zručnosť nikdy nemôže rozšíriť svoje nástroje nad rámec zoznamu povolených nástrojov toho, kto ju spúšťa.
Projektový súbor CLAUDE.md, ktorý nesie pravidlá platformy
Claude Code na začiatku každej relácie načíta CLAUDE.md v koreňovom adresári repozitára. Je to najlacnejšie bezpečnostné opatrenie, aké máte, pretože predloží modelu pravidlá platformy skôr, ako čokoľvek napíše. Kontroly SDK (súpravy na vývoj softvéru) aj tak zachytia väčšinu chýb, ale pravidlo, ktoré model prečítal vopred, vás nestojí žiadne neúspešné zostavenie.
Píšte ho ako pravidlá s ich dôvodmi, nie ako želania. Tu je ten z repozitára nášho pluginu Cold chain, mierne skrátený:
# 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>.Takýto súbor funguje vďaka trom veciam. Každé pravidlo uvádza mechanizmus, ktorý ho vynucuje, takže model môže svoju prácu overiť voči tomu istému, voči čomu ju overí pipeline. Definícia hotovej práce je zoznam príkazov s návratovými kódmi, nie pocit. A zakazuje konkrétne skratky, po ktorých model siahne, keď je zostavenie červené, napríklad odstránenie testu alebo nahradenie chýbajúcej organizácie zástupnou hodnotou.
Poskytnutie korpusu SDK ako kontextu
Dokumentácia SDK je súbor 28 zväzkov napísaných tak, aby vývojár alebo LLM (veľký jazykový model) dokázal zostaviť kompletný produkčný plugin iba z tohto korpusu, bez prístupu k súkromnému kódu platformy. Každý tvar prenášaných dát a každý chybový kód, s ktorým sa plugin stretne, je priamo v dokumentoch.
Vďaka tomu je to nezvyčajne dobrý kontext. V praxi dávam Claude Code zväzky, ktorých sa úloha týka, a nie celý súbor: zväzky o manifeste a HTTP pre novú trasu, zväzok o databáze pre migráciu, katalóg chýb vždy, keď ide o odmietnutie, a kontrolný zoznam zhody vždy, pretože predstavuje celý korpus vo forme zoznamu na odškrtávanie. Povedzte modelu, aby uprednostňoval zistený fakt pred vlastnou pamäťou o tom, ako framework zvyčajne funguje. Keď sa tieto dve veci rozchádzajú, o tejto platforme má pravdu korpus.
Pre frontendového vývojára vo vašom tíme vygenerujte príručku z manifestu namiesto toho, aby ste ju písali:
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin guide --manifest nexus.manifest.json --narrative docs/guide --out docs/GUIDE.mdUvádza každú trasu, ktorú môže webová aplikácia volať, s každým odmietnutím, ktoré môže dostať späť, takže je to dobrý kontext aj pre model, ktorý píše webovú aplikáciu. Commitnite ju a kontrolujte ju v CI (kontinuálnej integrácii) pomocou --check --lint, aby sa nemohla od manifestu odchýliť.
Obalenie existujúceho repozitára: /plugin-create
Zručnosť /plugin-create premení existujúci repozitár alebo špecifikáciu API (aplikačného programového rozhrania) na plugin Nexus. Pri jej vyvolaní jej zadajte zdroj:
/plugin-create https://github.com/<owner>/<repo>
Pracuje vo fázach. Najprv zdroj naklonuje a analyzuje, pričom zisťuje jazyk a framework, rozsah API, databázu a jej migrácie a to, čo daná vec skutočne robí. Vypíše správu z analýzy a na základe zistení zvolí stratégiu obalenia:
| Zdroj | Stratégia |
|---|---|
| REST (representational state transfer) API v Node.js | Obal Express okolo existujúcich trás |
| REST API v Pythone | Obal FastAPI |
| Full-stack Node.js a React | Backendový obal s adaptérom používateľského rozhrania (UI) |
| Nástroj príkazového riadka | Express API, ktoré spúšťa príkazy |
| Knižnica alebo SDK | Express API sprístupňujúce jej funkcie |
| Komplexná platforma | Jeden kontajner pluginu s proxy nginx pred ním |
Potom vygeneruje backend a jeho migrácie, UI, manifest a testy. To, čo napíše, berte ako silný prvý návrh a posudzujte ho podľa rovnakého štandardu ako čokoľvek iné. V našom repozitári to znamenalo tri kroky predtým, ako to ktokoľvek posúdil. Jeho manifest sme pozdvihli na kontrakt v2 pomocou create-nexus-plugin migrate --write, ktorý pridá právne vety a odmietne si vymyslieť vstupný bod. Potom sme zabezpečili, aby prešiel create-nexus-plugin validate. A spúšťali sme nexus-gates, kým nebol zelený, čo v našom prípade znamenalo nahradiť hlavičky tenanta, ktoré si obal čítal sám, strážcom rozsahu zo SDK a pridať do jeho tabuliek tri osi. Nasadenie zostáva na kanáloch vydaní inštalácie; akékoľvek súbory nasadenia, ktoré návrh obsahuje, ignorujte.
mockup-compiler: od obrazoviek k funkčnému kódu
Druhý kompilátor funguje opačne. mockup-compiler vezme makety projektu, ktorých môžu byť tisíce obrazoviek, a skompiluje ich do funkčného UI, trás backendu pre frontend (BFF) a SQL, pričom ich vernosť obrazovku po obrazovke dokazujú brány s návratovými kódmi. Každé nakreslené slovo vystopuje k riadku zdrojového kódu, ktorý ho nakreslil, priradí každú obrazovku k jej špecifikácii, určí zmeny domény, ktoré obrazovky potrebujú, a vygeneruje kontrakty a migrácie spolu so špecifikáciou demo údajov, ktoré každá obrazovka potrebuje.
Od toho, aby ste model požiadali „postav tieto obrazovky“, ho odlišujú dve pravidlá:
- Najprv kompilátor. Všetko, čo sa dá zistiť, sa vypočíta deterministicky. Model sa používa iba na typované medzery: napíše artefakt podľa schémy, deterministický kontrolór ho prijme alebo pomenuje každú chybu a model dostane najviac 3 kolá opráv, do ktorých sa mu odovzdá správa kontrolóra.
- Každá brána má negatívnu kontrolu s podstrčenou chybou. Keď
verifyspúšťa brány projektu pre obrazovku, kópia stromu dostane jednu podstrčenú chybu na každú bránu, a ak brána svoju podstrčenú chybu prepustí, celý beh sa označí ako nedôveryhodný. Brána, ktorá nemôže zlyhať, beh preruší.
Práca prebieha v etapách, každá s vlastným režimom a vlastnou bránou:
| Etapa | Režim | Čo dokazuje jej brána |
|---|---|---|
| Zafixovanie | pin |
Kresba je v dvoch zostaveniach identická, s jedinečnými ID obrazoviek |
| Stopovanie | trace |
Každé nakreslené slovo je vystopované k práve jednému riadku zdrojového kódu |
| Spojenie | join |
Každý skompilovaný slot zodpovedá zdroju, ktorý ho nakreslil |
| Špecifikácia | spec |
Každá obrazovka má svoj riadok špecifikácie |
| Zmena domény | domain |
Návrh pokrýva všetko, čo obrazovky čítajú a zapisujú, s kódmi z katalógu SDK |
| Kontrakty | shape-check, emit-contracts |
Každé čítané pole má tvar prevzatý zo svojho stĺpca alebo deklarovaný |
| SQL a úložisko | emit-sql, emit-store |
Migrácia sa aplikuje na skutočný Postgres, s testami, ktoré najprv zlyhajú |
| Svet | world |
Demo údaje pokrývajú bunky každej obrazovky |
| Väzba | bind |
Rozhodnutá časť každej väzby, pričom zvyšok je uvedený ako pomenované medzery |
| Overenie | verify |
Vlastné brány projektu pre každú obrazovku, pri každej je dokázané, že môže zlyhať |
Jediným vstupom špecifickým pre projekt je .mockup-compiler.json, adaptér. Určuje, ako stránka označuje jednu obrazovku a aké idiómy SQL a úložiska sa majú generovať. Pomenúva tiež osi tenancie vrátane tej, ktorá je na začiatku každého kľúča, a autorizačné volanie, ktoré vykonáva každý zápis. mockup-compiler init --project <dir> napíše kostru, v ktorej je každá nevyplnená položka odmietnutá s uvedením názvu. Projekt bez vlastného kompilátora UI nemôže použiť compile, baseline-check, join ani world a tieto režimy to oznámia pomocou NO_PROJECT_COMPILER namiesto toho, aby zlyhali až neskôr.
Pravidlo, ktoré by som si z toho vzal, aj keby ste ho nikdy nespustili: pravidlo zápisu, ktoré špecifikácia neuvádza, sa stane poctivým 501, ktorý pomenuje, čo chýba, nikdy nie odhadom. To je rovnaké pravidlo, aké chcem od akéhokoľvek modelu, ktorý píše kód podľa obrazoviek.
Priradenie autorstva generátoru
Keď commit napíše nástroj, commit by to mal uvádzať. Kontrakt atribúcie generátora vyžaduje v správe commitu jeden riadok trailera:
feat(excursions): page the nightly telemetry load
X-Generator: claude-code/<model>
Identita je <harness>/<model>, malými písmenami, s jednou lomkou: harness je nástroj, ktorý bežal (claude-code), a model je ten, ktorý v ňom bežal. Ak sa model počas práce, ktorú commit uzatvára, zmenil, pridajte X-Generator-Session s každou identitou, od najstaršej, aby sa práca nepripísala tomu modelu, ktorý bol náhodou aktívny v čase commitu. Služba, ktorá obaľuje commit niekoho iného, napríklad fronta zlúčení, tieto trailery prenáša ďalej.
Dve vlastnosti z toho robia niečo užitočné, nie dekoratívne. Tvrdenie, ktoré čitateľ nerozpozná, sa zachová a zobrazí pod unregistered/<harness> s presne zachovaným textom, nikdy sa nezahodí. A trailer je pôvod deklarovaný samotným nástrojom, nikdy nie dôkaz: nič ho nepodpisuje, preto každé rozhranie, ktoré tieto tvrdenia počíta, zobrazuje toto upozornenie vedľa čísel. Gramatika identity je publikovaná spolu so SDK ako @adverant-nexus/plugin-sdk/schema/generator-id. Nie je to pole manifestu, pretože nástroj, ktorý napísal commit, je fakt o commite, nie o plugine.
Kontrola kódu, ktorý napísala AI
Nástroj píše rýchlo a sebaisto rovnakým tónom bez ohľadu na to, či má pravdu, alebo nie. Môj postup pri kontrole jeho zmien je krátky a nič z neho nevynechávam:
- Čítajte diff, nie zhrnutie. Zhrnutie hovorí, čo model zamýšľal urobiť.
- Definíciu hotovej práce spustite sami, od čistého stavu:
npm ci, testy, zostavenie,validateanexus-gates. Posledné riadky citujte v kontrole. - Pri každom novom teste skontrolujte, či zlyhá na strome pred zmenou. Test, ktorý prejde v oboch prípadoch, je len dekorácia.
- Hľadajte skratky. Odstránený alebo preskočený test, nová položka pod
gates/bez zdôvodnenia, hodnota tenanta prečítaná z tela alebo hlavičky, predvolená organizácia,catch, ktorý pohltí odmietnutie, volanie fetch na adresu, ktorú manifest nedeklaruje. - Porovnajte manifest s posledným vydaním. Akýkoľvek nový rozsah alebo odchádzajúca adresa je rozšírením a rozšírenia dostávajú dvoch kontrolórov.
- Skontrolujte, či testy odmietnutí overujú celé telo:
error,code,resolved[],missing[]atroubleshooting[]. - Skontrolujte, či commit obsahuje svoj trailer
X-Generator.
Brány zachytia mechanické chyby. Nedokážu vám povedať, či trasa patrí na zoznam non-CRUD, ani či je backend právne blokovaný, a nedokáže to ani model; tento úsudok zostáva na vás. Ak sa ten istý problém stále vracia, opravte CLAUDE.md, nielen kód.
Šesť praktických zadaní
Každý prompt nižšie je jeden z tých, ktoré som použil, mierne upravený. Po každom nasleduje: čo by mal nástroj vytvoriť a brána, ktorá dokazuje, že to urobil. Ak brána nie je zelená, práca nie je hotová, nech zhrnutie hovorí čokoľvek.
1. Nová zručnosť pre 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.
Mal by vytvoriť skills/summarise-excursion/SKILL.md s name, description, allowed-tools, triggers, capabilities a version vo frontmatter, svoje inštrukcie v tele a testovacie prípady, ktoré zahŕňajú podstrčenú inštrukciu. Dôkazom je npm run skill:validate skills/summarise-excursion s nulovým počtom chýb, potom npm run skill:upload skills/summarise-excursion --dry-run zobrazujúci plán. Publikovanie je následne rozhodnutím človeka a zručnosť, ktorá zapisuje, potrebuje v edícii Enterprise dvoch menovaných schvaľovateľov.
2. Trasa plnohodnotného pluginu so službou
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.
Mal by vytvoriť očíslovanú migráciu, ktorá pridá stĺpec do tabuľky nesúcej tri osi, obe trasy deklarované v api.endpoints[] s ich auth a right, právo v registri rights, obslužné funkcie za strážcom rozsahu a testy, ktoré overujú, že neautentifikovaná požiadavka a požiadavka so zlou organizáciou sú odmietnuté s úplnými telami. Dôkazom je nexus-gates: scope-adherence, crud-adherence, api-contract, rights-register a migrations-are-scoped prejdú a výstup testov, ktoré najprv zlyhali, je v prepise.
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.
Mal by použiť nexus.create s plánom, ktorý potvrdíte, a potom tvarovať lens voči jeho základu. Ak sa pokúsi zobraziť niečo, čo základ nezobrazuje, register to odmietne s LENS_CANNOT_WIDEN a nástroj by to mal nahlásiť namiesto toho, aby hľadal obchádzku. Dôkazom je náhľad v úlohe človeka a pri povýšení kontrola politiky pilotnej brány, že lens iba zužuje a osobné polia má predvolene vypnuté.
4. Doménový balík
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.
Mal by vytvoriť plán sprievodcu so zoznamom repozitára a jeho prvej zmeny, deklarovaných rozsahov a troch vetiev syntetických údajov, plus pack.json s jeho klastrami lensov a lexikónom. Nič sa nevytvorí, kým nepotvrdíte odtlačok. Dôkazom je, že testy šablóny prejdú na syntetických vetvách, a neskôr stagingová brána. Ak balík žiada viac ako jeho posledné vydanie, vydanie sa zadrží s MANIFEST_SCOPE_WIDENED, kým ho neprijmú dvaja kontrolóri.
5. Dátový 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.
Mal by vytvoriť zručnosť plugin_queue, ktorej queueName je <plugin name>.<name> bez dvojbodky, timeoutMs medzi 1 sekundou a 6 hodinami, worker, ktorý vyberá z fronty, migráciu pre tabuľku udalostí, odchádzajúcu adresu v manifeste balíka (nie v nexus.manifest.json, ktorého schéma takéto pole nemá) a názov premennej poverenia v scripts/ci/required-env. Dôkazom je create-nexus-plugin validate, ktorý uplatňuje vlastné pravidlá synchronizácie registra pre názvy front a časové limity, potom nexus-gates so zelenými no-credentials a no-direct-compute. Za behu sa volanie na akúkoľvek adresu, ktorú manifest balíka nedeklaroval, zastaví na okraji 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.
Mal by vytvoriť RouteModule s jeho id, featureGroup, prázdnym bodies a register, ktorý pripojí router k aplikácii hostiteľa, s kontrolou oprávnenia v každej obslužnej funkcii a telom odmietnutia v štandardnom tvare. Dôkazom je, že brána licenčného riadka skončí s kódom 0, potom npm ci, npm test a npm run build prejdú v každom zostavenom strome edície. Kapitola 2.25, Vývoj pre každú edíciu, ukazuje kostru modulu a to, čo brána odmieta.
Koľko to stojí
Pracovať takto je rýchlejšie, no nie je to zadarmo. Každý prechod agenta má rozpočet a životnosť jednej hodiny a dlhý refaktoring znamená jeho obnovovanie. Read-taint zabráni relácii, ktorá prečítala jeden zákaznícky dokument, čokoľvek zapísať, kým to nepotvrdíte, čo je prvých pár razy otravné a presne správne. Skript nikdy nemôže zmeniť nič mimo vášho sandboxu, takže automatizácia, ktorá potrebuje dosiahnuť staging, prechádza žiadosťou o zmenu a dvoma kontrolórmi ako všetci ostatní. Radšej budem mať tieto obmedzenia, než aby som spoločnosti Larkfield vysvetľoval, prečo asistent niekam poslal e-mailom ich tabuľku poistných udalostí.




