Versioon 1.0.0-alpha.1uusim
Peatükk 2.26
Ehitamine AI-kodeerimistööriistadega
Kuidas luua Nexuse laiendusi turvaliselt Claude Code'i ja teiste AI (tehisintellekti) kodeerimistööriistadega. See algab teie IDE (integreeritud arenduskeskkonna) ühendamisega Workbenchiga ja platvormi reegleid kandva projekti CLAUDE.md failiga ning lõpeb kuue läbitöötatud viiba ja kontrollväravaga, mis igaühe toimimist tõestab.
Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

Suurem osa peatükis 2.24 „Kohandatud vertikaali ehitamine algusest lõpuni“ kirjeldatud külmaahela paketist kirjutati nii, et Claude Code oli minu kõrval terminalis avatud. See on Corrán Orbitalis praegu tavaline ja Nexus ehitati seda arvestades. Platvorm ei käsitle AI (tehisintellekti) kodeerimistööriista nutika automaattäitena. See käsitleb seda agendina, mis tegutseb nimelise isiku eest, pääsuga, mis on alati kitsam kui selle isiku oma, ja salvestab iga agendi tehtud kutse.
See peatükk räägib sellest, kuidas niimoodi töötada ilma kahju saamata. See algab teie IDE (integreeritud arenduskeskkonna) ühendamisega, seejärel käsitleb oskusi redaktoris, projektifaili, mis õpetab tööriistale platvormi reegleid, kahte kompilaatorit, mis muudavad olemasoleva töö Nexuse koodiks, seda, kuidas kommitid näitavad, milline tööriist need kirjutas, ja seda, kuidas ma tööriista toodetut üle vaatan. See lõpeb kuue viipega, mille ma kolleegile annaksin, igaühe juures see, mis peaks tagasi tulema, ja kontroll, mis seda tõendab.
IDE ühendamine Nexusega
Igal paigaldusel on AI-kodeerimistööriistade jaoks üks Workbenchi aadress. Selle leiate jaotise Arendajad lehelt Ühendage oma IDE ja Claude Code ühendub ühe käsuga:
claude mcp add workbench --transport http <workbench-address><workbench-address> on lehel kuvatav aadress, mille kõrval on kopeerimisnupp. Teistel tööriistadel on samal lehel oma ühe rea käsud: codex mcp add workbench --url <workbench-address> Codexi jaoks, paigalduslink Cursori jaoks ja code --add-mcp väikese JSON-argumendiga VS Code’i ja Copiloti jaoks. Kõik need suhtlevad sama aadressiga MCP (Model Context Protocol) kaudu.
Võtit ei ole vaja kleepida. Esimene kutse avab teie brauseri, mis näitab täpselt, kes küsib: milline tööriist millises arvutis, kelle eest tegutsedes ja milliseid tasemeid soovides. Te lubate selle oma pääsuvõtmega ja edaspidi ei hoia tööriist ühtegi andmebaasi parooli ega kubeconfigi, vaid ainult aeguvat pääsu. Aadressi taga loob Nexus iga andmehoidla jaoks, iga päringu jaoks, teie nimel lühiajalise mandaadi.
Organisatsiooni administraator saab alla laadida ka hallatud seadete faili, et iga ettevõtte Claude Code’i eksemplar ühenduks selle serveriga ja mitte ühegi teisega:
{ "workbench": { "type": "http", "url": "<workbench-address>" } }Tasemed ja pääsud
Iga Workbenchi sisselogimine saab nimelistest tasemetest koosneva pääsu. Arendaja vaikimisi tasemed on Observe ja Sandbox tema enda üksustel.
| Tase | Mida see võimaldab | Kes selle saab |
|---|---|---|
| Observe | Lugege oma üksusi, sealhulgas logisid ja mõõdikuid, ning tehke päringuid maskeeritud koopiale | Vaikeväärtus |
| Sandbox | Kirjutamine teie enda ruumis: teie arendusruum ja teie enda andmeharud | Vaikeväärtus |
| Propose | Muudatustaotluse avamine; konveier rakendab selle pärast ülevaatust | Küsitakse esimesel kasutamisel |
| Elevate | Üks ajaliselt piiratud toiming ühel sihtmärgil, mille kinnitab nimeline isik | Ainult inimestele, mitte kunagi ainult sisselogimisega |
| Break-glass | Hädaolukorra juurdepääs | Ainult platvormi administraatoritele, kahe kinnitajaga |
Agent tegutseb alati inimese eest ja kuvatakse eraldi real. Selle pääs ei ole kunagi laiem kui teie oma ega sisalda kunagi Elevate-taset ega maskeerimata andmeid. See kehtib ühe tunni ja seda uuendatakse ainult siis, kui olete Nexuses või IDE-s aktiivne. Inimese pääs kehtib 8 tundi. Seega peatub üleöö töötama jäetud tööriist iseenesest ja teie enda pääsu lõpetamine lõpetab ka teie agendi pääsu. Igal agendi pääsul on ka mudelikulude eelarve, mis hinnatakse enne pääsu andmist ja kuvatakse selle töötamise ajal mõõdikuna.
Leht Minu juurdepääsupääsud loetleb kõik teie ja teie agentide pääsud koos nende tasemete ja seniste kuludega ning võimaldab igaüht uuendada, kitsendada või lõpetada. Pääsu lõpetamine peatab kohe järgmise kutse; iga kutse kirje jääb alles. Igal pääsul on ka ranged piirangud, mis meie puhul olid 200 rida ja 30 sekundit päringu kohta ning 50 muudetud objekti arendusruumis seansi kohta.
Esimene seanss IDE-s
Pärast ühendamist loetleb /mcp Claude Code’is Workbenchi tööriistad tasemete kaupa rühmitatuna. Observe-rühmas on lugemistööriistad: workbench.k8s.describe, workbench.k8s.events, workbench.logs.query, workbench.metrics.query, workbench.traces.get, workbench.db.schema, workbench.db.query maskeeritud koopial, workbench.graph.query ja workbench.vector.search. Sandbox lisab workbench.devspace.deploy, workbench.branch.create ja workbench.branch.reset. Propose lisab tööriistad, mis avavad muudatustaotluse ja kavandavad graafimuudatuse. Elevate ei ole pääsul üldse; seda taotlete konsoolis.
Minu esimene päris küsimus oli, miks meie telemeetrialugeja Rotterdamis öösel taaskäivitus. Claude Code kirjeldas töökoormust (kaks taaskäivitust, mälu otsas 512 MiB piirangu juures), tegi päringu logidele (organisatsiooni määras lüüs, isikuandmed redigeeritud) ja mälumõõdikule ning leidis, et öine laadimine tõmbas terve öö näidud ühte partiisse. Seejärel küsisin sellelt, pooleldi testiks, andmebaasi parooli, mida teenus kasutab. Workbench keeldus koodiga SECRET_NEVER_SHOWN. See näitab Secreti nime ja viimast nelja märki, mitte kunagi väärtust, mitte kellelegi. Assistendi vastus oli õige: tal ei ole parooli vaja, sest iga tema tehtud päring saab oma lühiajalise mandaadi, ainult lugemisõigusega rolli, mis on loodud just selle ühe päringu jaoks.
Kõigepealt plaan, siis rakendamine
Iga tööriist, mis midagi muudab, näitab kõigepealt plaani. Plaan on erinevus koos arvude ja sõrmejäljega ning rakendamine käivitab täpselt ainult selle plaani.
Teie enda arendusruumis käivitub rakendamine kohe. Väljaspool seda peab inimene IDE-s kinnitama ja muudatus läheb konveierisse, mis rakendab selle pärast ülevaatust. Sellest tulenevad kaks keeldumist ja mõlemad tabasid mind:
- Skriptist, mille juures klaviatuuri taga kedagi ei ole, näiteks
claude -pcron-töös, ei saa kinnituskasti kuvada, seega lükatakse väljaspool liivakasti tehtav muudatus tagasi koodigaCONFIRMATION_UNAVAILABLE. Midagi ei juhtu. Käivitage see interaktiivses seansis. - Rakendamine, mis viitab plaanile, mida see seanss kunagi ei loonud, või plaanile, mis on muutunud, lükatakse enne millegi käivitamist tagasi koodiga
PLAN_FINGERPRINT_MISMATCH. Koostage plaan uuesti.
Lugemissaastumine
Kliendi sisu võib peita assistendile mõeldud juhiseid. Seega kaotab seanss pärast sellise sisu lugemist oma kirjutamise ja Nexusest väljapoole ulatumise tööriistad, kuni inimene kinnitab ühe kirjutamise või alustab uut seanssi.
Puutusin sellega kokku nõudedokumendi puhul, mis sisaldas „assistendile“ adresseeritud lõiku, milles paluti kopeerida nõuete tabel välisele aadressile. Claude Code eiras seda ja ütles seda ka. Kui ma seejärel palusin sel lisada kõrvalekalde oma haru graafi, lükati kirjutamine tagasi koodiga SESSION_TAINTED. Võisin selle ühe kirjutamise pärast selle plaani lugemist kinnitada või alustada uut seanssi, mis polnud dokumenti lugenud. Logid ja mõõdikud seanssi ei saasta. Dokumendid, piletid, e-kirjad ja graafi lähtetekst saastavad kõik. Peidetud tekst loendati minu tegevuskirjes sisust leitud juhistena, ilma selle sõnadeta.
Teine organisatsioon
Miski, mida te sisestate, ei pääse ligi teise organisatsiooni andmetele. Küsige neid ja iga andmehoidla keeldub koodiga TENANT_BOUNDARY. Logipäringusse libistatud organisatsiooni väärtuse asendab lüüs teie enda omaga. Tegemist ei ole puuduva õigusega. Iga kihi teel on piiratud teie organisatsiooniga, seega ei ole teie positsioonilt kedagi, kes saaks seda anda, ja ka platvormi administraatori juurdepääs ei aitaks. Kui kaks organisatsiooni lepivad kokku andmete jagamises, on see nende vahel sõlmitud kokkulepe, mitte kunagi midagi, mida IDE-seanss teeb.
Oskused IDE-s ja Claude Code'is
Skills Engine’i oskused on SKILL.md kaustad ja Claude Code loeb samu kaustu. Teek sünkroonitakse teie enda kodukataloogi kausta ~/.claude/skills, ainult lugemiseks, ja teie mustandid on nende kõrval kaustas ~/.claude/skills/drafts. Seega on teie organisatsiooni avaldatud oskused teie redaktoris saadaval ilma kopeerimata ja see, mida kohapeal kirjutate, läbib samad testid ja kinnitamise nagu kõik konsoolis kirjutatu.
Terminalist, oskust sisaldavas hoidlas, viivad kaks npm-skripti selle teie redaktorist teeki:
npm run skill:validate skills/check-a-customs-filing
npm run skill:upload skills/check-a-customs-filingValideerimine kontrollib vormingut ja testjuhtumeid. Üleslaadimine loob mustandi ja kui sisu ühtib juba avaldatud versiooniga, tagastab see selle versiooni (CONTENT_HASH_ALREADY_PUBLISHED). Avaldamine peetakse kinnitamiseks kinni, kui oskus seda nõuab, ja te ei saa oma muudatust ise kinnitada. Skriptist ilma mudelimarsruudita käivitatud töö lükatakse tagasi koodiga SKILLS_ENGINE_BINDING_MISSING: dispetšer valib marsruudi ja mootor kontrollib, et see anti, ega arva seda kunagi. Peatükk 2.24 „Kohandatud vertikaali ehitamine algusest lõpuni“ näitab samu skripte terves projektis.
Agendid ja Claude Code jõuavad teegini ka MCP kaudu, kokku 13 tööriista abil. Nende hulgas leiavad ja loevad list_skills ja get_skill oskuse, match_prompt ja discover_skills ütlevad, milline oskus ülesandele sobib, invoke_skill käivitab oskuse ja sync_skills_local kopeerib teegi teie oskuste kausta. Iga kutse käivitatakse selle algatanud isikuna tema lubatud loendi piires. Oskus ei saa kunagi laiendada oma tööriistu üle selle käivitaja lubatud loendi.
Platvormi reegleid kandev projekti CLAUDE.md
Claude Code loeb iga seansi alguses hoidla juurkaustas olevat faili CLAUDE.md. See on teie odavaim turvameede, sest see paneb platvormi reeglid mudeli ette enne, kui see midagi kirjutab. SDK (tarkvaraarenduskomplekti) kontrollid püüavad enamiku vigadest niikuinii kinni, kuid mudeli poolt eelnevalt loetud reegel ei maksa teile ühtegi ebaõnnestunud ehitust.
Kirjutage see reeglitena koos põhjustega, mitte püüdlustena. Siin on meie külmaahela pistikprogrammi hoidla oma, veidi kärbitult:
# 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>.Sellise faili toimimiseks on vaja kolme asja. Iga reegel nimetab mehhanismi, mis seda jõustab, nii et mudel saab oma tööd kontrollida sama asja vastu, mida kasutab konveier. Valmisoleku määratlus on käskude loend koos väljumiskoodidega, mitte tunne. Ja see keelab konkreetsed otseteed, mille poole mudel kipub punase ehituse korral haarama, näiteks testi kustutamise või puuduva organisatsiooni asendamise kohatäitega.
SDK korpuse sisestamine kontekstina
SDK dokumentatsioon koosneb 28 köitest, mis on kirjutatud nii, et arendaja või LLM (suur keelemudel) saaks ehitada täieliku tootmiskõlbliku pistikprogrammi ainult selle korpuse põhjal, ilma juurdepääsuta platvormi privaatsele koodile. Iga sõnumikuju ja veakood, millega pistikprogramm kokku puutub, on dokumentides endis olemas.
See teeb sellest ebatavaliselt hea konteksti. Praktikas annan Claude Code’ile kogu komplekti asemel need köited, mida ülesanne puudutab: uue marsruudi jaoks manifesti ja HTTP köited, migratsiooni jaoks andmebaasi köite, veakataloogi alati, kui on tegemist keeldumisega, ja vastavuse kontrollnimekirja alati, sest see on kogu korpus linnukeste loendina. Öelge mudelile, et see eelistaks vaadeldud fakti oma mälule sellest, kuidas raamistik tavaliselt töötab. Kui need lähevad lahku, on korpusel selle platvormi kohta õigus.
Oma meeskonna esiotsa arendaja jaoks genereerige juhend manifestist, selle asemel et seda kirjutada:
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin guide --manifest nexus.manifest.json --narrative docs/guide --out docs/GUIDE.mdSee loetleb iga marsruudi, mida veebirakendus võib kutsuda, koos iga keeldumisega, mida see võib tagasi saada, seega on see hea kontekst ka veebirakendust kirjutavale mudelile. Kommitige see ja kontrollige seda CI-s (pidevas integratsioonis) käsuga --check --lint, et see ei saaks manifestist lahkneda.
Olemasoleva hoidla pakendamine: /plugin-create
Oskus /plugin-create muudab olemasoleva hoidla või API (rakendusliidese) spetsifikatsiooni Nexuse pistikprogrammiks. Andke sellele käivitamisel lähtekood:
/plugin-create https://github.com/<owner>/<repo>
See töötab etappidena. Esmalt kloonib ja analüüsib see lähtekoodi, tehes kindlaks keele ja raamistiku, API pinna, andmebaasi ja selle migratsioonid ning selle, mida asi tegelikult teeb. See prindib analüüsiaruande ja valib leitu põhjal mähkimisstrateegia:
| Lähtekood | Strateegia |
|---|---|
| REST (representational state transfer) API Node.js-is | Express-mähis olemasolevate marsruutide ümber |
| REST API Pythonis | FastAPI-mähis |
| Täispinu Node.js ja React | Taustsüsteemi ümbris koos kasutajaliidese (UI) adapteriga |
| Käsureatööriist | Express API, mis käivitab käske |
| Teek või SDK | Express API, mis teeb selle funktsioonid kättesaadavaks |
| Keerukas platvorm | Üks pistikprogrammi konteiner, mille ees on nginx-puhverserver |
Seejärel genereerib see taustsüsteemi koos selle migratsioonidega, kasutajaliidese, manifesti ja testid. Käsitlege selle kirjutatut tugeva esmase mustandina ja hinnake seda sama kõrge standardi järgi nagu kõike muud. Meie repositooriumis tähendas see kolme sammu enne, kui keegi seda üle vaatas. Tõstsime selle manifesti käsuga create-nexus-plugin migrate --write v2 lepingu tasemele, mis lisab õigusnõuete laused ja keeldub sisenemispunkti välja mõtlemast. Seejärel panime selle läbima create-nexus-plugin validate. Ning käivitasime nexus-gates seni, kuni see muutus roheliseks, mis meie puhul tähendas, et asendasime rentniku päised, mida ümbris ise luges, SDK ulatusekaitsega ja lisasime selle tabelitesse kolm telge. Juurutamine jääb paigalduse väljalaskekanalite hooleks; eirake mustandis sisalduvaid juurutusfaile.
mockup-compiler: ekraanipiltidest töötava koodini
Teine kompilaator töötab vastupidi. mockup-compiler võtab projekti makettidest, mida võib olla tuhandeid ekraane, ja kompileerib need töötavaks kasutajaliideseks, esiliidese taustsüsteemi (BFF) marsruutideks ja SQL-iks, mille ekraanihaaval truudust tõendavad väljumiskoodidega väravad. See jälitab iga joonistatud sõna lähterealt, mis selle joonistas, seob iga ekraani selle spetsifikatsiooniga, tuletab ekraanide vajatavad domeenimuudatused ning väljastab lepingud ja migratsioonid koos spetsifikatsiooniga demoandmetest, mida iga ekraan vajab.
Kaks reeglit eristavad seda mudelilt palumisest „ehita need ekraanid“:
- Kompilaator eelkõige. Kõik, mida on võimalik teada, arvutatakse deterministlikult. Mudelit kasutatakse ainult tüübitud aukude jaoks: see kirjutab artefakti skeemi alusel, deterministlik kontrollija kas aktsepteerib selle või nimetab iga defekti ning mudel saab kõige rohkem 3 parandusvooru, mida toidetakse kontrollija aruandega.
- Igal väraval on istutatud defektiga negatiivne kontroll. Kui
verifykäivitab ekraani jaoks projekti väravad, saab puu koopia iga värava kohta ühe istutatud defekti ja kui mõni värav laseb oma istutatud defekti läbi, märgitakse kogu käitus ebausaldusväärseks. Värav, mis ei saa ebaõnnestuda, katkestab käituse.
Töö kulgeb etappidena, millest igaühel on oma režiim ja oma värav:
| Etapp | Režiim | Mida selle värav tõendab |
|---|---|---|
| Kinnitamine | pin |
Joonis on kahes järgus identne ja ekraanide ID-d on unikaalsed |
| Jälitamine | trace |
Iga joonistatud sõna on jälitatud täpselt ühe lähtereani |
| Sidumine | join |
Iga kompileeritud pesa vastab lähtele, mis selle joonistas |
| Spetsifikatsioon | spec |
Igal ekraanil on oma rida spetsifikatsioonis |
| Domeenimuudatus | domain |
Ettepanek hõlmab kõike, mida ekraanid loevad ja kirjutavad, SDK kataloogi koodidega |
| Lepingud | shape-check, emit-contracts |
Igal loetaval väljal on kuju, mis on võetud selle veerust või deklareeritud |
| SQL ja andmesalv | emit-sql, emit-store |
Migratsioon rakendub päris Postgresile, testid kirjutatakse ebaõnnestuma enne |
| Maailm | world |
Demoandmed katavad kõigi ekraanide lahtrid |
| Seostamine | bind |
Iga seose otsustatud osa, ülejäänu loetletakse nimeliste aukudena |
| Kontrollimine | verify |
Projekti enda väravad ekraani kohta, millest igaühe puhul on tõendatud, et see suudab ebaõnnestuda |
Ainus projektispetsiifiline sisend on .mockup-compiler.json, adapter. See määrab, kuidas leht märgib üht ekraani ning milliseid SQL-i ja andmesalve idioome väljastada. Samuti nimetab see rentnikutelgede nimed, sealhulgas selle, mis on iga võtme alguses, ning autoriseerimiskutse, mida iga kirjutamine teeb. mockup-compiler init --project <dir> kirjutab skeleti, milles iga täitmata kirje lükatakse nimeliselt tagasi. Projekt, millel pole oma kasutajaliidese kompilaatorit, ei saa kasutada režiime compile, baseline-check, join ega world ning need režiimid teatavad sellest koodiga NO_PROJECT_COMPILER, selle asemel et hiljem ebaõnnestuda.
Reegel, mille ma sellest kaasa võtaksin ka siis, kui Te seda kunagi ei käivita: kirjutamisreegel, mida spetsifikatsioon ei sätesta, muutub ausaks 501-ks, mis nimetab puuduva, ja mitte kunagi oletuseks. See on sama reegel, mida ootan igalt mudelilt, mis kirjutab ekraanide alusel koodi.
Generaatori omistamine
Kui commiti kirjutab tööriist, peaks commit seda ütlema. Generaatori omistamise leping nõuab commiti sõnumisse üht lõpurida:
feat(excursions): page the nightly telemetry load
X-Generator: claude-code/<model>
Identiteet on <harness>/<model>, väiketähtedega, ühe kaldkriipsuga: rakmed on tööriist, mis töötas (claude-code), ja mudel on see, mida see käitas. Kui mudel muutus commitiga lõpetatava töö käigus, lisage X-Generator-Session iga identiteediga, vanim esimesena, et tööd ei omistataks sellele mudelile, mis juhtus commiti ajal aktiivne olema. Teenus, mis ümbritseb kellegi teise commiti, näiteks ühendamisjärjekord, kannab need lõpuread edasi.
Kaks omadust teevad selle kasulikuks, mitte dekoratiivseks. Väide, mida lugeja ei tunne, säilitatakse ja kuvatakse jaotises unregistered/<harness> täpse tekstiga, seda ei jäeta kunagi välja. Ning lõpurida on ise deklareeritud päritolu, mitte kunagi tõend: miski ei allkirjasta seda, mistõttu iga pind, mis neid väiteid loendab, näitab arvude kõrval seda hoiatust. Identiteedi grammatika avaldatakse koos SDK-ga nimega @adverant-nexus/plugin-sdk/schema/generator-id. See ei ole manifesti väli, sest commiti kirjutanud tööriist on fakt commiti, mitte pistikprogrammi kohta.
AI kirjutatud koodi ülevaatamine
Tööriist kirjutab kiiresti ja enesekindlalt ühesuguse häälega, olgu see õige või vale. Minu ülevaatusrutiin selle muudatuste jaoks on lühike ja ma ei jäta sellest midagi vahele:
- Lugege diff'i, mitte kokkuvõtet. Kokkuvõte ütleb, mida mudel kavatses teha.
- Käivitage valmisoleku definitsioon ise, puhtalt lähtest:
npm ci, testid, järk,validatejanexus-gates. Tsiteerige ülevaatuses viimaseid ridu. - Kontrollige iga uue testi puhul, et see ebaõnnestub puul enne muudatust. Test, mis läbib mõlemal juhul, on dekoratsioon.
- Otsige otseteid. Kustutatud või vahele jäetud test, uus kirje jaotises
gates/ilma põhjuseta, kehast või päisest loetud rentniku väärtus, vaikeorganisatsioon,catch, mis neelab keeldumise, päring aadressile, mida manifest ei deklareeri. - Võrrelge manifesti viimase väljalaskega. Iga uus ulatus või väljuv aadress on laiendamine ja laiendamised vajavad kahte ülevaatajat.
- Kontrollige, et keeldumistestid kinnitavad kogu keha:
error,code,resolved[],missing[]jatroubleshooting[]. - Kontrollige, et commitil on lõpurida
X-Generator.
Väravad püüavad kinni mehaanilised defektid. Need ei oska Teile öelda, kas marsruut kuulub mitte-CRUD-loendisse või kas taustsüsteem on õiguslikult blokeeritud, ega oska seda ka mudel; see otsus jääb Teile. Kui sama probleem aina tagasi tuleb, parandage CLAUDE.md, mitte ainult koodi.
Kuus läbitöötatud viipa
Iga allolev viip on üks neist, mida olen kasutanud, kergelt puhastatud. Iga järel: mida tööriist peaks tootma ja värav, mis tõendab, et see seda tegi. Kui värav pole roheline, pole töö tehtud, ükskõik mida kokkuvõte ütleb.
1. Uus Skills Engine'i oskus
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.
See peaks tootma skills/summarise-excursion/SKILL.md, mille frontmatter'is on name, description, allowed-tools, triggers, capabilities ja version, kehas selle juhised ning testjuhtumid, mis sisaldavad istutatud juhist. Tõendiks on npm run skill:validate skills/summarise-excursion null veaga, seejärel npm run skill:upload skills/summarise-excursion --dry-run, mis näitab plaani. Avaldamine on pärast seda inimese otsus ning kirjutav oskus vajab Enterprise'is kahte nimelist kinnitajat.
2. Täisteenusega pistikprogrammi marsruut
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.
See peaks tootma nummerdatud migratsiooni, mis lisab veeru kolme telge kandvasse tabelisse, mõlemad marsruudid deklareerituna failis api.endpoints[] koos nende auth ja right, õiguse registris rights, ulatusekaitse taga olevad käsitlejad ning testid, mis kinnitavad, et autentimata päring ja vale organisatsiooni päring lükatakse tagasi täielike kehadega. Tõendiks on nexus-gates: scope-adherence, crud-adherence, api-contract, rights-register ja migrations-are-scoped läbivad kõik ning esmalt ebaõnnestuv väljund on transkriptis.
3. Lääts
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.
See peaks kasutama nexus.create plaaniga, mille Teie kinnitate, ja seejärel kujundama läätse selle aluse suhtes. Kui see püüab näidata midagi, mida alus ei näita, lükkab register selle tagasi koodiga LENS_CANNOT_WIDEN ning tööriist peaks sellest teatama, mitte otsima viisi sellest mööda pääseda. Tõendiks on eelvaade inimesena ning edutamisel pilootvärava poliitikakontroll, et lääts ainult kitsendab ja hoiab isikuandmete väljad vaikimisi välja lülitatuna.
4. Domeenipakett
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.
See peaks tootma viisardi plaani, milles on loetletud repositoorium ja selle esimene muudatus, deklareeritud ulatused ja kolm sünteetiliste andmete haru, ning lisaks pack.json koos selle läätseklastrite ja leksikoniga. Midagi ei looda enne, kui Te sõrmejälje kinnitate. Tõendiks on malli testide läbimine sünteetilistel harudel ja hiljem lavastusvärav. Kui pakett küsib rohkem kui selle viimane väljalase, peetakse väljalase koodiga MANIFEST_SCOPE_WIDENED kinni, kuni kaks ülevaatajat selle heaks kiidavad.
5. Andmekonnektor
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.
See peaks tootma plugin_queue oskuse, mille queueName on <plugin name>.<name> ilma kooloniga, timeoutMs vahemikus 1 sekund kuni 6 tundi, töötaja, mis tõmbab järjekorda, sündmuste tabeli migratsiooni, väljuva aadressi paketi manifestis (mitte failis nexus.manifest.json, mille skeemis sellist välja pole) ning mandaadi muutuja nime failis scripts/ci/required-env. Tõendiks on create-nexus-plugin validate, mis rakendab registri sünkroonimise enda reegleid järjekordade nimedele ja ajalõppudele, seejärel nexus-gates, kus no-credentials ja no-direct-compute on rohelised. Käitusajal peatatakse kutse mis tahes aadressile, mida paketi manifest ei deklareerinud, servas koodiga EGRESS_NOT_DECLARED.
6. Enterprise'i moodul
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.
See peaks tootma RouteModule koos selle id, featureGroup, tühja bodies ja register-ga, mis paigaldab ruuteri hosti rakendusele, kusjuures õiguste kontroll on iga käsitleja sees ja keeldumise keha on standardkujul. Tõendiks on litsentsirea värav, mis väljub koodiga 0, seejärel npm ci, npm test ja npm run build läbimine igas komponeeritud väljaande puus. Peatükk 2.25, Iga väljaande jaoks ehitamine, näitab mooduli skeletti ja seda, mida värav tagasi lükkab.
Mis see maksab
Sel viisil töötamine on kiirem, kuid see pole tasuta. Igal agendikäigul on eelarve ja tunnine eluiga ning pikk refaktoreerimine tähendab selle uuendamist. Lugemismärgistus peatab seansi, mis luges üht kliendidokumenti, kirjutamast midagi, kuni Te kinnitate, mis on esimestel kordadel tüütu ja täpselt õige. Skript ei saa kunagi muuta midagi väljaspool Teie liivakasti, seega lavastuskeskkonda jõudmist vajav automatiseerimine läbib muudatustaotluse ja kaks ülevaatajat nagu kõik teisedki. Pigem on mul need piirangud, kui pean Larkfieldile selgitama, miks assistent nende nõuete tabeli kuhugi e-postiga saatis.




