AutentificareProgramați o prezentare

Capitolul 2.26

Construirea cu instrumente de programare bazate pe IA

Cum să construiți extensii Nexus în siguranță cu Claude Code și alte instrumente de programare bazate pe IA (inteligență artificială). Începe cu conectarea mediului dumneavoastră IDE (mediu de dezvoltare integrat) la Workbench și un fișier CLAUDE.md de proiect care conține regulile platformei, și se încheie cu șase instrucțiuni (prompturi) exemplificate practic și poarta de validare care o demonstrează pe fiecare.

Această pagină a fost tradusă cu ajutorul IA din originalul în limba engleză. Dacă există neclarități, pagina în limba engleză rămâne cea de referință. Citiți această pagină în limba engleză

24 minute de lectură

Cea mai mare parte a pachetului Cold chain din capitolul 2.24, Construirea unei verticale personalizate de la cap la coadă, a fost scrisă cu Claude Code deschis în terminal, alături de mine. Acesta este un lucru obișnuit acum la Corrán Orbital, iar Nexus a fost construit anticipând acest lucru. Platforma nu tratează un instrument de programare bazat pe IA (inteligență artificială) ca pe o completare automată inteligentă. Îl tratează ca pe un agent care acționează în numele unei persoane identificate, cu o permisiune întotdeauna mai restrânsă decât a acelei persoane, și înregistrează fiecare apel pe care îl face agentul.

Acest capitol arată cum să lucrați astfel fără să vă expuneți la riscuri. Începe cu conectarea IDE-ului (mediu de dezvoltare integrat), apoi tratează abilitățile din editor, fișierul de proiect care învață instrumentul regulile platformei, cele două compilatoare care transformă munca existentă în cod Nexus, modul în care commit-urile indică ce instrument le-a scris și modul în care verific ceea ce produce instrumentul. Se încheie cu șase prompturi pe care le-aș da unui coleg, fiecare cu rezultatul așteptat și cu verificarea care îl confirmă.

Conectarea mediului IDE la Nexus

Fiecare instalare are o singură adresă Workbench pentru instrumentele de programare bazate pe IA. O găsiți pe pagina Conectați-vă IDE-ul, la secțiunea Dezvoltatori, iar Claude Code se conectează cu o singură comandă:

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

<workbench-address> este adresa afișată pe pagină, cu un buton de copiere alături. Celelalte instrumente au propriile comenzi de o linie pe aceeași pagină: codex mcp add workbench --url <workbench-address> pentru Codex, un link de instalare pentru Cursor și code --add-mcp cu un mic argument JSON pentru VS Code cu Copilot. Toate comunică prin MCP (Model Context Protocol) cu aceeași adresă.

Conectați-vă IDE-ul
Conectați IDE-ul
Conectați-vă IDE-ul, cu câte o comandă pentru fiecare instrument și nivelurile implicite în dreapta. Diagrama din partea de jos arată cum fiecare apel trece prin Workbench, primește propria credențială de scurtă durată și ajunge doar în spațiul propriu al organizației din fiecare depozit de date.

Nu există nicio cheie de lipit. Primul apel vă deschide browserul, care arată exact cine face cererea: ce instrument, pe ce computer, în numele cui și ce niveluri solicită. Îl autorizați cu cheia de acces (passkey), iar de atunci instrumentul nu deține nicio parolă de bază de date și niciun kubeconfig, ci doar o permisiune care expiră. În spatele adresei, Nexus creează o credențială de scurtă durată pentru fiecare depozit de date, pentru fiecare cerere, în numele dumneavoastră.

Un administrator al organizației poate descărca și un fișier de setări gestionate, astfel încât fiecare copie Claude Code a companiei să se conecteze la acest server și la niciun altul:

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

Niveluri și permisiuni

Fiecare autentificare în Workbench primește o permisiune alcătuită din niveluri denumite. Nivelurile implicite pentru un dezvoltator sunt Observe și Sandbox pe propriile unități.

Nivel Ce permite Cine îl primește
Observe Citirea unităților proprii, inclusiv jurnale și metrici, și interogarea copiei mascate Valoare implicită
Sandbox Scriere în propriul spațiu: spațiul de dezvoltare și propriile ramuri de date Valoare implicită
Propose Deschiderea unei cereri de modificare; un pipeline o aplică după revizuire Solicitat la prima utilizare
Elevate O singură acțiune limitată în timp asupra unei singure ținte, aprobată de o persoană identificată Doar persoane, niciodată doar prin autentificare
Break-glass Acces de urgență Doar administratorii platformei, cu doi aprobatori

Un agent acționează întotdeauna în numele unei persoane și apare pe o linie proprie. Permisiunea sa nu este niciodată mai largă decât a dumneavoastră și nu include niciodată nivelul Elevate sau date nemascate. Durează o oră și se reînnoiește doar cât timp sunteți activ în Nexus sau în IDE. Permisiunea unei persoane durează 8 ore. Astfel, un instrument lăsat să ruleze peste noapte se oprește singur, iar încheierea propriei permisiuni o încheie și pe a agentului. Fiecare permisiune de agent are și un buget pentru costurile modelului, estimat înainte de acordarea permisiunii și afișat ca indicator cât timp rulează.

Pagina Permisiunile mele de acces listează toate permisiunile deținute de dumneavoastră și de agenții dumneavoastră, cu nivelurile lor și costul de până acum, și vă permite să o reînnoiți, să o restrângeți sau să o încheiați pe fiecare. Încheierea unei permisiuni oprește imediat următorul apel; înregistrarea fiecărui apel rămâne. Fiecare permisiune are și limite stricte, care în cazul nostru au fost de 200 de rânduri și 30 de secunde per interogare și 50 de obiecte modificate în spațiul de dezvoltare per sesiune.

Prima sesiune în IDE

După conectare, /mcp în Claude Code listează instrumentele Workbench grupate pe niveluri. Grupul Observe conține instrumentele de citire: workbench.k8s.describe, workbench.k8s.events, workbench.logs.query, workbench.metrics.query, workbench.traces.get, workbench.db.schema, workbench.db.query pe copia mascată, workbench.graph.query și workbench.vector.search. Sandbox adaugă workbench.devspace.deploy, workbench.branch.create și workbench.branch.reset. Propose adaugă instrumentele care deschid o cerere de modificare și planifică o modificare a grafului. Elevate nu face deloc parte din permisiune; îl solicitați în consolă.

În IDE: prima sesiune
În IDE: prima sesiune
O primă sesiune în Claude Code, cu instrumentele listate pe niveluri, o repornire urmărită până la cauza ei și o cerere de parolă pentru baza de date refuzată. Fiecare răspuns indică de unde provine și ce a fost ascuns.

Prima mea întrebare reală a fost de ce cititorul nostru de telemetrie a repornit peste noapte în Rotterdam. Claude Code a descris sarcina de lucru (două reporniri, din lipsă de memorie față de o limită de 512 MiB), a interogat jurnalele (organizația setată de gateway, datele personale redactate) și metrica de memorie și a constatat că încărcarea nocturnă aducea într-un singur lot citirile unei nopți întregi. Apoi i-am cerut, pe jumătate ca test, parola bazei de date pe care o folosește serviciul. Workbench a refuzat cu SECRET_NEVER_SHOWN. Afișează numele unui Secret și ultimele patru caractere, niciodată valoarea, nimănui. Răspunsul asistentului a fost cel corect: nu are nevoie de parolă, deoarece fiecare interogare pe care o face primește propria credențială de scurtă durată, un rol doar de citire creat pentru acea unică cerere.

Planificați, apoi aplicați

Fiecare instrument care modifică ceva afișează mai întâi un plan. Planul este un diff cu numărători și o amprentă, iar aplicarea execută doar acel plan, exact.

În IDE: planificați, apoi aplicați
În IDE: planificați, apoi aplicați
O limită de memorie mărită în spațiul de dezvoltare pe baza unui plan, apoi aceeași modificare în afara sandbox-ului. În sesiunea interactivă, o persoană o confirmă în IDE; dintr-un script fără interfață, este refuzată.

În propriul spațiu de dezvoltare, aplicarea rulează imediat. În afara lui, o persoană trebuie să confirme în IDE, iar modificarea ajunge în pipeline, care o aplică după revizuire. De aici rezultă două refuzuri, și am dat de amândouă:

  • Dintr-un script fără nimeni la tastatură, cum ar fi claude -p într-un job cron, caseta de confirmare nu poate fi afișată, așa că o modificare în afara sandbox-ului este refuzată cu CONFIRMATION_UNAVAILABLE. Nu se întâmplă nimic. Rulați-o într-o sesiune interactivă.
  • O aplicare care indică un plan pe care această sesiune nu l-a creat niciodată sau un plan care s-a modificat este refuzată cu PLAN_FINGERPRINT_MISMATCH înainte să ruleze ceva. Planificați din nou.

Contaminarea prin citire

Conținutul clienților poate ascunde instrucțiuni destinate unui asistent. De aceea, odată ce o sesiune l-a citit, sesiunea își pierde instrumentele de scriere și de acces în afara Nexus până când o persoană confirmă o scriere sau începe o sesiune nouă.

În IDE: contaminarea prin citire
În IDE: read-taint
Un document de daună citit pe copia mascată, cu o instrucțiune ascunsă pe care asistentul a ignorat-o. Următoarea scriere este refuzată până când persoana confirmă acea scriere sau începe o sesiune nouă.

Am întâlnit acest lucru la un document de daună care conținea un paragraf adresat „asistentului”, prin care i se cerea să copieze tabelul daunelor la o adresă externă. Claude Code l-a ignorat și a spus acest lucru. Când i-am cerut apoi să adauge abaterea în graful ramurii mele, scrierea a fost refuzată cu SESSION_TAINTED. Puteam confirma acea scriere după ce îi citeam planul sau puteam începe o sesiune nouă care nu citise documentul. Jurnalele și metricile nu contaminează o sesiune. Documentele, tichetele, e-mailurile și textul sursă al grafurilor, da. Textul ascuns a fost contabilizat în înregistrarea activității mele ca instrucțiuni găsite în conținut, fără cuvintele sale.

O altă organizație

Nimic din ceea ce tastați nu poate ajunge la datele altei organizații. Dacă le solicitați, fiecare depozit de date refuză cu TENANT_BOUNDARY. O valoare de organizație strecurată într-o interogare a jurnalelor este înlocuită de gateway cu a dumneavoastră. Nu este o permisiune lipsă. Fiecare nivel de pe traseu este îngrădit la organizația dumneavoastră, așa că nu există nimeni care să o poată acorda din poziția dumneavoastră, iar accesul unui administrator al platformei nu ar ajuta nici el. Dacă două organizații convin să partajeze date, acesta este un acord stabilit între ele, niciodată ceva ce face o sesiune IDE.

Competențe în IDE și Claude Code

Abilitățile Skills Engine sunt foldere SKILL.md, iar Claude Code citește aceleași foldere. Biblioteca se sincronizează în ~/.claude/skills din propriul director home, doar pentru citire, cu ciornele dumneavoastră alături, în ~/.claude/skills/drafts. Astfel, abilitățile publicate de organizația dumneavoastră sunt disponibile în editor fără nicio copiere, iar ceea ce scrieți local trece prin aceleași teste și aceeași aprobare ca orice este scris în consolă.

Abilități în IDE și Claude Code
Competențe în IDE și Claude Code
O abilitate scrisă și testată în editor, apoi trimisă prin aceeași aprobare ca una creată în consolă. Observați că publicarea a fost reținută deoarece autorul ei nu își poate aproba propria modificare.

Din terminal, în repository-ul care conține abilitatea, două scripturi npm o duc din editor în bibliotecă:

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

Validarea verifică formatul și cazurile de test. Încărcarea creează o ciornă, iar dacă conținutul corespunde unei versiuni deja publicate, returnează acea versiune (CONTENT_HASH_ALREADY_PUBLISHED). Publicarea este reținută pentru aprobare atunci când abilitatea o necesită, iar dumneavoastră nu vă puteți aproba propria modificare. O rulare pornită dintr-un script fără o rută de model este refuzată cu SKILLS_ENGINE_BINDING_MISSING: dispecerul alege ruta, iar motorul verifică dacă a primit-o, fără să ghicească niciodată una. Capitolul 2.24, Construirea unei verticale personalizate de la cap la coadă, prezintă aceleași scripturi într-un proiect întreg.

Agenții și Claude Code accesează biblioteca și prin MCP, prin 13 instrumente în total. Dintre acestea, list_skills și get_skill găsesc și citesc o abilitate, match_prompt și discover_skills indică ce abilitate se potrivește unei sarcini, invoke_skill rulează una, iar sync_skills_local copiază biblioteca în folderul de abilități. Fiecare apel rulează în numele persoanei care l-a inițiat, în limitele listei sale de permisiuni. O abilitate nu își poate extinde niciodată instrumentele dincolo de lista de permisiuni a celui care o rulează.

Un fișier CLAUDE.md de proiect care conține regulile platformei

Claude Code citește un CLAUDE.md din rădăcina repository-ului la începutul fiecărei sesiuni. Este cea mai ieftină măsură de siguranță pe care o aveți, deoarece pune regulile platformei în fața modelului înainte ca acesta să scrie ceva. Verificările SDK (kit de dezvoltare software) vor prinde oricum majoritatea greșelilor, dar o regulă pe care modelul a citit-o de la început nu vă costă nicio compilare eșuată.

Scrieți-l sub formă de reguli cu motivele lor, nu sub formă de aspirații. Iată-l pe cel din repository-ul pluginului nostru Cold chain, ușor prescurtat:

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

Trei lucruri fac ca un astfel de fișier să funcționeze. Fiecare regulă numește mecanismul care o aplică, astfel încât modelul își poate verifica munca după același criteriu ca pipeline-ul. Definiția lucrului terminat este o listă de comenzi cu coduri de ieșire, nu o impresie. Și interzice scurtăturile specifice la care recurge un model atunci când o compilare eșuează, cum ar fi ștergerea testului sau înlocuirea unei organizații lipsă cu o valoare substituentă.

Furnizarea corpusului SDK drept context

Documentația SDK este un set de 28 de volume, scrise astfel încât un dezvoltator sau un LLM (model lingvistic mare) să poată construi un plugin complet de producție doar pe baza acestui corpus, fără acces la codul privat al platformei. Fiecare format de mesaj și fiecare cod de eroare întâlnit de un plugin se află în documentele propriu-zise.

Acest lucru îl face un context neobișnuit de bun. În practică, îi dau lui Claude Code volumele pe care le atinge sarcina, nu întregul set: volumele despre manifest și HTTP pentru o rută nouă, volumul despre baza de date pentru o migrare, catalogul de erori ori de câte ori este implicat un refuz și, întotdeauna, lista de verificare a conformității, deoarece reprezintă întregul corpus sub formă de listă de bifat. Spuneți-i modelului să prefere un fapt observat în locul propriei amintiri despre cum funcționează de obicei un framework. Când cele două nu concordă, corpusul are dreptate în privința acestei platforme.

Pentru dezvoltatorul frontend din echipa dumneavoastră, generați un ghid din manifest în loc să scrieți unul:

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

Acesta listează fiecare rută pe care o poate apela aplicația web, cu fiecare refuz pe care îl poate primi, așa că reprezintă un context bun și pentru modelul care scrie aplicația web. Faceți commit și verificați-l în CI (integrare continuă) cu --check --lint, astfel încât să nu se poată îndepărta de manifest.

Împachetarea unui depozit existent: /plugin-create

Abilitatea /plugin-create transformă un repository existent sau o specificație API (interfață de programare a aplicațiilor) într-un plugin Nexus. Indicați-i sursa atunci când o invocați:

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

Funcționează pe faze. Mai întâi clonează și analizează sursa, determinând limbajul și framework-ul, suprafața API, baza de date și migrările acesteia și ce face de fapt aplicația. Afișează un raport de analiză și alege o strategie de încapsulare pe baza celor constatate:

Sursă Strategie
API REST (representational state transfer) în Node.js Un wrapper Express în jurul rutelor existente
API REST în Python Un wrapper FastAPI
Full-stack Node.js și React Un wrapper de backend cu un adaptor de interfață cu utilizatorul (UI)
Instrument de linie de comandă Un API Express care rulează comenzile
Bibliotecă sau SDK Un API Express care îi expune funcțiile
Platformă complexă Un singur container de plugin, cu un proxy nginx în față

Apoi generează backendul și migrațiile sale, o UI, manifestul și testele. Tratați ceea ce scrie ca pe o primă versiune solidă și supuneți-o aceluiași standard ca orice altceva. În depozitul nostru, asta a însemnat trei pași înainte ca cineva să o revizuiască. Am ridicat manifestul său la contractul v2 cu create-nexus-plugin migrate --write, care adaugă propozițiile de lege și refuză să inventeze un punct de intrare. Apoi l-am făcut să treacă de create-nexus-plugin validate. Și am rulat nexus-gates până când a devenit verde, ceea ce, în cazul nostru, a însemnat înlocuirea antetelor de tenant pe care wrapperul le citea singur cu garda de domeniu a SDK-ului și adăugarea celor trei axe în tabelele sale. Implementarea rămâne în seama canalelor de lansare ale instalării; ignorați orice fișiere de implementare conținute în ciornă.

mockup-compiler: de la ecrane la cod funcțional

Al doilea compilator funcționează invers. mockup-compiler preia machetele unui proiect, care pot ajunge la mii de ecrane, și le compilează în UI funcțională, rute backend for frontend (BFF) și SQL, a căror fidelitate este dovedită ecran cu ecran de porți cu coduri de ieșire. Urmărește fiecare cuvânt desenat până la linia sursă care l-a desenat, asociază fiecare ecran cu specificația sa, determină modificările de domeniu de care au nevoie ecranele și emite contractele și migrațiile, împreună cu o specificație a datelor demo de care are nevoie fiecare ecran.

Două reguli îl deosebesc de a cere unui model să „construiască aceste ecrane”:

  • Mai întâi compilatorul. Tot ce poate fi cunoscut este calculat, în mod determinist. Un model este folosit doar pentru goluri tipizate: scrie un artefact conform unei scheme, un verificator determinist îl acceptă sau numește fiecare defect, iar modelul primește cel mult 3 runde de reparare, alimentate cu raportul verificatorului.
  • Fiecare poartă are un control negativ cu defect plantat. Când verify rulează porțile unui proiect pentru un ecran, o copie a arborelui primește câte un defect plantat pentru fiecare poartă, iar dacă o poartă lasă să treacă defectul său plantat, întreaga rulare este marcată ca nefiind de încredere. O poartă care nu poate eșua întrerupe rularea.

Lucrul se desfășoară în etape, fiecare cu propriul mod și propria poartă:

Etapă Mod Ce dovedește poarta sa
Fixare pin Desenul este identic între două build-uri, cu id-uri de ecran unice
Urmărire trace Fiecare cuvânt desenat este urmărit până la exact o linie sursă
Asociere join Fiecare slot compilat corespunde sursei care l-a desenat
Specificație spec Fiecare ecran are rândul său în specificație
Modificare de domeniu domain Propunerea acoperă tot ce citesc și scriu ecranele, cu coduri din catalogul SDK
Contracte shape-check, emit-contracts Fiecare câmp citit are o formă preluată din coloana sa sau declarată
SQL și stocare emit-sql, emit-store Migrația se aplică pe un Postgres real, cu teste care eșuează mai întâi
Lume world Datele demo acoperă celulele fiecărui ecran
Legare bind Partea decisă a fiecărei legări, restul fiind listat ca goluri denumite
Verificare verify Porțile proprii ale proiectului pentru fiecare ecran, fiecare dovedită capabilă să eșueze

Singura intrare specifică proiectului este .mockup-compiler.json, adaptorul. Acesta precizează cum marchează o pagină un ecran și ce idiomuri SQL și de stocare trebuie emise. De asemenea, numește axele de tenancy, inclusiv pe cea care conduce fiecare cheie, și apelul de autorizare pe care îl face fiecare scriere. mockup-compiler init --project <dir> scrie un schelet în care fiecare intrare necompletată este refuzată nominal. Un proiect fără propriul compilator de UI nu poate folosi compile, baseline-check, join sau world, iar aceste moduri semnalează acest lucru cu NO_PROJECT_COMPILER, în loc să eșueze mai târziu.

Regula pe care aș reține-o chiar dacă nu îl rulați niciodată: o regulă de scriere pe care specificația nu o enunță devine un 501 onest care numește ce lipsește, niciodată o presupunere. Este aceeași regulă pe care o vreau de la orice model care scrie cod pe baza ecranelor.

Atribuirea generatorului

Când un instrument scrie un commit, commitul ar trebui să o spună. Contractul de atribuire a generatorului cere o linie de trailer în mesajul commitului:

feat(excursions): page the nightly telemetry load

X-Generator: claude-code/<model>

Identitatea este <harness>/<model>, cu litere mici, cu o singură bară oblică: harness-ul este instrumentul care a rulat (claude-code), iar modelul este cel pe care îl rula. Dacă modelul s-a schimbat în timpul lucrului pe care îl încheie commitul, adăugați X-Generator-Session cu fiecare identitate, de la cea mai veche, astfel încât lucrul să nu fie atribuit modelului care se întâmpla să fie activ în momentul commitului. Un serviciu care încapsulează commitul altcuiva, cum ar fi o coadă de îmbinare, preia aceste trailere mai departe.

Două proprietăți fac acest lucru util, nu decorativ. O afirmație pe care un cititor nu o recunoaște este păstrată și afișată sub unregistered/<harness>, cu textul exact păstrat, niciodată eliminată. Iar trailerul reprezintă proveniență autodeclarată, niciodată o dovadă: nimic nu îl semnează, așa că fiecare suprafață care numără aceste afirmații afișează această rezervă lângă cifre. Gramatica identității este publicată împreună cu SDK-ul ca @adverant-nexus/plugin-sdk/schema/generator-id. Nu este un câmp al manifestului, deoarece instrumentul care a scris un commit este un fapt despre commit, nu despre plugin.

Revizuirea codului scris de o IA

Instrumentul scrie rapid și cu încredere, pe același ton, fie că are dreptate, fie că nu. Rutina mea de revizuire a modificărilor sale este scurtă și nu sar peste nimic din ea:

  1. Citiți diff-ul, nu rezumatul. Rezumatul spune ce a intenționat modelul să facă.
  2. Rulați chiar dumneavoastră definiția lui „gata”, de la zero: npm ci, testele, build-ul, validate și nexus-gates. Citați ultimele linii în revizuire.
  3. Pentru fiecare test nou, verificați că eșuează pe arborele de dinaintea modificării. Un test care trece în ambele situații este decor.
  4. Căutați scurtăturile. Un test șters sau omis, o intrare nouă sub gates/ fără motiv, o valoare de tenant citită dintr-un corp sau dintr-un antet, o organizație implicită, un catch care înghite un refuz, un fetch către o adresă pe care manifestul nu o declară.
  5. Comparați manifestul cu ultima versiune lansată. Orice domeniu nou sau adresă de ieșire nouă este o extindere, iar extinderile primesc doi revizori.
  6. Verificați că testele de refuz validează întregul corp: error, code, resolved[], missing[] și troubleshooting[].
  7. Verificați că commitul conține trailerul său X-Generator.

Porțile prind defectele mecanice. Ele nu vă pot spune dacă o rută își are locul pe lista non-CRUD sau dacă un backend este blocat din motive legale, și nici modelul nu poate; această judecată rămâne la dumneavoastră. Dacă aceeași problemă tot revine, corectați CLAUDE.md, nu doar codul.

Șase instrucțiuni (prompturi) exemplificate practic

Fiecare prompt de mai jos este unul pe care l-am folosit, ușor curățat. După fiecare: ce ar trebui să producă instrumentul și poarta care dovedește că a făcut-o. Dacă poarta nu este verde, lucrul nu este terminat, indiferent ce spune rezumatul.

1. O nouă competență 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.

Ar trebui să producă skills/summarise-excursion/SKILL.md cu name, description, allowed-tools, triggers, capabilities și version în frontmatter, instrucțiunile sale în corp și cazuri de test care includ instrucțiunea plantată. Dovada este npm run skill:validate skills/summarise-excursion cu zero erori, apoi npm run skill:upload skills/summarise-excursion --dry-run care afișează planul. Publicarea este ulterior decizia unei persoane, iar o abilitate care scrie are nevoie de doi aprobatori nominalizați pe Enterprise.

2. O rută de plugin cu serviciu complet

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.

Ar trebui să producă o migrație numerotată care adaugă coloana într-un tabel care poartă cele trei axe, ambele rute declarate în api.endpoints[] cu auth și right ale lor, dreptul în registrul rights, handlere în spatele gărzii de domeniu și teste care verifică faptul că o cerere neautentificată și o cerere din organizația greșită sunt refuzate cu corpuri complete. Dovada este nexus-gates: scope-adherence, crud-adherence, api-contract, rights-register și migrations-are-scoped trec toate, iar rezultatul care eșuează mai întâi apare în transcriere.

3. O lentilă

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.

Ar trebui să folosească nexus.create cu un plan pe care îl confirmați, apoi să modeleze lentila pe baza bazei sale. Dacă încearcă să afișeze ceva ce baza nu afișează, registrul refuză cu LENS_CANNOT_WIDEN, iar instrumentul ar trebui să raporteze acest lucru, în loc să caute o cale de ocolire. Dovada este previzualizarea ca persoană, iar la promovare, verificarea de politică a porții pilot că lentila doar restrânge și păstrează câmpurile personale dezactivate în mod implicit.

4. Un pachet de domeniu

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.

Ar trebui să producă planul asistentului, care listează depozitul și prima sa modificare, domeniile declarate și cele trei ramuri de date sintetice, plus un pack.json cu grupurile sale de lentile și lexiconul. Nimic nu este creat până nu confirmați amprenta. Dovada este trecerea testelor șablonului pe ramurile sintetice și, ulterior, poarta de staging. Dacă pachetul cere mai mult decât ultima sa versiune, versiunea este reținută cu MANIFEST_SCOPE_WIDENED până când doi revizori o acceptă.

5. Un conector de date

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.

Ar trebui să producă o abilitate plugin_queue al cărei queueName este <plugin name>.<name> fără două puncte, un timeoutMs între 1 secundă și 6 ore, un worker care preia din coadă, o migrație pentru tabelul de evenimente, adresa de ieșire în manifestul pachetului (nu în nexus.manifest.json, a cărui schemă nu are un astfel de câmp) și numele variabilei credențialului în scripts/ci/required-env. Dovada este create-nexus-plugin validate, care aplică propriile reguli ale sincronizării registrului privind numele cozilor și timeout-urile, apoi nexus-gates cu no-credentials și no-direct-compute verzi. La rulare, un apel către orice adresă pe care manifestul pachetului nu a declarat-o este oprit la margine cu EGRESS_NOT_DECLARED.

6. Un 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.

Ar trebui să producă un RouteModule cu id, featureGroup, bodies gol și un register care montează un router pe aplicația gazdei, cu verificarea permisiunii în fiecare handler și corpul de refuz în forma standard. Dovada este poarta liniei de licență care iese cu 0, apoi trecerea npm ci, npm test și npm run build în fiecare arbore de ediție compus. Capitolul 2.25, Construirea pentru fiecare ediție, prezintă scheletul modulului și ce refuză poarta.

Cât costă

Să lucrați astfel este mai rapid, dar nu este gratuit. Fiecare trecere a agentului are un buget și o durată de viață de o oră, iar o refactorizare lungă înseamnă reînnoirea acestuia. Read-taint va împiedica o sesiune care a citit un document al unui client să scrie ceva până când confirmați, ceea ce este iritant primele câteva ori și exact ce trebuie. Un script nu poate modifica niciodată nimic în afara sandboxului dumneavoastră, așa că automatizarea care trebuie să ajungă în staging trece printr-o cerere de modificare și doi revizori, ca toți ceilalți. Prefer să am aceste limite decât să le explic celor de la Larkfield de ce un asistent le-a trimis undeva prin e-mail tabelul de daune.