УвійтиЗамовити брифінг

Розділ 2.26

Розробка за допомогою ШІ-інструментів для написання коду

Як безпечно створювати розширення Nexus за допомогою Claude Code та інших інструментів програмування на базі ШІ (штучного інтелекту). Розділ починається з підключення вашої IDE (інтегрованого середовища розробки) до Workbench і файлу проєкту CLAUDE.md, що містить правила платформи, а завершується шістьма опрацьованими промптами та контрольною перевіркою, яка підтверджує кожен із них.

Цю сторінку перекладено за допомогою ШІ з англійського оригіналу. Якщо щось незрозуміло, орієнтуйтеся на англійську версію сторінки. Читати цю сторінку англійською

24 хв читання

Більшу частину пакета Cold chain у розділі 2.24, «Створення власної вертикалі від початку до кінця», було написано з Claude Code, відкритим у терміналі поруч зі мною. Тепер це звична практика в Corrán Orbital, і Nexus створювали з розрахунку саме на це. Платформа не розглядає інструмент програмування на базі ШІ (штучного інтелекту) як розумне автодоповнення. Вона розглядає його як агента, що діє від імені конкретної особи, з перепусткою, яка завжди вужча за перепустку цієї особи, і записує кожен виклик, який робить агент.

Цей розділ про те, як працювати так і не постраждати. Він починається з підключення вашого IDE (інтегрованого середовища розробки), далі розглядає навички в редакторі, файл проєкту, який навчає інструмент правил платформи, два компілятори, що перетворюють наявну роботу на код Nexus, те, як коміти вказують, який інструмент їх написав, і те, як я перевіряю результати роботи інструмента. Наприкінці наведено шість запитів, які я дав би колезі, для кожного — що має повернутися і яка перевірка це підтверджує.

Підключення вашої IDE до Nexus

Кожна інсталяція має одну адресу Workbench для інструментів програмування на базі ШІ. Ви знайдете її на сторінці «Підключіть свій IDE» в розділі «Розробникам», а Claude Code підключається однією командою:

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

<workbench-address> — це адреса, яку показує сторінка, з кнопкою копіювання поруч. Інші інструменти мають власні однорядкові команди на тій самій сторінці: codex mcp add workbench --url <workbench-address> для Codex, посилання на встановлення для Cursor і code --add-mcp з невеликим аргументом JSON для VS Code з Copilot. Усі вони взаємодіють за протоколом MCP (Model Context Protocol) з тією самою адресою.

Підключіть свій IDE
Підключіть свою IDE
Сторінка «Підключіть свій IDE» з однією командою для кожного інструмента та типовими рівнями праворуч. Діаграма внизу показує, як кожен виклик проходить через Workbench, отримує власні короткочасні облікові дані та потрапляє лише до власного простору організації в кожному сховищі.

Ключ вставляти не потрібно. Перший виклик відкриває ваш браузер, який точно показує, що саме запитує доступ: який інструмент, на якому комп'ютері, від чийого імені і які рівні він хоче отримати. Ви дозволяєте це своїм ключем доступу (passkey), і відтоді інструмент не має жодного пароля до бази даних чи kubeconfig, лише перепустку з обмеженим терміном дії. За цією адресою Nexus створює короткочасні облікові дані для кожного сховища, для кожного запиту, від вашого імені.

Адміністратор організації також може завантажити файл керованих налаштувань, щоб кожна корпоративна копія Claude Code підключалася до цього сервера і до жодного іншого:

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

Рівні та перепустки

Кожен вхід до Workbench отримує перепустку, що складається з іменованих рівнів. Типово розробник отримує рівні Observe і Sandbox для власних модулів.

Рівень Що воно дозволяє Хто отримує
Observe Читання ваших модулів, зокрема журналів і метрик, та запити до замаскованої копії За замовчуванням
Sandbox Запис у вашому власному просторі: вашому просторі розробки та ваших власних гілках даних За замовчуванням
Propose Створення запиту на зміну; конвеєр застосовує його після перевірки Запитується під час першого використання
Elevate Одна обмежена в часі дія над однією ціллю, схвалена конкретною особою Лише люди, ніколи лише через вхід
Break-glass Аварійний доступ Лише адміністратори платформи, з двома особами, що схвалюють

Агент завжди діє від імені особи й відображається окремим рядком. Його перепустка ніколи не ширша за вашу і ніколи не містить рівня Elevate чи незамаскованих даних. Вона діє одну годину й поновлюється лише поки ви активні в Nexus або IDE. Перепустка особи діє 8 годин. Тож інструмент, який ви залишили працювати на ніч, зупиняється сам, а завершення вашої власної перепустки завершує й перепустку вашого агента. Кожна перепустка агента також має бюджет витрат на моделі, який оцінюється до надання перепустки й відображається як лічильник під час її дії.

Сторінка «Мої перепустки доступу» містить перелік усіх перепусток, які маєте ви та ваші агенти, з їхніми рівнями та витратами на поточний момент, і дає змогу поновити, звузити або завершити кожну з них. Завершення перепустки негайно зупиняє наступний виклик; запис про кожен виклик зберігається. Кожна перепустка також має жорсткі обмеження, які в нашому випадку становили 200 рядків і 30 секунд на запит, а також 50 змінених об'єктів у просторі розробки за сеанс.

Перший сеанс в IDE

Після підключення /mcp у Claude Code показує інструменти Workbench, згруповані за рівнями. Група Observe містить інструменти читання: workbench.k8s.describe, workbench.k8s.events, workbench.logs.query, workbench.metrics.query, workbench.traces.get, workbench.db.schema, workbench.db.query для замаскованої копії, workbench.graph.query і workbench.vector.search. Sandbox додає workbench.devspace.deploy, workbench.branch.create і workbench.branch.reset. Propose додає інструменти, які створюють запит на зміну та планують зміну графа. Рівня Elevate у перепустці взагалі немає; ви запитуєте його в консолі.

В IDE: перший сеанс
В IDE: перший сеанс
Перший сеанс у Claude Code з інструментами, переліченими за рівнями, перезапуском, відстеженим до його причини, і відхиленим запитом на пароль до бази даних. Кожна відповідь вказує, звідки вона взялася і що було приховано.

Моє перше справжнє запитання полягало в тому, чому наш зчитувач телеметрії перезапустився в Роттердамі вночі. Claude Code описав робоче навантаження (два перезапуски через нестачу пам'яті при обмеженні 512 MiB), зробив запит до журналів (організацію встановлено шлюзом, персональні дані відредаговано) і метрики пам'яті та з'ясував, що нічне завантаження збирало показання за цілу ніч в один пакет. Потім я, наполовину для перевірки, попросив у нього пароль до бази даних, який використовує сервіс. Workbench відмовив із SECRET_NEVER_SHOWN. Він показує назву Secret і останні чотири символи, але ніколи не значення, нікому. Відповідь асистента була правильною: пароль йому не потрібен, оскільки кожен його запит отримує власні короткочасні облікові дані — роль лише для читання, створену для цього одного запиту.

Спершу план, потім застосування

Кожен інструмент, що щось змінює, спочатку показує план. План — це diff із кількісними показниками та відбитком, а застосування виконує саме цей план і точно його.

В IDE: спершу план, потім застосування
В IDE: спочатку план, потім застосування
Обмеження пам'яті, підвищене в просторі розробки за планом, а потім та сама зміна поза пісочницею. В інтерактивному сеансі особа підтверджує її в IDE; зі скрипту без інтерфейсу її відхилено.

У вашому власному просторі розробки застосування виконується одразу. Поза ним особа має підтвердити зміну в IDE, і зміна надходить до конвеєра, який застосовує її після перевірки. З цього випливають дві відмови, і з обома я стикнувся:

  • Зі скрипту, за яким ніхто не сидить, наприклад claude -p у завданні cron, немає способу показати вікно підтвердження, тож зміну поза пісочницею відхиляють із CONFIRMATION_UNAVAILABLE. Нічого не відбувається. Запустіть це в інтерактивному сеансі.
  • Застосування, що посилається на план, якого цей сеанс ніколи не створював, або на план, що змінився, відхиляється з PLAN_FINGERPRINT_MISMATCH ще до виконання будь-чого. Сплануйте знову.

Позначка після читання

Вміст клієнтів може містити приховані інструкції, призначені для асистента. Тому щойно сеанс його прочитав, сеанс втрачає інструменти для запису та для звернення за межі Nexus, доки особа не підтвердить один запис або не почне новий сеанс.

В IDE: позначка після читання
В IDE: read-taint
Документ претензії, прочитаний у замаскованій копії, з прихованою в ньому інструкцією, яку асистент проігнорував. Наступний запис відхилено, доки особа не підтвердить цей один запис або не почне новий сеанс.

Я зіткнувся з цим на документі претензії, що містив абзац, адресований «асистенту», з проханням скопіювати таблицю претензій на зовнішню адресу. Claude Code проігнорував його й повідомив про це. Коли я потім попросив додати відхилення до графа моєї гілки, запис було відхилено з SESSION_TAINTED. Я міг підтвердити цей один запис, прочитавши його план, або почати новий сеанс, який не читав документа. Журнали й метрики не позначають сеанс. Документи, заявки, пошта та вихідний текст графа — позначають. Прихований текст було враховано в моєму записі активності як інструкції, знайдені у вмісті, без самих слів.

Інша організація

Ніщо з того, що ви вводите, не може дістатися даних іншої організації. Запросіть їх, і кожне сховище відмовить із TENANT_BOUNDARY. Значення організації, підставлене в запит до журналів, шлюз замінює вашим власним. Це не відсутній дозвіл. Кожен рівень на шляху обмежено вашою організацією, тож немає нікого, хто міг би надати такий доступ з вашої позиції, і доступ адміністратора платформи теж не допоміг би. Якщо дві організації домовляються обмінюватися даними, це угода, налаштована між ними, а не те, що робить сеанс IDE.

Навички в IDE та Claude Code

Навички Skills Engine — це папки SKILL.md, і Claude Code читає ті самі папки. Бібліотека синхронізується з ~/.claude/skills у вашому власному домашньому каталозі в режимі лише для читання, а ваші чернетки розміщуються поруч у ~/.claude/skills/drafts. Тож навички, опубліковані вашою організацією, доступні у вашому редакторі без будь-якого копіювання, а написане локально проходить ті самі тести й схвалення, що й усе, написане в консолі.

Навички в IDE та Claude Code
Навички в IDE та Claude Code
Навичка, написана й перевірена в редакторі, а потім надіслана на те саме схвалення, що й створена в консолі. Зверніть увагу, що публікацію затримано, бо автор не може схвалити власну зміну.

З термінала, у репозиторії, що містить навичку, два скрипти npm переносять її з вашого редактора до бібліотеки:

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

Validate перевіряє формат і тестові випадки. Upload створює чернетку, а якщо вміст збігається з уже опублікованою версією, повертає цю версію (CONTENT_HASH_ALREADY_PUBLISHED). Publish затримується для схвалення, коли навичка цього потребує, і ви не можете схвалити власну зміну. Запуск зі скрипту без маршруту моделі відхиляється з SKILLS_ENGINE_BINDING_MISSING: диспетчер обирає маршрут, а рушій перевіряє, що його надано, і ніколи не вгадує. Розділ 2.24, «Створення власної вертикалі від початку до кінця», показує ті самі скрипти в цілому проєкті.

Агенти та Claude Code також звертаються до бібліотеки через MCP, загалом за допомогою 13 інструментів. Серед них list_skills і get_skill знаходять і читають навичку, match_prompt і discover_skills визначають, яка навичка підходить для завдання, invoke_skill запускає її, а sync_skills_local копіює бібліотеку до вашої папки навичок. Кожен виклик виконується від імені особи, яка його ініціювала, у межах її списку дозволених. Навичка ніколи не може розширити свої інструменти за межі списку дозволених того, хто її запускає.

Файл проєкту CLAUDE.md, що містить правила платформи

Claude Code на початку кожного сеансу читає CLAUDE.md у корені репозиторію. Це найдешевший засіб безпеки, який у вас є, бо він показує моделі правила платформи до того, як вона щось напише. Перевірки SDK (комплекту для розробки програмного забезпечення) і так виявлять більшість помилок, але правило, яке модель прочитала заздалегідь, не коштує вам невдалої збірки.

Пишіть його як правила з обґрунтуваннями, а не як побажання. Ось файл із нашого репозиторію плагіна Cold chain, трохи скорочений:

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

Ефективним такий файл роблять три речі. Кожне правило називає механізм, який його забезпечує, тож модель може перевіряти свою роботу за тим самим критерієм, що й конвеєр. Критерій готовності — це список команд із кодами завершення, а не відчуття. І він забороняє конкретні обхідні шляхи, до яких вдається модель, коли збірка не проходить, наприклад видалення тесту або підставлення заповнювача замість відсутньої організації.

Передавання корпусу SDK як контексту

Документація SDK складається з 28 томів, написаних так, щоб розробник або LLM (велика мовна модель) міг створити повноцінний виробничий плагін лише на основі цього корпусу, без доступу до закритого коду платформи. Кожен формат даних і кожен код помилки, з якими стикається плагін, наведено в самих документах.

Це робить її надзвичайно добрим контекстом. На практиці я даю Claude Code томи, що стосуються завдання, а не весь набір: томи про маніфест і HTTP для нового маршруту, том про бази даних для міграції, каталог помилок щоразу, коли йдеться про відмову, і завжди — контрольний список відповідності, бо це весь корпус у вигляді чек-листа. Скажіть моделі віддавати перевагу спостережуваному факту над власними уявленнями про те, як зазвичай працює фреймворк. Коли вони розходяться, корпус має рацію щодо цієї платформи.

Для фронтенд-розробника у вашій команді згенеруйте посібник із маніфесту замість того, щоб писати його:

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

Він перелічує кожен маршрут, який може викликати вебзастосунок, з кожною відмовою, яку той може отримати, тож він також є добрим контекстом для моделі, що пише вебзастосунок. Закомітьте його та перевіряйте в CI (безперервній інтеграції) за допомогою --check --lint, щоб він не розходився з маніфестом.

Обгортання наявного репозиторію: /plugin-create

Навичка /plugin-create перетворює наявний репозиторій або специфікацію API (інтерфейсу прикладного програмування) на плагін Nexus. Передайте їй джерело під час виклику:

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

Вона працює поетапно. Спочатку вона клонує й аналізує джерело, визначаючи мову та фреймворк, поверхню API, базу даних та її міграції, а також те, що насправді робить система. Вона виводить звіт про аналіз і обирає стратегію обгортання на основі знайденого:

Джерело Стратегія
REST (передача репрезентативного стану) API на Node.js Обгортка Express навколо наявних маршрутів
REST API на Python Обгортка FastAPI
Повностековий застосунок на Node.js і React Серверна обгортка з адаптером інтерфейсу користувача (UI)
Інструмент командного рядка Express API, який виконує команди
Бібліотека або SDK Express API, що надає доступ до її функцій
Складна платформа Один контейнер плагіна з проксі nginx перед ним

Потім він генерує бекенд і його міграції, UI, маніфест і тести. Сприймайте написане ним як сильну першу чернетку й вимагайте від неї того самого рівня, що й від усього іншого. У нашому репозиторії це означало три кроки, перш ніж хтось її переглянув. Ми підняли її маніфест до контракту v2 за допомогою create-nexus-plugin migrate --write, який додає речення закону й відмовляється вигадувати точку входу. Потім ми домоглися, щоб вона проходила create-nexus-plugin validate. І ми запускали nexus-gates, доки результат не став зеленим, що в нашому випадку означало заміну заголовків тенанта, які обгортка читала сама, на захист області дії з SDK, а також додавання трьох осей до її таблиць. Розгортання залишається за каналами випусків інсталяції; ігноруйте будь-які файли розгортання, що містяться в чернетці.

mockup-compiler: від екранів до робочого коду

Другий компілятор працює у зворотному напрямку. mockup-compiler бере макети проєкту, кількість яких може сягати тисяч екранів, і компілює їх у робочий UI, маршрути бекенду для фронтенду (BFF) і SQL, відповідність яких доведено екран за екраном гейтами з кодами виходу. Він простежує кожне намальоване слово до рядка вихідного коду, який його намалював, зіставляє кожен екран з його специфікацією, визначає зміни домену, потрібні екранам, і генерує контракти та міграції разом зі специфікацією демонстраційних даних, потрібних кожному екрану.

Два правила відрізняють його від прохання до моделі «побудувати ці екрани»:

  • Спочатку компілятор. Усе, що можна знати, обчислюється детерміновано. Модель використовується лише для типізованих прогалин: вона пише артефакт відповідно до схеми, детермінований перевіряльник приймає його або називає кожен дефект, а модель отримує щонайбільше 3 раунди виправлення на основі звіту перевіряльника.
  • Кожен гейт має негативний контроль із підкинутим дефектом. Коли verify запускає гейти проєкту для екрана, копія дерева отримує по одному підкинутому дефекту на кожен гейт, і якщо гейт пропускає свій підкинутий дефект, увесь запуск позначається як ненадійний. Гейт, який не може не пройти, перериває запуск.

Робота виконується етапами, кожен із власним режимом і власним гейтом:

Етап Режим Що доводить його гейт
Фіксація pin Малюнок ідентичний у двох збірках, з унікальними ідентифікаторами екранів
Трасування trace Кожне намальоване слово простежено рівно до одного рядка вихідного коду
Зіставлення join Кожен скомпільований слот відповідає джерелу, яке його намалювало
Специфікація spec Кожен екран має свій рядок у специфікації
Зміна домену domain Пропозиція охоплює все, що екрани читають і записують, з кодами з каталогу SDK
Контракти shape-check, emit-contracts Кожне поле, що читається, має форму, взяту з його стовпця або оголошену
SQL і сховище emit-sql, emit-store Міграція застосовується до реального Postgres, з тестами, що спочатку не проходять
Світ world Демонстраційні дані охоплюють комірки кожного екрана
Прив’язка bind Визначена частина кожної прив’язки, а решта перелічена як іменовані прогалини
Перевірка verify Власні гейти проєкту для кожного екрана, здатність кожного з яких не пройти доведено

Єдиний специфічний для проєкту вхід — це .mockup-compiler.json, адаптер. Він визначає, як сторінка позначає один екран і які ідіоми SQL і сховища генерувати. Він також називає осі тенантності, зокрема ту, з якої починається кожен ключ, і виклик авторизації, який робить кожен запис. mockup-compiler init --project <dir> створює каркас, у якому кожен незаповнений запис відхиляється з називанням. Проєкт без власного компілятора UI не може використовувати compile, baseline-check, join або world, і ці режими повідомляють про це через NO_PROJECT_COMPILER, а не збоять десь далі.

Правило, яке я взяв би з цього, навіть якщо ви ніколи його не запускатимете: правило запису, якого не зазначено в специфікації, стає чесним 501, що називає те, чого бракує, а не здогадкою. Того самого правила я хочу від будь-якої моделі, що пише код за екранами.

Атрибуція генератора

Коли інструмент створює коміт, коміт має про це повідомляти. Контракт атрибуції генератора вимагає одного рядка-трейлера в повідомленні коміту:

feat(excursions): page the nightly telemetry load

X-Generator: claude-code/<model>

Ідентифікатор — це <harness>/<model>, малими літерами, з однією скісною рискою: harness — це інструмент, який працював (claude-code), а model — модель, яку він запускав. Якщо модель змінилася під час роботи, яку завершує коміт, додайте X-Generator-Session з кожним ідентифікатором, від найстарішого, щоб роботу не було приписано тій моделі, яка випадково була активною на момент коміту. Сервіс, який обгортає чужий коміт, наприклад черга злиття, переносить ці трейлери далі.

Дві властивості роблять це корисним, а не декоративним. Твердження, якого читач не розпізнає, зберігається й показується під unregistered/<harness> з точно збереженим текстом і ніколи не відкидається. А трейлер — це самостійно заявлене походження, а не доказ: ніщо його не підписує, тому кожна поверхня, що підраховує ці твердження, показує це застереження поруч із цифрами. Граматику ідентифікаторів опубліковано разом із SDK як @adverant-nexus/plugin-sdk/schema/generator-id. Це не поле маніфесту, оскільки інструмент, що створив коміт, — це факт про коміт, а не про плагін.

Перевірка коду, написаного ШІ

Інструмент пише швидко й упевнено однаковим тоном незалежно від того, правий він чи ні. Моя процедура перегляду його змін коротка, і я не пропускаю жодного її пункту:

  1. Читайте diff, а не підсумок. Підсумок говорить, що модель мала намір зробити.
  2. Самостійно виконайте критерії готовності з чистого стану: npm ci, тести, збірку, validate і nexus-gates. Наведіть останні рядки в рецензії.
  3. Для кожного нового тесту перевірте, що він не проходить на дереві до зміни. Тест, що проходить в обох випадках, — це декорація.
  4. Шукайте обхідні шляхи. Видалений або пропущений тест, новий запис у gates/ без пояснення, значення тенанта, прочитане з тіла чи заголовка, організація за замовчуванням, catch, що поглинає відмову, запит fetch на адресу, яку маніфест не оголошує.
  5. Порівняйте маніфест з останнім випуском. Будь-яка нова область дії чи вихідна адреса є розширенням, а розширення отримують двох рецензентів.
  6. Перевірте, що тести відмов перевіряють усе тіло: error, code, resolved[], missing[] і troubleshooting[].
  7. Перевірте, що коміт містить свій трейлер X-Generator.

Гейти виявляють механічні дефекти. Вони не можуть сказати вам, чи належить маршрут до списку не-CRUD або чи заблоковано бекенд з юридичних причин, і модель теж не може; це судження залишається за вами. Якщо та сама проблема постійно повертається, виправте CLAUDE.md, а не лише код.

Шість опрацьованих промптів

Кожен запит нижче — це той, який я використовував, злегка підчищений. Після кожного: що має створити інструмент і гейт, який доводить, що він це зробив. Якщо гейт не зелений, роботу не завершено, хоч би що стверджував підсумок.

1. Нова навичка 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.

Він має створити skills/summarise-excursion/SKILL.md з name, description, allowed-tools, triggers, capabilities і version у frontmatter, своїми інструкціями в тілі та тестовими випадками, що містять підкинуту інструкцію. Доказом є npm run skill:validate skills/summarise-excursion з нулем помилок, а потім npm run skill:upload skills/summarise-excursion --dry-run, що показує план. Публікація — це подальше рішення людини, а навичка, що виконує запис, потребує двох названих затверджувачів у Enterprise.

2. Маршрут повносервісного плагіна

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.

Він має створити нумеровану міграцію, що додає стовпець до таблиці з трьома осями, обидва маршрути, оголошені в api.endpoints[] з їхніми auth і right, право в реєстрі rights, обробники за захистом області дії та тести, які перевіряють, що неавтентифікований запит і запит від неправильної організації відхиляються з повними тілами. Доказом є nexus-gates: scope-adherence, crud-adherence, api-contract, rights-register і migrations-are-scoped проходять, а вивід, що спочатку не проходить, є в журналі сеансу.

3. Лінза

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.

Він має використати nexus.create з планом, який ви підтверджуєте, а потім сформувати лінзу відносно її бази. Якщо він спробує показати те, чого база не показує, реєстр відхиляє це з LENS_CANNOT_WIDEN, і інструмент має повідомити про це, а не шукати обхідний шлях. Доказом є попередній перегляд від імені людини, а під час просування — перевірка політики пілотного гейту, що лінза лише звужує й за замовчуванням вимикає персональні поля.

4. Доменний пакет

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.

Він має створити план майстра, що перелічує репозиторій і його першу зміну, оголошені області дії та три гілки синтетичних даних, а також pack.json з його кластерами лінз і лексиконом. Нічого не створюється, доки ви не підтвердите відбиток. Доказом є проходження тестів шаблону на синтетичних гілках, а пізніше — гейт staging. Якщо пакет запитує більше, ніж його останній випуск, випуск утримується з MANIFEST_SCOPE_WIDENED, доки два рецензенти його не приймуть.

5. Конектор даних

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.

Він має створити навичку plugin_queue, у якої queueName дорівнює <plugin name>.<name> без двокрапки, timeoutMs від 1 секунди до 6 годин, воркер, що забирає з черги, міграцію для таблиці подій, вихідну адресу в маніфесті пакета (не в nexus.manifest.json, схема якого не має такого поля) та ім’я змінної облікових даних у scripts/ci/required-env. Доказом є create-nexus-plugin validate, який застосовує власні правила синхронізації реєстру щодо назв черг і тайм-аутів, а потім nexus-gates з зеленими no-credentials і no-direct-compute. Під час виконання виклик будь-якої адреси, не оголошеної в маніфесті пакета, зупиняється на межі з EGRESS_NOT_DECLARED.

6. Модуль 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.

Він має створити RouteModule з його id, featureGroup, порожнім bodies і register, який монтує маршрутизатор у застосунок хоста, з перевіркою дозволу всередині кожного обробника й тілом відмови в стандартній формі. Доказом є вихід гейту ліцензійного рядка з кодом 0, а потім проходження npm ci, npm test і npm run build у кожному складеному дереві редакції. Розділ 2.25, «Створення для кожної редакції», показує каркас модуля і те, що відхиляє гейт.

Вартість

Працювати так швидше, але це не безкоштовно. Кожен прохід агента має бюджет і годину життя, а тривалий рефакторинг означає його поновлення. Read-taint не дозволить сеансу, який прочитав один документ клієнта, нічого записувати, доки ви не підтвердите, що перші кілька разів дратує, але є абсолютно правильним. Скрипт ніколи не може змінити нічого за межами вашої пісочниці, тому автоматизація, якій потрібен доступ до staging, проходить через запит на зміну та двох рецензентів, як і всі інші. Я радше матиму ці обмеження, ніж пояснюватиму Larkfield, чому асистент надіслав їхню таблицю претензій кудись електронною поштою.