Sínigh isteachCuir cruinniú eolais in áirithe

Caibidil 2.26

Ag tógáil le huirlisí códaithe AI

Conas síntí Nexus a thógáil go sábháilte le Claude Code agus uirlisí códaithe AI (intleacht shaorga) eile. Tosaíonn sé le do IDE (timpeallacht forbartha chomhtháite) a nascadh leis an Workbench agus CLAUDE.md tionscadail a iompraíonn rialacha an ardáin, agus críochnaíonn sé le sé leid oibrithe agus an geata a chruthaíonn gach ceann acu.

d'aistrigh AI an leathanach seo ón mbunleagan Béarla. Má tá aon rud doiléir, is é an leathanach Béarla an tagairt. Léigh an leathanach seo i mBéarla

24 nóiméad le léamh

Scríobhadh an chuid is mó den phacáiste Cold chain i gcaibidil 2.24, Ingearach saincheaptha a thógáil ó thús deireadh, agus Claude Code oscailte sa teirminéal le m'ais. Is gnáth é sin in Corrán Orbital anois, agus tógadh Nexus ag súil leis. Ní chaitheann an t-ardán le huirlis códaithe AI (intleacht shaorga) mar uathlíonadh cliste. Caitheann sé léi mar ghníomhaire atá ag gníomhú thar ceann duine ainmnithe, le pas atá i gcónaí níos cúinge ná pas an duine sin, agus taifeadann sé gach glao a dhéanann an gníomhaire.

Baineann an chaibidil seo le bheith ag obair ar an mbealach sin gan dochar a dhéanamh duit féin. Tosaíonn sí le do IDE (timpeallacht forbartha chomhtháite) a cheangal, ansin pléann sí scileanna san eagarthóir, an comhad tionscadail a mhúineann rialacha an ardáin don uirlis, an dá thiomsaitheoir a iompaíonn obair atá ann cheana ina cód Nexus, an chaoi a ndeir tiomnuithe cén uirlis a scríobh iad, agus an chaoi a ndéanaim athbhreithniú ar a dtáirgeann an uirlis. Críochnaíonn sí le sé leid a thabharfainn do chomhghleacaí, gach ceann acu leis an toradh ba chóir a theacht ar ais agus an geata a chruthaíonn é.

Do IDE a nascadh le Nexus

Tá seoladh Workbench amháin ag gach suiteáil le haghaidh uirlisí códaithe AI. Gheobhaidh tú é ar an leathanach Ceangail do IDE faoi Forbróirí, agus ceanglaíonn Claude Code le hordú amháin:

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

Is é <workbench-address> an seoladh a thaispeánann an leathanach, le cnaipe cóipeála lena thaobh. Tá a n-orduithe aonlíne féin ag na huirlisí eile ar an leathanach céanna: codex mcp add workbench --url <workbench-address> do Codex, nasc suiteála do Cursor, agus code --add-mcp le hargóint bheag JSON do VS Code le Copilot. Labhraíonn siad go léir MCP (Model Context Protocol) leis an seoladh céanna.

Ceangail do IDE
Ceanglaigí bhur IDE
Ceangail do IDE, le hordú amháin in aghaidh na huirlise agus na sraitheanna réamhshocraithe ar dheis. Taispeánann an léaráid ag an mbun gach glao ag dul thar an Workbench, ag fáil a dhintiúir ghearrshaolaigh féin, agus ag teacht i dtír i spás na heagraíochta féin amháin i ngach stór.

Níl aon eochair le greamú. Osclaíonn an chéad ghlao do bhrabhsálaí, a thaispeánann go díreach cad atá ag iarraidh: cén uirlis ar cén ríomhaire, ag gníomhú thar ceann cé, ag iarraidh cé na sraitheanna. Ceadaíonn tú é le do eochair phasfhocail, agus as sin amach níl aon phasfhocal bunachar sonraí ná kubeconfig ag an uirlis, níl aici ach pas a théann in éag. Taobh thiar den seoladh, cruthaíonn Nexus dintiúr gearrshaolach do gach stór, do gach iarratas, mar thusa.

Is féidir le riarthóir eagraíochta comhad socruithe bainistithe a íoslódáil freisin ionas go gceanglóidh gach cóip de Claude Code sa chuideachta leis an bhfreastalaí seo amháin agus nach gceanglóidh sí le haon fhreastalaí eile:

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

Sraitheanna agus pasanna

Faigheann gach síniú isteach sa Workbench pas atá déanta de shraitheanna ainmnithe. Is é Observe agus Sandbox ar a n-aonaid féin an réamhshocrú d'fhorbróir.

Sraith An méid a cheadaíonn sé Cé a fhaigheann é
Observe Do chuid aonad a léamh, logaí agus méadrachtaí san áireamh, agus an chóip cheilte a cheistiú Réamhshocrú
Sandbox Scríobh i do spás féin: do spás forbartha agus do bhrainsí sonraí féin Réamhshocrú
Propose Iarratas athraithe a oscailt; cuireann píblíne i bhfeidhm é tar éis athbhreithnithe Iarrtar é nuair a úsáidtear den chéad uair é
Elevate Gníomh amháin faoi theorainn ama ar sprioc amháin, faofa ag duine ainmnithe Daoine amháin, riamh trí shíniú isteach amháin
Break-glass Rochtain éigeandála Riarthóirí ardáin amháin, le beirt fhaomhóirí

Gníomhaíonn gníomhaire i gcónaí thar ceann duine agus feictear é mar a líne féin. Ní bhíonn a phas riamh níos leithne ná do phas féin agus ní áirítear riamh ann an tsraith Elevate ná sonraí neamhcheilte. Maireann sé uair an chloig, agus ní athnuaitear é ach fad atá tú gníomhach in Nexus nó san IDE. Maireann pas duine 8 n-uaire an chloig. Mar sin stopann uirlis a fhágann tú ag rith thar oíche léi féin, agus nuair a chuireann tú deireadh le do phas féin cuirtear deireadh le pas do ghníomhaire freisin. Iompraíonn gach pas gníomhaire buiséad costais samhla freisin, a mheastar sula mbronntar an pas agus a thaispeántar mar mhéadar fad atá sé ag rith.

Liostaíonn an leathanach Mo phasanna rochtana gach pas atá agatsa agus ag do ghníomhairí, lena shraitheanna agus a bhfuil costas air go dtí seo, agus ligeann sé duit gach ceann a athnuachan, a chúngú nó deireadh a chur leis. Nuair a chuirtear deireadh le pas stoptar an chéad ghlao eile láithreach; fanann an taifead de gach glao. Iompraíonn gach pas teorainneacha crua freisin, a bhí, inár gcás féin, 200 sraith agus 30 soicind in aghaidh an fhiosrúcháin, agus 50 réad athraithe sa spás forbartha in aghaidh an tseisiúin.

An chéad seisiún san IDE

Nuair atá tú ceangailte, liostaíonn /mcp in Claude Code uirlisí an Workbench grúpáilte de réir sraithe. Coinníonn an grúpa Observe na huirlisí léite: workbench.k8s.describe, workbench.k8s.events, workbench.logs.query, workbench.metrics.query, workbench.traces.get, workbench.db.schema, workbench.db.query ar an gcóip cheilte, workbench.graph.query agus workbench.vector.search. Cuireann Sandbox workbench.devspace.deploy, workbench.branch.create agus workbench.branch.reset leis. Cuireann Propose na huirlisí a osclaíonn iarratas athraithe agus a phleanálann athrú graif leis. Níl Elevate ar an bpas ar chor ar bith; iarrann tú é sa chonsól.

San IDE: an chéad seisiún
San IDE: an chéad seisiún
An chéad seisiún in Claude Code, leis na huirlisí liostaithe de réir sraithe, atosú rianaithe siar go dtí a chúis, agus iarratas ar phasfhocal bunachar sonraí diúltaithe. Deir gach freagra cárb as a tháinig sé agus cad a ceileadh.

Ba é mo chéad cheist cheart cén fáth ar atosaigh ár léitheoir teiliméadrachta in Rotterdam thar oíche. Rinne Claude Code cur síos ar an ualach oibre (dhá atosú, as cuimhne in aghaidh teorainn 512 MiB), cheistigh sé na logaí (eagraíocht socraithe ag an ngeata, sonraí pearsanta curtha in eagar) agus an méadracht chuimhne, agus fuair sé amach gur tharraing an lódáil oíchiúil oíche iomlán léamha isteach i mbaisc amháin. Ansin d'iarr mé air, leath mar thástáil, an pasfhocal bunachar sonraí a úsáideann an tseirbhís. Dhiúltaigh an Workbench le SECRET_NEVER_SHOWN. Taispeánann sé ainm Rúin agus a cheithre charachtar dheireanacha, riamh an luach, d'aon duine. Ba é freagra an chúntóra an ceann ceart: ní theastaíonn an pasfhocal uaidh, mar faigheann gach fiosrúchán a dhéanann sé a dhintiúr gearrshaolach féin, ról léite amháin a cruthaíodh don iarratas sin amháin.

Pleanáil, ansin cuir i bhfeidhm

Taispeánann gach uirlis a athraíonn rud éigin plean ar dtús. Is difríocht é an plean le comhaireamh agus méarlorg, agus ní ritheann an cur i bhfeidhm ach an plean sin, go díreach.

San IDE: pleanáil, ansin cuir i bhfeidhm
San IDE: pleanáil, ansin cur i bhfeidhm
Teorainn chuimhne ardaithe sa spás forbartha ó phlean, ansin an t-athrú céanna lasmuigh den bhosca gainimh. Sa seisiún idirghníomhach deimhníonn duine é san IDE; ó script gan chomhéadan diúltaítear dó.

Taobh istigh de do spás forbartha féin, ritheann an cur i bhfeidhm láithreach. Lasmuigh de, caithfidh duine deimhniú san IDE, agus téann an t-athrú chuig an bpíblíne, a chuireann i bhfeidhm é tar éis athbhreithnithe. Leanann dhá dhiúltú as sin, agus bhuail an dá cheann mé:

  • Ó script gan aon duine ag an méarchlár, mar shampla claude -p i dtasc cron, níl aon bhealach chun an bosca deimhnithe a thaispeáint, mar sin diúltaítear d'athrú lasmuigh den bhosca gainimh le CONFIRMATION_UNAVAILABLE. Ní tharlaíonn aon rud. Rith é i seisiún idirghníomhach.
  • Diúltaítear le PLAN_FINGERPRINT_MISMATCH, sula ritheann aon rud, do chur i bhfeidhm a ainmníonn plean nach ndearna an seisiún seo riamh, nó plean a d'athraigh. Pleanáil arís.

Truailliú léite

Is féidir le hábhar custaiméirí treoracha atá dírithe ar chúntóir a cheilt. Mar sin nuair a bhíonn sé léite ag seisiún, cailleann an seisiún a chuid uirlisí le haghaidh scríbhneoireachta agus le haghaidh teacht ar áiteanna lasmuigh de Nexus go dtí go ndeimhníonn duine scríobh amháin nó go dtosaíonn sé seisiún úr.

San IDE: truailliú léite
San IDE: truailliú léite
Doiciméad éilimh léite ar an gcóip cheilte, le treoir i bhfolach ann a ndearna an cúntóir neamhaird di. Diúltaítear don chéad scríobh eile go dtí go ndeimhníonn an duine an scríobh sin amháin nó go dtosaíonn sé seisiún úr.

Tháinig mé air seo i ndoiciméad éilimh ina raibh alt dírithe ar "an cúntóir", ag iarraidh air an tábla éileamh a chóipeáil chuig seoladh lasmuigh. Rinne Claude Code neamhaird de agus dúirt sé amhlaidh. Nuair a d'iarr mé air ansin an sárú a chur le graf mo bhrainse, diúltaíodh don scríobh le SESSION_TAINTED. D'fhéadfainn an scríobh sin amháin a dheimhniú tar éis a phlean a léamh, nó seisiún úr a thosú nár léigh an doiciméad. Ní thruaillíonn logaí agus méadrachtaí seisiún. Truaillíonn doiciméid, ticéid, ríomhphost agus téacs foinse graif ar fad é. Comhaireadh an téacs ceilte i mo thaifead gníomhaíochta mar threoracha a aimsíodh in ábhar, gan a chuid focal.

Eagraíocht eile

Ní féidir le haon rud a chlóscríobhann tú teacht ar shonraí eagraíochta eile. Iarr iad agus diúltaíonn gach stór le TENANT_BOUNDARY. Má shleamhnaítear luach eagraíochta isteach i bhfiosrúchán loga, cuireann an geata do luach féin ina áit. Ní cead atá in easnamh é. Tá gach sraith ar an gcosán fálaithe do d'eagraíocht, mar sin níl aon duine a d'fhéadfadh é a bhronnadh ón áit ina bhfuil tú, agus ní chabhródh rochtain riarthóra ardáin ach an oiread. Má aontaíonn dhá eagraíocht sonraí a roinnt, is comhaontú é sin a bhunaítear eatarthu, riamh rud a dhéanann seisiún IDE.

Scileanna san IDE agus Claude Code

Is fillteáin SKILL.md iad scileanna Skills Engine, agus léann Claude Code na fillteáin chéanna. Sioncronaítear an leabharlann le ~/.claude/skills i d'eolaire baile féin, inléite amháin, le do dhréachtaí lena dtaobh in ~/.claude/skills/drafts. Mar sin tá na scileanna atá foilsithe ag d'eagraíocht ar fáil i d'eagarthóir gan aon chóipeáil, agus téann a scríobhann tú go háitiúil ar ais trí na tástálacha agus an faomhadh céanna le haon rud a scríobhadh sa chonsól.

Scileanna san IDE agus Claude Code
Scileanna san IDE agus Claude Code
Scil scríofa agus tástáilte san eagarthóir, ansin seolta tríd an bhfaomhadh céanna le ceann a rinneadh sa chonsól. Tabhair faoi deara gur coinníodh siar an foilsiú mar nach féidir lena húdar a athrú féin a fhaomhadh.

Ón teirminéal, sa stór ina bhfuil an scil, tógann dhá script npm í ó d'eagarthóir isteach sa leabharlann:

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

Seiceálann Validate an fhormáid agus na cásanna tástála. Déanann Upload dréacht, agus má mheaitseálann an t-ábhar leagan atá foilsithe cheana tugann sé an leagan sin ar ais ina áit (CONTENT_HASH_ALREADY_PUBLISHED). Coinnítear Publish siar le haghaidh faofa nuair a theastaíonn sé ón scil, agus ní féidir leat d'athrú féin a fhaomhadh. Diúltaítear le SKILLS_ENGINE_BINDING_MISSING do rith a thosaítear ó script gan bealach samhla: roghnaíonn an seoltóir an bealach agus seiceálann an t-inneall gur tugadh é, gan buille faoi thuairim a thabhairt riamh. Taispeánann Caibidil 2.24, Ingearach saincheaptha a thógáil ó thús deireadh, na scripteanna céanna i dtionscadal iomlán.

Sroicheann gníomhairí agus Claude Code an leabharlann thar MCP freisin, trí 13 uirlis san iomlán. Ina measc, aimsíonn agus léann list_skills agus get_skill scil, deir match_prompt agus discover_skills cén scil a oireann do thasc, ritheann invoke_skill ceann, agus cóipeálann sync_skills_local an leabharlann chuig d'fhillteán scileanna. Ritheann gach glao mar an duine a thosaigh é, laistigh dá liosta ceadaithe. Ní féidir le scil a huirlisí a leathnú riamh thar liosta ceadaithe an té a ritheann í.

CLAUDE.md tionscadail a iompraíonn rialacha an ardáin

Léann Claude Code CLAUDE.md ag fréamh an stóir ag tús gach seisiúin. Is é an beart sábháilteachta is saoire atá agat, mar cuireann sé rialacha an ardáin os comhair na samhla sula scríobhann sí aon rud. Beireann geataí an SDK (trealamh forbartha bogearraí) ar fhormhór na mbotún ar aon nós, ach ní chosnaíonn riail a léigh an tsamhail roimh ré tógáil theipthe ar bith duit.

Scríobh é mar rialacha lena gcúiseanna, ní mar mhianta. Seo an ceann inár stór breiseáin Cold chain, bearrtha beagán:

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

Trí rud a chuireann comhad mar seo ag obair. Ainmníonn gach riail an mheicníocht a fhorfheidhmíonn í, ionas gur féidir leis an tsamhail a cuid oibre féin a sheiceáil in aghaidh an ruda chéanna a sheiceálfaidh an phíblíne. Is liosta orduithe le cóid scoir é an sainmhíniú ar chríochnaithe, ní mothú. Agus coisceann sé na haicearraí sonracha a mbaineann samhail úsáid astu nuair a bhíonn tógáil dearg, amhail an tástáil a scriosadh nó áitchoinneálaí a chur mar réamhshocrú ar eagraíocht atá in easnamh.

Corpas an SDK a bheathú mar chomhthéacs

Is sraith 28 imleabhar é doiciméadú an SDK, scríofa ionas gur féidir le forbróir nó le LLM (samhail mhór teanga) breiseán iomlán táirgthe a thógáil ón gcorpas amháin, gan rochtain ar chód príobháideach an ardáin. Tá gach cruth sreinge agus cód earráide a mbuaileann breiseán leo sna doiciméid féin.

Fágann sin gur comhthéacs thar a bheith maith é. Go praiticiúil tugaim do Claude Code na himleabhair a bhaineann leis an tasc seachas an tsraith iomlán: na himleabhair léiriúcháin agus HTTP do bhealach nua, imleabhar an bhunachair sonraí d'imirce, catalóg na n-earráidí aon uair a bhaineann diúltú leis, agus an seicliosta comhréireachta i gcónaí, mar is é an corpas iomlán mar liosta ticeála é. Abair leis an tsamhail fíric bhreathnaithe a roghnú thar a cuimhne féin ar an gcaoi a n-oibríonn creat de ghnáth. Nuair a easaontaíonn an dá cheann, tá an ceart ag an gcorpas faoin ardán seo.

Don fhorbróir tosaigh ar d'fhoireann, gin treoir ón léiriúchán in ionad ceann a scríobh:

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

Liostaíonn sí gach bealach a fhéadfaidh an aip ghréasáin a ghlaoch le gach diúltú a d'fhéadfadh teacht ar ais, mar sin is comhthéacs maith í don tsamhail atá ag scríobh na haipe gréasáin freisin. Tiomnaigh í, agus seiceáil í in CI (comhtháthú leanúnach) le --check --lint ionas nach féidir léi imeacht ón léiriúchán.

Stór atá ann cheana a chuimsiú: /plugin-create

Iompaíonn an scil /plugin-create stór atá ann cheana nó sonraíocht API (comhéadan ríomhchláraithe feidhmchláir) ina breiseán Nexus. Tabhair an fhoinse di nuair a ghlaonn tú uirthi:

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

Oibríonn sí i gcéimeanna. Clónálann agus anailísíonn sí an fhoinse ar dtús, ag oibriú amach an teanga agus an creat, dromchla an API, an bunachar sonraí agus a imirce, agus cad a dhéanann an rud i ndáiríre. Priontálann sí tuarascáil anailíse agus roghnaíonn sí straitéis timfhillte bunaithe ar a bhfuair sí:

Foinse Straitéis
API REST (aistriú staide léiritheach) in Node.js Timfhillteán Express timpeall na mbealaí atá ann cheana
API REST in Python Timfhillteán FastAPI
Node.js agus React lánchruachta Timfhillteán cúlchórais le cuibheoir comhéadain úsáideora (UI)
Uirlis líne na n-orduithe API Express a ritheann na horduithe
Leabharlann nó SDK API Express a nochtann a fheidhmeanna
Ardán casta Coimeádán breiseáin amháin le seachfhreastalaí nginx os a chomhair

Ansin gineann sé an cúlchóras agus a imirceanna, UI, an léiriú agus na tástálacha. Caithigí lena scríobhann sé mar chéad dréacht láidir agus coinnigí é faoin gcaighdeán céanna le haon rud eile. Inár stór, chiallaigh sé sin trí chéim sular athbhreithnigh aon duine é. D'ardaíomar a léiriú go dtí an conradh v2 le create-nexus-plugin migrate --write, a chuireann na habairtí dlí leis agus a dhiúltaíonn pointe iontrála a chumadh. Ansin chinntíomar go n-éireodh leis i create-nexus-plugin validate. Agus ritheamar nexus-gates go dtí gur iompaigh sé glas, rud a chiallaigh inár gcás ceanntásca tionónta a léadh an timfhillteán féin a athsholáthar le garda raoin an SDK, agus na trí ais a chur lena tháblaí. Fanann an t-imscaradh le cainéil eisiúna na suiteála; déanaigí neamhaird d'aon chomhaid imscartha atá sa dréacht.

mockup-compiler: ó scáileáin go cód oibre

Oibríonn an dara tiomsaitheoir an bealach eile timpeall. Glacann mockup-compiler le marcanna aithrise tionscadail, ar féidir leo na mílte scáileán a chuimsiú, agus tiomsaíonn sé iad ina UI oibre, ina mbealaí backend for frontend (BFF) agus ina SQL, cruthaithe dílis scáileán ar scáileán ag geataí le cóid scoir. Rianaíonn sé gach focal tarraingthe go dtí an líne foinse a tharraing é, nascann sé gach scáileán lena shonraíocht, oibríonn sé amach na hathruithe fearainn a theastaíonn ó na scáileáin, agus astaíonn sé na conarthaí agus na himirceanna mar aon le sonraíocht ar na sonraí taispeána a theastaíonn ó gach scáileán.

Tá dhá riail a dhéanann idirdhealú idir é agus iarraidh ar mhúnla "na scáileáin seo a thógáil":

  • An tiomsaitheoir ar dtús. Ríomhtar aon rud is féidir a bheith ar eolas, go cinntitheach. Ní úsáidtear múnla ach le haghaidh poll clóscríofa: scríobhann sé déantán i gcoinne scéimre, glacann seiceálaí cinntitheach leis nó ainmníonn sé gach locht, agus faigheann an múnla 3 bhabhta deisiúcháin ar a mhéad, beathaithe le tuairisc an tseiceálaí.
  • Tá rialú diúltach le locht curtha ag gach geata. Nuair a ritheann verify geataí tionscadail do scáileán, faigheann cóip den chrann locht curtha amháin in aghaidh an gheata, agus má ligeann geata dá locht curtha pasáil, marcáiltear an rith ar fad mar neamhiontaofa. Cuireann geata nach féidir leis teip deireadh leis an rith.

Ritheann an obair i gcéimeanna, gach ceann acu lena mhód féin agus lena gheata féin:

Céim Mód An rud a chruthaíonn a gheata
Greamú pin Tá an líníocht comhionann thar dhá thógáil, le haitheantais uathúla scáileáin
Rianú trace Rianaítear gach focal tarraingthe go dtí líne foinse amháin go díreach
Nascadh join Meaitseálann gach sliotán tiomsaithe an fhoinse a tharraing é
Sonraíocht spec Tá a shraith féin den sonraíocht ag gach scáileán
Athrú fearainn domain Clúdaíonn an togra gach rud a léann agus a scríobhann na scáileáin, le cóid ó chatalóg an SDK
Conarthaí shape-check, emit-contracts Tá cruth ag gach réimse léite, tógtha óna cholún nó dearbhaithe
SQL agus stór emit-sql, emit-store Cuirtear an imirce i bhfeidhm ar Postgres fíor, le tástálacha teip-ar-dtús
Domhan world Clúdaíonn na sonraí taispeána cealla gach scáileáin
Ceangal bind An chuid chinntithe de gach ceangal, agus an chuid eile liostaithe mar phoill ainmnithe
Fíorú verify Geataí an tionscadail féin in aghaidh an scáileáin, gach ceann cruthaithe in ann teip

Is é .mockup-compiler.json, an cuibheoir, an t-aon ionchur atá sainiúil don tionscadal. Insíonn sé conas a mharcálann leathanach scáileán amháin agus cé na nathanna SQL agus stóir le hastú. Ainmníonn sé freisin na haiseanna tionóntachta, leis an gceann atá ar tús gach eochrach, agus an glao údaraithe a dhéanann gach scríobh. Scríobhann mockup-compiler init --project <dir> creatlach ina ndiúltaítear gach iontráil nár líonadh de réir ainm. Ní féidir le tionscadal gan a thiomsaitheoir UI féin compile, baseline-check, join ná world a úsáid, agus deir na móid sin é sin le NO_PROJECT_COMPILER seachas teip níos faide síos.

An riail a thógfainn uaidh fiú mura ritheann sibh riamh é: déantar 501 macánta de riail scríbhneoireachta nach luann an sonraíocht, a ainmníonn a bhfuil in easnamh, agus ní buille faoi thuairim riamh. Is í sin an riail chéanna a theastaíonn uaim ó aon mhúnla a scríobhann cód i gcoinne scáileán.

Sannadh gineadóra

Nuair a scríobhann uirlis tiomantas, ba cheart don tiomantas é sin a rá. Iarrann an conradh sannadh giniúna líne leantóra amháin sa teachtaireacht tiomantais:

feat(excursions): page the nightly telemetry load

X-Generator: claude-code/<model>

Is é <harness>/<model> an t-aitheantas, i gcás íochtair, le slais amháin: is é an úim an uirlis a rith (claude-code), agus is é an múnla an ceann a bhí á rith aici. Má athraíodh an múnla le linn na hoibre a dhúnann an tiomantas, cuirigí X-Generator-Session leis le gach aitheantas, an ceann is sine ar dtús, ionas nach gcuirtear an obair i leith cibé múnla a bhí gníomhach ag am an tiomantais. Iompraíonn seirbhís a fhilleann tiomantas duine eile, amhail scuaine chumasc, na leantóirí seo ar aghaidh.

Déanann dhá airí é seo úsáideach seachas maisiúil. Coinnítear éileamh nach n-aithníonn léitheoir agus taispeántar é faoi unregistered/<harness> agus an téacs cruinn caomhnaithe, gan é a chaitheamh amach riamh. Agus is bunús féintuairiscithe é an leantóir, ní cruthúnas riamh: ní shíníonn aon rud é, mar sin taispeánann gach dromchla a chomhaireann na héilimh seo an fainic sin in aice leis na huimhreacha. Foilsítear gramadach an aitheantais leis an SDK mar @adverant-nexus/plugin-sdk/schema/generator-id. Ní réimse léirithe é, toisc gur fíric faoin tiomantas í an uirlis a scríobh tiomantas, ní faoin mbreiseán.

Athbhreithniú ar chód a scríobh AI

Scríobhann an uirlis go tapa agus go muiníneach sa ghuth céanna cibé an bhfuil an ceart aici nó nach bhfuil. Tá mo ghnáthamh athbhreithnithe dá hathruithe gearr agus ní scipeálaim aon chuid de:

  1. Léigí an difríocht, ní an achoimre. Deir an achoimre cad a bhí i gceist ag an múnla a dhéanamh.
  2. Rithigí an sainmhíniú ar 'déanta' sibh féin, ó thús glan: npm ci, na tástálacha, an tógáil, validate agus nexus-gates. Luaigí na línte deiridh san athbhreithniú.
  3. I gcás gach tástála nua, seiceálaigí go dteipeann uirthi ar an gcrann roimh an athrú. Is maisiúchán é tástáil a phasálann an dá bhealach.
  4. Bígí ag faire ar na haicearraí. Tástáil scriosta nó scipeáilte, iontráil nua faoi gates/ gan chúis, luach tionónta léite ó chorp nó ó cheanntásc, eagraíocht réamhshocraithe, catch a shlogann diúltú, fetch chuig seoladh nach ndearbhaíonn an léiriú.
  5. Cuirigí an léiriú i gcomparáid leis an eisiúint dheireanach. Is leathnú é aon raon nó seoladh amach nua, agus faigheann leathnuithe beirt athbhreithneoirí.
  6. Seiceálaigí go ndearbhaíonn tástálacha diúltaithe an corp iomlán: error, code, resolved[], missing[] agus troubleshooting[].
  7. Seiceálaigí go bhfuil a leantóir X-Generator ag an tiomantas.

Beireann na geataí ar na lochtanna meicniúla. Ní féidir leo a insint daoibh an mbaineann bealach leis an liosta neamh-CRUD, nó an bhfuil cúlchóras blocáilte go dlíthiúil, agus ní féidir leis an múnla ach oiread; fanann an breithiúnas sin libh. Má thagann an fhadhb chéanna ar ais arís is arís eile, deisigí an CLAUDE.md, ní an cód amháin.

Sé leid oibrithe

Is leid í gach leid thíos a d'úsáid mé, glanta suas beagán. Tar éis gach ceann: cad ba cheart don uirlis a tháirgeadh, agus an geata a chruthaíonn go ndearna sí é. Mura bhfuil an geata glas, níl an obair déanta, is cuma cad a deir an achoimre.

1. Scil nua 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.

Ba cheart di skills/summarise-excursion/SKILL.md a tháirgeadh le name, description, allowed-tools, triggers, capabilities agus version sa réamhábhar, a treoracha sa chorp, agus cásanna tástála a chuimsíonn an treoir churtha. Is é npm run skill:validate skills/summarise-excursion gan aon earráid an cruthúnas, ansin npm run skill:upload skills/summarise-excursion --dry-run ag taispeáint an phlean. Is cinneadh duine é an foilsiú ina dhiaidh sin, agus teastaíonn beirt fhaomhóirí ainmnithe ó scil a scríobhann ar Enterprise.

2. Bealach breiseáin lánseirbhíse

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.

Ba cheart di imirce uimhrithe a tháirgeadh a chuireann an colún le tábla a iompraíonn na trí ais, an dá bhealach dearbhaithe i api.endpoints[] lena auth agus right, an ceart i gclár rights, láimhseálaithe taobh thiar den gharda raoin, agus tástálacha a dhearbhaíonn go ndiúltaítear iarratas neamhfhíordheimhnithe agus iarratas ón eagraíocht mhícheart le coirp iomlána. Is é nexus-gates an cruthúnas: pasálann scope-adherence, crud-adherence, api-contract, rights-register agus migrations-are-scoped ar fad, agus tá an t-aschur teip-ar-dtús sa tras-scríbhinn.

3. Lionsa

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.

Ba cheart di nexus.create a úsáid le plean a dheimhníonn sibh, agus ansin an lionsa a mhúnlú i gcoinne a bhoinn. Má dhéanann sí iarracht rud a thaispeáint nach dtaispeánann an bonn, diúltaíonn an clárlann le LENS_CANNOT_WIDEN, agus ba cheart don uirlis é sin a thuairisciú seachas bealach timpeall a lorg. Is é an cruthúnas an réamhamharc mar dhuine, agus ag an ardú céime, seiceáil pholasaí gheata an phíolóta go gcúngaíonn an lionsa amháin agus go gcoinníonn sé réimsí pearsanta múchta de réir réamhshocraithe.

4. Pacáiste fearainn

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.

Ba cheart di plean an draoi a tháirgeadh, ag liostú an stóir agus a chéad athrú, na raonta dearbhaithe agus na trí bhrainse sonraí sintéiseacha, chomh maith le pack.json lena bhraislí lionsaí agus a fhoclóir. Ní dhéantar aon rud go dtí go ndeimhníonn sibh an mhéarlorg. Is é an cruthúnas tástálacha an teimpléid ag pasáil ar na brainsí sintéiseacha, agus níos déanaí an geata stáitsithe. Má iarrann an pacáiste níos mó ná a eisiúint dheireanach, coinnítear an eisiúint siar le MANIFEST_SCOPE_WIDENED go dtí go nglacann beirt athbhreithneoirí léi.

5. Nascóir sonraí

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.

Ba cheart di scil plugin_queue a tháirgeadh a bhfuil <plugin name>.<name> mar queueName aici gan idirstad, timeoutMs idir 1 soicind agus 6 uair an chloig, oibrí a tharraingíonn an scuaine, imirce don tábla imeachtaí, an seoladh amach i léiriú an phacáiste (ní i nexus.manifest.json, nach bhfuil a leithéid de réimse ina scéimre), agus ainm athróg an dintiúir i scripts/ci/required-env. Is é create-nexus-plugin validate an cruthúnas, a chuireann rialacha shioncronú na clárlainne féin i bhfeidhm ar ainmneacha scuainí agus ar theorainneacha ama, ansin nexus-gates le no-credentials agus no-direct-compute glas. Ag am rite, stoptar ag an imeall le EGRESS_NOT_DECLARED glao chuig aon seoladh nár dhearbhaigh léiriú an phacáiste.

6. Modúl 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.

Ba cheart di RouteModule a tháirgeadh lena id, featureGroup, bodies folamh agus register a fheistíonn ródaire ar aip an óstaigh, le seiceáil an deontais laistigh de gach láimhseálaí agus corp an diúltaithe sa chruth caighdeánach. Is é an cruthúnas geata líne an cheadúnais ag scor le 0, ansin npm ci, npm test agus npm run build ag pasáil i ngach crann eagráin chumtha. Taispeánann Caibidil 2.25, Ag tógáil do gach eagrán, creatlach an mhodúil agus a ndiúltaíonn an geata dó.

Cad a chosnaíonn sé

Is tapúla oibriú ar an mbealach seo, agus ní saor in aisce é. Tá buiséad agus saolré uair an chloig ag gach pas gníomhaire, agus ciallaíonn athfhachtóiriú fada é a athnuachan. Stopfaidh truailliú léite seisiún a léigh doiciméad custaiméara amháin ó aon rud a scríobh go dtí go ndeimhníonn sibh, rud atá greannach an chéad chúpla uair agus atá díreach ceart. Ní féidir le script aon rud a athrú taobh amuigh de bhur mbosca gainimh riamh, mar sin téann uathoibriú a chaithfidh stáitsiú a bhaint amach trí iarratas athraithe agus beirt athbhreithneoirí cosúil le gach duine eile. B'fhearr liom na teorainneacha sin a bheith ann ná a mhíniú do Larkfield cén fáth ar sheol cúntóir a dtábla éileamh áit éigin trí ríomhphost.