PrijavaRezervirajte predstavitev

Poglavje 2.26

Gradnja z orodji UI za programiranje

Kako varno graditi razširitve za Nexus z orodjem Claude Code in drugimi orodji za programiranje z UI (umetno inteligenco). Začne se s povezovanjem vašega IDE (integriranega razvojnega okolja) z delovnim okoljem Workbench in projektno datoteko CLAUDE.md, ki vsebuje pravila platforme, konča pa s šestimi praktičnimi pozivi in kontrolno točko, ki potrjuje vsakega izmed njih.

To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

24 min branja

Večino paketa Cold chain v poglavju 2.24, Gradnja vertikale po meri od začetka do konca, sem napisal z Claude Code, odprtim v terminalu ob meni. To je danes pri Corrán Orbital običajno in Nexus je bil zgrajen s tem pričakovanjem. Platforma orodja za programiranje z UI (umetno inteligenco) ne obravnava kot pametnega samodejnega dokončevanja. Obravnava ga kot agenta, ki deluje v imenu poimenovane osebe, s prepustnico, ki je vedno ožja od prepustnice te osebe, in beleži vsak klic, ki ga agent izvede.

To poglavje govori o tem, kako tako delati, ne da bi se opekli. Začne se s povezovanjem vašega IDE (integriranega razvojnega okolja), nato obravnava veščine v urejevalniku, projektno datoteko, ki orodje nauči pravil platforme, dva prevajalnika, ki obstoječe delo pretvorita v kodo Nexus, kako commiti navedejo, katero orodje jih je napisalo, in kako pregledujem, kar orodje ustvari. Konča se s šestimi pozivi, ki bi jih dal sodelavcu, vsak s tem, kaj naj vrne, in z vrati, ki to dokazujejo.

Povezovanje vašega IDE z okoljem Nexus

Vsaka namestitev ima en naslov Workbench za orodja za programiranje z UI. Najdete ga na strani Povežite svoj IDE pod Razvijalci, Claude Code pa se poveže z enim ukazom:

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

<workbench-address> je naslov, ki ga prikazuje stran, z gumbom za kopiranje ob njem. Druga orodja imajo na isti strani lastne enovrstične ukaze: codex mcp add workbench --url <workbench-address> za Codex, namestitveno povezavo za Cursor in code --add-mcp z majhnim argumentom JSON za VS Code s Copilotom. Vsa komunicirajo prek MCP (Model Context Protocol) z istim naslovom.

Povežite svoj IDE
Povežite svoj IDE
Povežite svoj IDE, z enim ukazom na orodje in privzetimi ravnmi na desni. Diagram na dnu prikazuje, kako vsak klic preide Workbench, dobi lastno kratkotrajno poverilnico in pristane le v lastnem prostoru organizacije v vsaki shrambi.

Ključa ni treba prilepiti. Prvi klic odpre vaš brskalnik, ki natančno pokaže, kaj zahteva dostop: katero orodje na katerem računalniku, v imenu koga in katere ravni želi. Dovolite ga s svojim ključem za dostop (passkey) in od takrat orodje nima nobenega gesla za bazo podatkov ali datoteke kubeconfig, le prepustnico, ki poteče. Za naslovom Nexus za vsako shrambo in za vsako zahtevo ustvari kratkotrajno poverilnico, v vašem imenu.

Skrbnik organizacije lahko prenese tudi datoteko z upravljanimi nastavitvami, tako da se vsaka podjetniška kopija Claude Code poveže s tem strežnikom in z nobenim drugim:

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

Ravni in prepustnice

Vsaka prijava v Workbench dobi prepustnico, sestavljeno iz poimenovanih ravni. Privzeto ima razvijalec ravni Observe in Sandbox na lastnih enotah.

Raven Kaj omogoča Kdo jo dobi
Observe Branje vaših enot, vključno z dnevniki in metrikami, ter poizvedbe po maskirani kopiji Privzeto
Sandbox Pisanje v lastnem prostoru: vašem razvojnem prostoru in lastnih podatkovnih vejah Privzeto
Propose Odpiranje zahteve za spremembo; po pregledu jo uveljavi cevovod Zahtevano ob prvi uporabi
Elevate Eno časovno omejeno dejanje na enem cilju, ki ga odobri poimenovana oseba Samo osebe, nikoli zgolj s prijavo
Break-glass Dostop v sili Samo skrbniki platforme, z dvema odobriteljema

Agent vedno deluje v imenu osebe in je prikazan v lastni vrstici. Njegova prepustnica ni nikoli širša od vaše in nikoli ne vključuje ravni Elevate ali nemaskiranih podatkov. Velja eno uro in se podaljšuje le, dokler ste dejavni v Nexusu ali IDE. Prepustnica osebe velja 8 ur. Orodje, ki ga pustite delovati čez noč, se tako ustavi samo, in ko končate svojo prepustnico, se konča tudi prepustnica vašega agenta. Vsaka prepustnica agenta ima tudi proračun za stroške modela, ki je ocenjen pred dodelitvijo prepustnice in med delovanjem prikazan kot merilnik.

Stran Moje prepustnice za dostop navaja vse prepustnice, ki jih imate vi in vaši agenti, z njihovimi ravnmi in dosedanjimi stroški, ter omogoča, da vsako podaljšate, zožite ali končate. Končanje prepustnice takoj ustavi naslednji klic; zapis vsakega klica ostane. Vsaka prepustnica ima tudi trde omejitve, ki so bile pri nas 200 vrstic in 30 sekund na poizvedbo ter 50 spremenjenih objektov v razvojnem prostoru na sejo.

Prva seja v IDE

Ko ste povezani, /mcp v Claude Code navede orodja Workbench, razvrščena po ravneh. Skupina Observe vsebuje orodja za branje: workbench.k8s.describe, workbench.k8s.events, workbench.logs.query, workbench.metrics.query, workbench.traces.get, workbench.db.schema, workbench.db.query na maskirani kopiji, workbench.graph.query in workbench.vector.search. Sandbox doda workbench.devspace.deploy, workbench.branch.create in workbench.branch.reset. Propose doda orodja, ki odprejo zahtevo za spremembo in načrtujejo spremembo grafa. Elevate sploh ni na prepustnici; zanjo zaprosite v konzoli.

V IDE: prva seja
V IDE: prva seja
Prva seja v Claude Code, z orodji, navedenimi po ravneh, ponovnim zagonom, izsledenim do vzroka, in zavrnjeno zahtevo za geslo baze podatkov. Vsak odgovor navede, od kod izvira in kaj je bilo skrito.

Moje prvo pravo vprašanje je bilo, zakaj se je naš bralnik telemetrije v Rotterdamu čez noč znova zagnal. Claude Code je opisal delovno obremenitev (dva ponovna zagona, zmanjkalo pomnilnika ob omejitvi 512 MiB), poizvedel po dnevnikih (organizacijo nastavi prehod, osebni podatki so zakriti) in metriki pomnilnika ter ugotovil, da je nočno nalaganje celo noč odčitkov potegnilo v en paket. Nato sem ga, napol za preizkus, vprašal za geslo baze podatkov, ki ga uporablja storitev. Workbench je zahtevo zavrnil z SECRET_NEVER_SHOWN. Prikaže ime skrivnosti (Secret) in zadnje štiri znake, vrednosti pa nikoli in nikomur. Odgovor pomočnika je bil pravi: gesla ne potrebuje, ker vsaka njegova poizvedba dobi lastno kratkotrajno poverilnico, vlogo samo za branje, ustvarjeno za to eno zahtevo.

Najprej načrt, nato uveljavitev

Vsako orodje, ki kaj spremeni, najprej prikaže načrt. Načrt je diff s štetji in prstnim odtisom, uveljavitev pa izvede natanko ta načrt.

V IDE: najprej načrt, nato uveljavitev
V IDE: načrt, nato uveljavitev
Omejitev pomnilnika, povišana v razvojnem prostoru na podlagi načrta, nato ista sprememba zunaj peskovnika. V interaktivni seji jo oseba potrdi v IDE; iz skripta brez vmesnika je zavrnjena.

V vašem lastnem razvojnem prostoru se uveljavitev izvede takoj. Zunaj njega mora oseba potrditi v IDE, sprememba pa gre v cevovod, ki jo uveljavi po pregledu. Iz tega izhajata dve zavrnitvi in obe sta me ujeli:

  • Iz skripta, pri katerem nihče ne sedi za tipkovnico, na primer claude -p v opravilu cron, potrditvenega okna ni mogoče prikazati, zato je sprememba zunaj peskovnika zavrnjena z CONFIRMATION_UNAVAILABLE. Nič se ne zgodi. Zaženite jo v interaktivni seji.
  • Uveljavitev, ki navaja načrt, ki ga ta seja ni ustvarila, ali načrt, ki se je spremenil, je zavrnjena z PLAN_FINGERPRINT_MISMATCH, preden se karkoli izvede. Načrtujte znova.

Okužba z branjem

Vsebina strank lahko skriva navodila, namenjena pomočniku. Zato seja, ko jo je prebrala, izgubi orodja za pisanje in za dostop zunaj Nexusa, dokler oseba ne potrdi enega zapisa ali ne začne nove seje.

V IDE: okužba z branjem
V IDE: okužba z branjem
Dokument o zahtevku, prebran na maskirani kopiji, s skritim navodilom, ki ga je pomočnik prezrl. Naslednji zapis je zavrnjen, dokler oseba ne potrdi tega enega zapisa ali ne začne nove seje.

Na to sem naletel pri dokumentu o zahtevku, ki je vseboval odstavek, naslovljen na »pomočnika«, s prošnjo, naj tabelo zahtevkov kopira na zunanji naslov. Claude Code ga je prezrl in to povedal. Ko sem ga nato prosil, naj odstopanje doda v graf moje veje, je bil zapis zavrnjen z SESSION_TAINTED. Lahko sem potrdil ta en zapis, potem ko sem prebral njegov načrt, ali začel novo sejo, ki dokumenta ni prebrala. Dnevniki in metrike seje ne okužijo. Dokumenti, zahtevki za podporo, pošta in izvorno besedilo grafa jo. Skrito besedilo je bilo v mojem zapisu dejavnosti šteto kot navodila, najdena v vsebini, brez njegovih besed.

Druga organizacija

Nič, kar vnesete, ne more doseči podatkov druge organizacije. Če jih zahtevate, vsaka shramba zavrne z TENANT_BOUNDARY. Vrednost organizacije, podtaknjeno v poizvedbo po dnevnikih, prehod zamenja z vašo. Ne gre za manjkajoče dovoljenje. Vsaka plast na poti je omejena na vašo organizacijo, zato ni nikogar, ki bi ga lahko dodelil s položaja, kjer ste, in tudi dostop skrbnika platforme ne bi pomagal. Če se dve organizaciji dogovorita za skupno rabo podatkov, je to dogovor, vzpostavljen med njima, nikoli nekaj, kar naredi seja IDE.

Veščine v IDE in orodju Claude Code

Veščine Skills Engine so mape SKILL.md in Claude Code bere iste mape. Knjižnica se sinhronizira v ~/.claude/skills v vašem domačem imeniku, samo za branje, vaši osnutki pa so ob njih v ~/.claude/skills/drafts. Tako so veščine, ki jih je objavila vaša organizacija, na voljo v vašem urejevalniku brez kopiranja, kar pa napišete lokalno, gre nazaj skozi iste teste in odobritev kot vse, kar je napisano v konzoli.

Veščine v okolju IDE in Claude Code
Veščine v IDE in orodju Claude Code
Veščina, napisana in preizkušena v urejevalniku, nato poslana skozi isto odobritev kot veščina, ustvarjena v konzoli. Opazite, da je bila objava zadržana, ker avtor ne more odobriti lastne spremembe.

Iz terminala v repozitoriju, ki vsebuje veščino, jo dva skripta npm preneseta iz vašega urejevalnika v knjižnico:

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

Validate preveri obliko in testne primere. Upload ustvari osnutek, in če se vsebina ujema z že objavljeno različico, namesto tega vrne to različico (CONTENT_HASH_ALREADY_PUBLISHED). Objava je zadržana za odobritev, kadar jo veščina potrebuje, lastne spremembe pa ne morete odobriti. Zagon iz skripta brez poti modela je zavrnjen z SKILLS_ENGINE_BINDING_MISSING: pot izbere razdeljevalnik, pogon pa preveri, ali jo je prejel, in je nikoli ne ugiba. Poglavje 2.24, Gradnja vertikale po meri od začetka do konca, prikazuje iste skripte v celotnem projektu.

Agenti in Claude Code do knjižnice dostopajo tudi prek MCP, skupno s 13 orodji. Med njimi list_skills in get_skill poiščeta in prebereta veščino, match_prompt in discover_skills povesta, katera veščina ustreza nalogi, invoke_skill eno zažene, sync_skills_local pa kopira knjižnico v vašo mapo z veščinami. Vsak klic se izvede kot oseba, ki ga je začela, znotraj njenega seznama dovoljenih. Veščina nikoli ne more razširiti svojih orodij čez seznam dovoljenih osebe, ki jo zažene.

Projektna datoteka CLAUDE.md s pravili platforme

Claude Code na začetku vsake seje prebere CLAUDE.md v korenu repozitorija. To je najcenejši varnostni ukrep, ki ga imate, ker pravila platforme postavi pred model, preden ta karkoli napiše. Vrata SDK (kompleta za razvoj programske opreme) bodo večino napak tako ali tako ujela, a pravilo, ki ga je model prebral vnaprej, vas ne stane neuspele gradnje.

Napišite jo kot pravila z razlogi, ne kot težnje. Tukaj je tista iz našega repozitorija vtičnika Cold chain, rahlo skrajšana:

# 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>.

Tri stvari poskrbijo, da taka datoteka deluje. Vsako pravilo navede mehanizem, ki ga uveljavlja, tako da lahko model svoje delo preveri z istim, s čimer ga bo preveril cevovod. Definicija dokončanega je seznam ukazov z izhodnimi kodami, ne občutek. Prepoveduje pa tudi konkretne bližnjice, po katerih model poseže, ko je gradnja rdeča, na primer brisanje testa ali privzeto nadomeščanje manjkajoče organizacije z ogradno vrednostjo.

Podajanje korpusa SDK kot konteksta

Dokumentacija SDK obsega 28 zvezkov, napisanih tako, da lahko razvijalec ali LLM (veliki jezikovni model) zgradi popoln produkcijski vtičnik samo iz tega korpusa, brez dostopa do zasebne kode platforme. Vsaka oblika podatkov na povezavi in vsaka koda napake, na katero naleti vtičnik, je v samih dokumentih.

Zato je to nenavadno dober kontekst. V praksi Claude Code dam zvezke, ki se jih naloga dotika, in ne celotnega kompleta: zvezka o manifestu in HTTP za novo pot, zvezek o bazi podatkov za migracijo, katalog napak, kadar koli gre za zavrnitev, in vedno kontrolni seznam skladnosti, ker je to celoten korpus v obliki seznama za odkljukanje. Modelu naročite, naj ima opaženo dejstvo prednost pred lastnim spominom o tem, kako ogrodje običajno deluje. Ko se razlikujeta, ima o tej platformi prav korpus.

Za razvijalca uporabniškega vmesnika v vaši ekipi vodnik ustvarite iz manifesta, namesto da bi ga pisali:

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

Navaja vsako pot, ki jo spletna aplikacija sme klicati, z vsako zavrnitvijo, ki jo lahko prejme, zato je dober kontekst tudi za model, ki piše spletno aplikacijo. Vnesite ga v repozitorij in ga v CI (neprekinjeni integraciji) preverjajte z --check --lint, da se ne more oddaljiti od manifesta.

Ovijanje obstoječega repozitorija: /plugin-create

Veščina /plugin-create obstoječi repozitorij ali specifikacijo API (programskega vmesnika aplikacije) pretvori v vtičnik Nexus. Ob klicu ji podajte vir:

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

Deluje v fazah. Najprej klonira in analizira vir ter ugotovi jezik in ogrodje, površino API, bazo podatkov in njene migracije ter kaj stvar dejansko počne. Izpiše poročilo o analizi in na podlagi ugotovitev izbere strategijo ovijanja:

Vir Strategija
API REST (representational state transfer) v Node.js Ovojnica Express okoli obstoječih poti
API REST v Pythonu Ovojnica FastAPI
Celovita aplikacija (full-stack) v Node.js in React Zaledni ovoj z vmesnikom za uporabniški vmesnik (UV)
Orodje ukazne vrstice API Express, ki izvaja ukaze
Knjižnica ali SDK API Express, ki izpostavlja njene funkcije
Kompleksna platforma En vtičniški vsebnik s posredniškim strežnikom nginx pred njim

Nato ustvari zaledje in njegove migracije, uporabniški vmesnik, manifest in teste. To, kar napiše, obravnavajte kot dober prvi osnutek in zanj veljajo enaki standardi kot za vse drugo. V našem repozitoriju je to pomenilo tri korake, preden ga je kdor koli pregledal. Njegov manifest smo z create-nexus-plugin migrate --write dvignili na pogodbo v2, ki doda zakonske stavke in zavrne izmišljanje vstopne točke. Nato smo poskrbeli, da je prestal create-nexus-plugin validate. In nexus-gates smo izvajali, dokler ni postal zelen, kar je v našem primeru pomenilo, da smo glave najemnika, ki jih je ovoj bral sam, nadomestili z varovalom obsega iz SDK in njegovim tabelam dodali tri osi. Uvajanje ostaja v pristojnosti kanalov izdaj namestitve; morebitne datoteke za uvajanje v osnutku prezrite.

mockup-compiler: od zaslonskih osnutkov do delujoče kode

Drugi prevajalnik deluje ravno obratno. mockup-compiler vzame makete projekta, ki lahko obsegajo na tisoče zaslonov, in jih prevede v delujoč uporabniški vmesnik, poti zaledja za čelni del (BFF) in SQL, pri čemer vrata z izhodnimi kodami zaslon za zaslonom dokažejo zvestobo. Vsako narisano besedo izsledi do vrstice izvorne kode, ki jo je narisala, vsak zaslon poveže z njegovo specifikacijo, ugotovi spremembe domene, ki jih zasloni potrebujejo, ter izda pogodbe in migracije skupaj s specifikacijo predstavitvenih podatkov, ki jih potrebuje vsak zaslon.

Od prošnje modelu, naj »izdela te zaslone«, ga ločita dve pravili:

  • Najprej prevajalnik. Vse, kar je mogoče vedeti, se izračuna deterministično. Model se uporablja le za tipizirane vrzeli: artefakt napiše glede na shemo, deterministični preverjevalnik ga sprejme ali poimenuje vsako napako, model pa dobi največ 3 kroge popravkov, ki jih napaja poročilo preverjevalnika.
  • Vsaka vrata imajo negativno kontrolo s podtaknjeno napako. Ko verify za zaslon izvaja vrata projekta, kopija drevesa dobi po eno podtaknjeno napako na vrata, in če katera vrata prepustijo svojo podtaknjeno napako, je celoten zagon označen kot nezaupanja vreden. Vrata, ki ne morejo odpovedati, prekinejo zagon.

Delo poteka v fazah, vsaka s svojim načinom in svojimi vrati:

Faza Način Kaj dokazujejo njena vrata
Pripenjanje pin Risba je v dveh gradnjah enaka, z enoličnimi ID-ji zaslonov
Sledenje trace Vsaka narisana beseda je izsledena do natanko ene vrstice izvorne kode
Povezovanje join Vsako prevedeno mesto se ujema z izvorom, ki ga je narisal
Specifikacija spec Vsak zaslon ima svojo vrstico specifikacije
Sprememba domene domain Predlog zajema vse, kar zasloni berejo in pišejo, s kodami iz kataloga SDK
Pogodbe shape-check, emit-contracts Vsako prebrano polje ima obliko, vzeto iz njegovega stolpca ali deklarirano
SQL in shramba emit-sql, emit-store Migracija se uveljavi na pravi bazi Postgres, s testi, ki najprej odpovejo
Svet world Predstavitveni podatki pokrivajo celice vseh zaslonov
Vezava bind Odločeni del vsake vezave, preostanek pa je naveden kot poimenovane vrzeli
Preverjanje verify Lastna vrata projekta za vsak zaslon, za vsaka je dokazano, da lahko odpovejo

Edini vnos, specifičen za projekt, je .mockup-compiler.json, vmesnik. Določa, kako stran označi en zaslon ter katere idiome SQL in shrambe naj izda. Poimenuje tudi osi najemništva, vključno s tisto, ki je na začetku vsakega ključa, in klic avtorizacije, ki ga izvede vsako pisanje. mockup-compiler init --project <dir> napiše ogrodje, v katerem je vsak neizpolnjen vnos zavrnjen po imenu. Projekt brez lastnega prevajalnika uporabniškega vmesnika ne more uporabljati compile, baseline-check, join ali world, ti načini pa to povedo z NO_PROJECT_COMPILER, namesto da bi odpovedali pozneje.

Pravilo, ki bi ga povzel, tudi če ga nikoli ne zaženete: pravilo pisanja, ki ga specifikacija ne navaja, postane pošten odgovor 501, ki poimenuje, kaj manjka, nikoli ugibanje. To je isto pravilo, ki ga pričakujem od vsakega modela, ki piše kodo za zaslone.

Pripis avtorstva generatorju

Ko orodje napiše potrditev, mora potrditev to navesti. Pogodba o pripisovanju generatorja zahteva eno zaključno vrstico v sporočilu potrditve:

feat(excursions): page the nightly telemetry load

X-Generator: claude-code/<model>

Identiteta je <harness>/<model>, z malimi črkami in eno poševnico: ogrodje je orodje, ki se je izvajalo (claude-code), model pa tisti, ki ga je to izvajalo. Če se je model med delom, ki ga potrditev zaključuje, zamenjal, dodajte X-Generator-Session z vsako identiteto, od najstarejše naprej, da dela ne pripišete modelu, ki je bil slučajno aktiven ob potrditvi. Storitev, ki ovije potrditev nekoga drugega, na primer čakalna vrsta za združevanje, te zaključne vrstice prenese naprej.

Dve lastnosti naredita to uporabno in ne zgolj okrasno. Trditev, ki je bralnik ne prepozna, se ohrani in prikaže pod unregistered/<harness> z natančno ohranjenim besedilom, nikoli zavržena. Zaključna vrstica pa je samoprijavljen izvor, nikoli dokaz: nič je ne podpiše, zato vsaka površina, ki šteje te trditve, ob številkah prikaže to opozorilo. Slovnica identitete je objavljena s SDK kot @adverant-nexus/plugin-sdk/schema/generator-id. Ni polje manifesta, ker je orodje, ki je napisalo potrditev, dejstvo o potrditvi, ne o vtičniku.

Pregledovanje kode, ki jo je napisala UI

Orodje piše hitro in samozavestno v enakem tonu, ne glede na to, ali ima prav ali ne. Moja rutina pregleda njegovih sprememb je kratka in ne izpustim ničesar:

  1. Preberite razliko, ne povzetka. Povzetek pove, kaj je model nameraval storiti.
  2. Definicijo dokončanosti zaženite sami, iz čistega stanja: npm ci, teste, gradnjo, validate in nexus-gates. Zadnje vrstice navedite v pregledu.
  3. Za vsak nov test preverite, da na drevesu pred spremembo odpove. Test, ki uspe v obeh primerih, je okras.
  4. Iščite bližnjice. Izbrisan ali preskočen test, nov vnos pod gates/ brez razloga, vrednost najemnika, prebrana iz telesa ali glave, privzeta organizacija, catch, ki pogoltne zavrnitev, klic fetch na naslov, ki ga manifest ne deklarira.
  5. Primerjajte manifest z zadnjo izdajo. Vsak nov obseg ali odhodni naslov je razširitev, razširitve pa dobijo dva pregledovalca.
  6. Preverite, da testi zavrnitve preverjajo celotno telo: error, code, resolved[], missing[] in troubleshooting[].
  7. Preverite, da potrditev vsebuje zaključno vrstico X-Generator.

Vrata ujamejo mehanske napake. Ne morejo vam povedati, ali pot sodi na seznam ne-CRUD ali je zaledje pravno blokirano, prav tako tega ne more model; ta presoja ostaja na vas. Če se ista težava vedno znova vrača, popravite CLAUDE.md, ne le kode.

Šest praktičnih pozivov

Vsak spodnji poziv sem uporabil sam, le rahlo očiščen. Za vsakim: kaj naj orodje ustvari in vrata, ki dokažejo, da je to storilo. Če vrata niso zelena, delo ni končano, ne glede na to, kaj pravi povzetek.

1. Nova veščina za 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.

Ustvariti mora skills/summarise-excursion/SKILL.md z name, description, allowed-tools, triggers, capabilities in version v uvodnem delu, navodili v telesu in testnimi primeri, ki vključujejo podtaknjeno navodilo. Dokaz je npm run skill:validate skills/summarise-excursion brez napak, nato npm run skill:upload skills/summarise-excursion --dry-run, ki prikaže načrt. Objava je nato odločitev človeka, veščina, ki piše, pa v izdaji Enterprise potrebuje dva poimenovana odobritelja.

2. Pot vtičnika s polno storitvijo

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.

Ustvariti mora oštevilčeno migracijo, ki doda stolpec v tabelo s tremi osmi, obe poti, deklarirani v api.endpoints[] z njunima auth in right, pravico v registru rights, obdelovalnike za varovalom obsega in teste, ki preverijo, da sta nepreverjena zahteva in zahteva napačne organizacije zavrnjeni s celotnimi telesi. Dokaz je nexus-gates: scope-adherence, crud-adherence, api-contract, rights-register in migrations-are-scoped vsi uspejo, izpis testov, ki najprej odpovejo, pa je v prepisu.

3. Leča

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.

Uporabiti mora nexus.create z načrtom, ki ga potrdite, nato pa lečo oblikovati glede na njeno osnovo. Če poskuša prikazati nekaj, česar osnova ne prikazuje, register zavrne z LENS_CANNOT_WIDEN, orodje pa mora to sporočiti, namesto da bi iskalo obvod. Dokaz je predogled v vlogi osebe, ob napredovanju pa preverjanje pravilnika pilotnih vrat, da leča le zožuje in osebna polja privzeto ohranja izklopljena.

4. Domenski paket

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.

Ustvariti mora načrt čarovnika, ki navaja repozitorij in njegovo prvo spremembo, deklarirane obsege in tri veje sintetičnih podatkov, ter pack.json z gruči leč in leksikonom. Nič ni ustvarjeno, dokler ne potrdite prstnega odtisa. Dokaz so testi predloge, ki uspejo na sintetičnih vejah, pozneje pa vrata za uprizoritveno okolje. Če paket zahteva več kot njegova zadnja izdaja, je izdaja zadržana z MANIFEST_SCOPE_WIDENED, dokler je ne sprejmeta dva pregledovalca.

5. Podatkovni 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.

Ustvariti mora veščino plugin_queue, katere queueName je <plugin name>.<name> brez dvopičja, timeoutMs med 1 sekundo in 6 urami, delavca, ki jemlje iz čakalne vrste, migracijo za tabelo dogodkov, odhodni naslov v manifestu paketa (ne v nexus.manifest.json, katerega shema takega polja nima) in ime spremenljivke poverilnice v scripts/ci/required-env. Dokaz je create-nexus-plugin validate, ki uporabi lastna pravila sinhronizacije registra za imena čakalnih vrst in časovne omejitve, nato nexus-gates z zelenima no-credentials in no-direct-compute. Ob izvajanju je klic na kateri koli naslov, ki ga manifest paketa ni deklariral, ustavljen na robu z 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.

Ustvariti mora RouteModule z njegovim id, featureGroup, praznim bodies in register, ki namesti usmerjevalnik na aplikacijo gostitelja, s preverjanjem dodelitve v vsakem obdelovalniku in telesom zavrnitve v standardni obliki. Dokaz so vrata licenčne vrstice z izhodom 0, nato npm ci, npm test in npm run build, ki uspejo v vsakem sestavljenem drevesu izdaje. Poglavje 2.25, Gradnja za vsako izdajo, prikazuje ogrodje modula in kaj vrata zavrnejo.

Stroški

Takšno delo je hitrejše, a ni zastonj. Vsak prehod agenta ima proračun in življenjsko dobo ene ure, dolgo preoblikovanje pa pomeni njegovo podaljševanje. Okužba z branjem bo sejo, ki je prebrala en dokument stranke, ustavila pri kakršnem koli pisanju, dokler ne potrdite, kar je prvih nekajkrat nadležno in povsem pravilno. Skript nikoli ne more spremeniti ničesar zunaj vašega peskovnika, zato avtomatizacija, ki mora doseči uprizoritveno okolje, gre skozi zahtevo za spremembo in dva pregledovalca kot pri vseh drugih. Raje imam te omejitve, kot da bi družbi Larkfield pojasnjeval, zakaj je pomočnik njihovo tabelo zahtevkov nekam poslal po e-pošti.