バージョン 1.0.0-alpha.1最新
第 2.26 章
AIコーディングツールを使った構築
Claude Codeやその他のAI(人工知能)コーディングツールを使用して、Nexusの拡張機能を安全に構築する方法を解説します。IDE(統合開発環境)とWorkbenchの接続、およびプラットフォームのルールを記載したプロジェクトのCLAUDE.mdから始まり、最後に6つの実践的なプロンプトと、それぞれを検証するゲートを紹介します。
このページは英語の原文から AI によって翻訳されました。不明な点がある場合は、英語のページを正としてご参照ください。 このページを英語で読む

第2.24章「カスタムバーティカルをエンドツーエンドで構築する」のCold chainパックの大部分は、ターミナルでClaude Codeを横に開いた状態で書かれました。これは現在のCorrán Orbitalでは普通のことであり、Nexusはそれを前提に構築されています。このプラットフォームは、AI(人工知能)コーディングツールを高度なオートコンプリートとしては扱いません。特定の人物の代理として動作するエージェントとして扱い、その人物のものより常に狭いパスを与え、エージェントが行うすべての呼び出しを記録します。
本章では、そのような働き方で損害を被らずに作業する方法を説明します。まずIDE(統合開発環境)の接続から始め、次にエディター内のスキル、ツールにプラットフォームのルールを教えるプロジェクトファイル、既存の成果物をNexusのコードに変換する2つのコンパイラー、どのツールが書いたかをコミットで示す方法、そしてツールが生成したものを私がどのようにレビューしているかを取り上げます。最後に、同僚に渡したい6つのプロンプトを、それぞれ返ってくるべき結果とそれを証明するゲートとともに紹介します。
IDEとNexusの接続
各インストールには、AIコーディングツール用のWorkbenchアドレスが1つあります。これはDevelopersの下にある「IDEを接続」ページで確認でき、Claude Codeは1つのコマンドで接続します。
claude mcp add workbench --transport http <workbench-address><workbench-address>はページに表示されるアドレスで、横にコピーボタンがあります。他のツールにも同じページにそれぞれ1行のコマンドがあります。Codexにはcodex mcp add workbench --url <workbench-address>、Cursorにはインストールリンク、VS Code with Copilotには小さなJSON引数を付けたcode --add-mcpです。いずれも同じアドレスに対してMCP(Model Context Protocol)で通信します。
貼り付けるキーはありません。最初の呼び出しでブラウザーが開き、何が要求しているのか、つまりどのコンピューター上のどのツールが、誰の代理として、どのティアを求めているのかが正確に表示されます。パスキーで許可すると、それ以降ツールはデータベースのパスワードもkubeconfigも保持せず、期限のあるパスだけを保持します。このアドレスの背後で、Nexusはリクエストごとに、各ストア用の短期間の認証情報をあなたとして作成します。
組織の管理者は、マネージド設定ファイルをダウンロードして、社内のすべてのClaude Codeがこのサーバーにのみ接続するようにすることもできます。
{ "workbench": { "type": "http", "url": "<workbench-address>" } }ティアとパス
Workbenchへのサインインごとに、名前付きのティアで構成されるパスが付与されます。開発者の既定は、自分のユニットに対するObserveとSandboxです。
| ティア | 許可される操作 | 付与対象 |
|---|---|---|
| Observe | ログやメトリクスを含め自分のユニットを読み取り、マスクされたコピーにクエリを実行する | デフォルト |
| Sandbox | 自分の領域、つまり自分の開発スペースと自分のデータブランチに書き込む | デフォルト |
| Propose | 変更リクエストを作成する。レビュー後にパイプラインが適用する | 初回使用時に要求 |
| Elevate | 1つの対象に対する、時間制限付きの1回の操作。指名された人物が承認する | 人のみ。サインインだけでは付与されない |
| Break-glass | 緊急アクセス | プラットフォーム管理者のみ。承認者2名が必要 |
エージェントは常に人の代理として動作し、独立した行として表示されます。そのパスがあなたのパスより広くなることはなく、Elevateティアやマスクされていないデータが含まれることもありません。有効期間は1時間で、あなたがNexusまたはIDEで作業している間のみ更新されます。人のパスの有効期間は8時間です。そのため、一晩実行したままにしたツールは自動的に停止し、あなた自身のパスを終了するとエージェントのパスも終了します。各エージェントのパスにはモデルのコスト予算もあり、パスの付与前に見積もられ、実行中はメーターとして表示されます。
「マイアクセスパス」ページには、あなたとあなたのエージェントが保持するすべてのパスが、そのティアとこれまでのコストとともに一覧表示され、それぞれを更新、縮小、終了できます。パスを終了すると次の呼び出しは即座に停止しますが、すべての呼び出しの記録は残ります。各パスには厳格な上限もあり、当社の場合はクエリあたり200行と30秒、セッションあたり開発スペースで変更できるオブジェクト50個でした。
IDEでの最初のセッション
接続すると、Claude Codeで/mcpを実行すると、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はパスには一切含まれず、コンソールで要求します。
私の最初の本格的な質問は、テレメトリリーダーがロッテルダムで夜間に再起動した理由でした。Claude Codeはワークロードを説明し(512 MiBの上限に対するメモリ不足による再起動が2回)、ログ(組織はゲートウェイによって設定され、個人データは編集済み)とメモリのメトリクスにクエリを実行し、夜間のロードが一晩分の測定値を1つのバッチに取り込んでいたことを突き止めました。次に、半分はテストとして、そのサービスが使用するデータベースのパスワードを尋ねました。WorkbenchはSECRET_NEVER_SHOWNで拒否しました。Workbenchは、誰に対してもSecretの名前と末尾4文字だけを表示し、値は決して表示しません。アシスタントの返答は適切なものでした。実行する各クエリがそれぞれ専用の短期間の認証情報、つまりそのリクエストのためだけに作成された読み取り専用ロールを取得するため、パスワードは必要ないというものです。
計画してから適用
何かを変更するツールはすべて、まず計画を表示します。計画は件数とフィンガープリントを含む差分であり、適用ではその計画だけが厳密に実行されます。
自分の開発スペース内では、適用は即座に実行されます。その外では、人がIDEで確認する必要があり、変更はパイプラインに送られ、レビュー後に適用されます。このことから2つの拒否が生じ、私はどちらにも引っかかりました。
- cronジョブ内の
claude -pなど、キーボードの前に誰もいないスクリプトからは確認ボックスを表示する手段がないため、サンドボックス外の変更はCONFIRMATION_UNAVAILABLEで拒否されます。何も実行されません。対話型セッションで実行してください。 - このセッションで作成していない計画、または変更された計画を指定した適用は、何も実行される前に
PLAN_FINGERPRINT_MISMATCHで拒否されます。もう一度計画してください。
読み取り汚染
顧客のコンテンツには、アシスタント向けの指示が隠されている場合があります。そのため、セッションがそれを読み取ると、人が1回の書き込みを確認するか新しいセッションを開始するまで、そのセッションは書き込み用およびNexus外部へのアクセス用のツールを失います。
私がこれに遭遇したのは、「アシスタント」宛ての段落を含むクレーム文書でした。その段落は、クレームテーブルを外部のアドレスにコピーするよう求めていました。Claude Codeはそれを無視し、無視したことを伝えました。その後、私がブランチのグラフに逸脱を追加するよう依頼すると、書き込みはSESSION_TAINTEDで拒否されました。計画を読んだうえでその1回の書き込みを確認するか、その文書を読んでいない新しいセッションを開始することができました。ログとメトリクスはセッションを汚染しません。文書、チケット、メール、グラフのソーステキストはすべて汚染します。隠されたテキストは、その文言を含まずに、コンテンツ内で見つかった指示として私のアクティビティ記録に計上されました。
他の組織
入力した内容が他の組織のデータに到達することはありません。要求すると、すべてのストアがTENANT_BOUNDARYで拒否します。ログクエリに紛れ込んだ組織の値は、ゲートウェイによってあなた自身のものに置き換えられます。これは権限が欠けているのではありません。経路上のすべての層があなたの組織に囲い込まれているため、あなたの立場からそれを付与できる人はおらず、プラットフォーム管理者のアクセス権も役に立ちません。2つの組織がデータの共有に合意した場合、それは両者の間で設定される合意であり、IDEセッションで行うものではありません。
IDEとClaude Code内のスキル
Skills EngineのスキルはSKILL.mdフォルダーであり、Claude Codeも同じフォルダーを読み取ります。ライブラリはあなた自身のホームディレクトリ内の~/.claude/skillsに読み取り専用で同期され、その横の~/.claude/skills/draftsにあなたの下書きが置かれます。そのため、組織が公開したスキルはコピーすることなくエディターで利用でき、ローカルで書いたものは、コンソールで書いたものと同じテストと承認を経て戻されます。
ターミナルから、スキルを含むリポジトリで、2つのnpmスクリプトによりスキルをエディターからライブラリに送ります。
npm run skill:validate skills/check-a-customs-filing
npm run skill:upload skills/check-a-customs-filingValidateは形式とテストケースを確認します。Uploadは下書きを作成し、内容がすでに公開されているバージョンと一致する場合は、代わりにそのバージョンを返します(CONTENT_HASH_ALREADY_PUBLISHED)。Publishは、スキルが承認を必要とする場合に承認待ちで保留され、自分の変更を承認することはできません。モデルルートなしでスクリプトから開始された実行はSKILLS_ENGINE_BINDING_MISSINGで拒否されます。ルートはディスパッチャーが選択し、エンジンはそれが渡されたことを確認するのであって、推測することはありません。第2.24章「カスタムバーティカルをエンドツーエンドで構築する」では、同じスクリプトをプロジェクト全体の中で示しています。
エージェントとClaude Codeも、合計13個のツールを通じてMCP経由でライブラリにアクセスします。その中で、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>.このようなファイルを機能させる要素は3つあります。すべてのルールがそれを強制する仕組みを明示しているため、モデルはパイプラインと同じ基準で自分の作業を確認できます。完了の定義は感覚ではなく、終了コード付きのコマンドの一覧です。そして、テストの削除や、欠落した組織をプレースホルダーで既定値にするなど、ビルドが失敗したときにモデルが手を伸ばしがちな特定の近道を禁止しています。
コンテキストとしての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このガイドには、Webアプリが呼び出せるすべてのルートと、返される可能性のあるすべての拒否が一覧表示されるため、Webアプリを書くモデルにとっても優れたコンテキストになります。コミットし、マニフェストと乖離しないようにCI(継続的インテグレーション)で--check --lintを使ってチェックしてください。
既存リポジトリのラップ:/plugin-create
/plugin-createスキルは、既存のリポジトリまたはAPI(アプリケーションプログラミングインターフェイス)仕様をNexusプラグインに変換します。呼び出す際にソースを渡してください。
/plugin-create https://github.com/<owner>/<repo>
このスキルはフェーズごとに動作します。まずソースをクローンして分析し、言語とフレームワーク、APIの範囲、データベースとそのマイグレーション、そしてそれが実際に何をするのかを把握します。分析レポートを出力し、見つかった内容に基づいてラッピング戦略を選択します。
| ソース | 戦略 |
|---|---|
| Node.jsのREST(Representational State Transfer)API | 既存のルートをExpressでラップ |
| PythonのREST API | FastAPIでラップ |
| Node.jsとReactによるフルスタック | ユーザーインターフェース(UI)アダプターを備えたバックエンドラッパー |
| コマンドラインツール | コマンドを実行する Express API |
| ライブラリまたは SDK | その関数を公開する Express API |
| 複雑なプラットフォーム | 前段に nginx プロキシを置いた 1 つのプラグインコンテナー |
次に、バックエンドとそのマイグレーション、UI、マニフェスト、テストを生成します。生成されたものは質の高い初稿として扱い、他のあらゆるものと同じ基準で評価してください。私たちのリポジトリでは、誰かがレビューする前に 3 つのステップを踏みました。まず create-nexus-plugin migrate --write でマニフェストを v2 コントラクトに引き上げました。これにより法的文言が追加され、エントリポイントを勝手に作ることは拒否されます。次に create-nexus-plugin validate に合格させました。そして nexus-gates がグリーンになるまで実行しました。私たちの場合、これはラッパーが自ら読み取っていたテナントヘッダーを SDK のスコープガードに置き換え、テーブルに 3 つの軸を追加することを意味しました。デプロイはインストール環境のリリースチャネルに委ねられます。初稿に含まれるデプロイ用ファイルは無視してください。
mockup-compiler:画面から動作するコードへ
2 つ目のコンパイラーは逆方向に動作します。mockup-compiler はプロジェクトのモックアップ(数千画面に及ぶこともあります)を受け取り、動作する UI、BFF(Backend for Frontend)ルート、SQL にコンパイルし、終了コードを持つゲートによって画面ごとに忠実であることを証明します。描画されたすべての語をそれを描画したソース行まで追跡し、各画面を仕様と結び付け、画面が必要とするドメイン変更を導き出し、コントラクトとマイグレーションを、すべての画面が必要とするデモデータの仕様とともに出力します。
モデルに「これらの画面を作って」と頼むこととの違いは、次の 2 つのルールにあります。
- コンパイラー優先。知り得ることはすべて決定論的に計算されます。モデルは型付きの穴にのみ使用されます。モデルはスキーマに沿って成果物を書き、決定論的なチェッカーがそれを受け入れるか、すべての欠陥を指摘します。モデルにはチェッカーのレポートを入力として、最大 3 回の修正ラウンドが与えられます。
- すべてのゲートには、意図的に欠陥を仕込んだネガティブコントロールがあります。
verifyがある画面についてプロジェクトのゲートを実行すると、ツリーのコピーにゲートごとに 1 つの欠陥が仕込まれ、いずれかのゲートが仕込まれた欠陥を通過させた場合、実行全体が信頼できないものとしてマークされます。失敗し得ないゲートは実行を中止させます。
作業は段階的に進み、各段階には独自のモードと独自のゲートがあります。
| 段階 | モード | ゲートが証明する内容 |
|---|---|---|
| 固定 | pin |
2 回のビルド間で描画が同一であり、画面 ID が一意であること |
| 追跡 | trace |
描画されたすべての語が、ちょうど 1 つのソース行まで追跡されること |
| 結合 | join |
コンパイルされたすべてのスロットが、それを描画したソースと一致すること |
| 仕様 | spec |
すべての画面に仕様の行があること |
| ドメイン変更 | domain |
提案が、画面が読み書きするすべてを SDK カタログのコードで網羅していること |
| コントラクト | shape-check, emit-contracts |
読み取られるすべてのフィールドに、列から取得したか宣言された形状があること |
| SQL とストア | emit-sql, emit-store |
マイグレーションが実際の Postgres に適用でき、先に失敗するテストがあること |
| ワールド | world |
デモデータがすべての画面のセルを網羅していること |
| バインド | bind |
各バインディングの確定部分と、残りを名前付きの穴として列挙したもの |
| 検証 | verify |
画面ごとのプロジェクト独自のゲートで、それぞれが失敗し得ることが証明されていること |
プロジェクト固有の入力はアダプターである .mockup-compiler.json だけです。これは、ページが 1 つの画面をどのように示すか、どの SQL とストアのイディオムを出力するかを定めます。また、テナンシーの軸と、そのうちすべてのキーの先頭に来る軸、そしてすべての書き込みが行う認可呼び出しも指定します。mockup-compiler init --project <dir> はスケルトンを書き出し、その中の未記入の項目はすべて名前を挙げて拒否されます。独自の UI コンパイラーを持たないプロジェクトは compile、baseline-check、join、world を使用できず、これらのモードは後段で失敗するのではなく、NO_PROJECT_COMPILER によってその旨を示します。
たとえ実行することがなくても、私がここから学ぶべきだと考えるルールがあります。仕様に記載されていない書き込みルールは、推測ではなく、不足しているものを明示する正直な 501 になる、ということです。これは、画面に対してコードを書くあらゆるモデルに私が求めるのと同じルールです。
ジェネレーターの帰属情報
ツールがコミットを書いた場合、コミットにはその旨を記すべきです。生成元帰属コントラクトでは、コミットメッセージに次の 1 行のトレーラーを求めます。
feat(excursions): page the nightly telemetry load
X-Generator: claude-code/<model>
識別子は <harness>/<model> で、小文字、スラッシュは 1 つです。ハーネスは実行したツール(claude-code)、モデルはそのツールが実行していたモデルです。コミットが完了させる作業の途中でモデルが変わった場合は、各識別子を古い順に記した X-Generator-Session を追加してください。これにより、作業がコミット時にたまたま有効だったモデルのせいにされることを防げます。マージキューのように他者のコミットをラップするサービスは、これらのトレーラーを引き継ぎます。
これを装飾ではなく有用なものにする性質が 2 つあります。読み手が認識できない申告は破棄されず、正確なテキストを保ったまま unregistered/<harness> の下に表示されます。そして、トレーラーは自己申告による来歴であり、証明ではありません。何も署名しないため、これらの申告を集計するすべての画面では、数値の横にその注意書きが表示されます。識別子の文法は SDK とともに @adverant-nexus/plugin-sdk/schema/generator-id として公開されています。これはマニフェストのフィールドではありません。コミットを書いたツールはコミットに関する事実であり、プラグインに関する事実ではないからです。
AIが作成したコードのレビュー
このツールは、正しくても間違っていても、同じ口調で素早く自信を持って書きます。その変更に対する私のレビュー手順は短く、どれも省略しません。
- 要約ではなく差分を読んでください。要約はモデルが意図したことを述べているにすぎません。
- 完了の定義をクリーンな状態からご自身で実行してください。
npm ci、テスト、ビルド、validate、nexus-gatesです。最後の数行をレビューに引用してください。 - 新しいテストごとに、変更前のツリーで失敗することを確認してください。どちらでも通るテストは飾りにすぎません。
- 近道を探してください。削除またはスキップされたテスト、理由のない
gates/への新規項目、本文やヘッダーから読み取られたテナント値、デフォルトの組織、拒否を握りつぶすcatch、マニフェストで宣言されていないアドレスへの fetch などです。 - マニフェストを前回のリリースと比較してください。新しいスコープや送信先アドレスは権限の拡大であり、拡大には 2 名のレビュー担当者が必要です。
- 拒否のテストが本文全体、すなわち
error、code、resolved[]、missing[]、troubleshooting[]を検証していることを確認してください。 - コミットに
X-Generatorトレーラーが付いていることを確認してください。
ゲートは機械的な欠陥を検出します。しかし、あるルートが非 CRUD リストに属するかどうか、あるバックエンドが法的にブロックされているかどうかは判断できず、モデルにも判断できません。その判断はあなたに委ねられます。同じ問題が繰り返し発生する場合は、コードだけでなく CLAUDE.md を修正してください。
6つの実践的なプロンプト
以下の各プロンプトは、私が実際に使用したものを少し整えたものです。それぞれの後に、ツールが生成すべきものと、それを証明するゲートを示します。ゲートがグリーンでなければ、要約が何と言おうと作業は完了していません。
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.
フロントマターに name、description、allowed-tools、triggers、capabilities、version を含み、本文に指示を記し、仕込まれた指示を含むテストケースを備えた skills/summarise-excursion/SKILL.md を生成すべきです。証明は、エラー 0 件の npm run skill:validate skills/summarise-excursion と、その後に計画を示す npm run skill:upload skills/summarise-excursion --dry-run です。公開はその後で人が判断することであり、書き込みを行うスキルには、Enterprise では名前の明示された承認者が 2 名必要です。
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.
3 つの軸を持つテーブルに列を追加する番号付きマイグレーション、auth と right を伴って api.endpoints[] で宣言された両ルート、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.
リポジトリとその最初の変更、宣言されたスコープ、3 つの合成データブランチを列挙したウィザードの計画と、レンズクラスターと用語集を含む pack.json を生成すべきです。フィンガープリントを確認するまで何も作成されません。証明は、合成ブランチでテンプレートのテストが合格すること、そしてその後のステージングゲートです。パックが前回のリリースより多くを要求する場合、2 名のレビュー担当者が承認するまで、リリースは 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.
queueName がコロンを含まない <plugin name>.<name> で、timeoutMs が 1 秒から 6 時間の間である plugin_queue スキル、キューを取得するワーカー、イベントテーブルのマイグレーション、パックのマニフェスト内の送信先アドレス(nexus.manifest.json ではありません。そのスキーマにはそのようなフィールドはありません)、そして scripts/ci/required-env 内の認証情報の変数名を生成すべきです。証明は、キュー名とタイムアウトについてレジストリ同期自体のルールを適用する create-nexus-plugin validate と、その後 no-credentials と no-direct-compute がグリーンの nexus-gates です。実行時には、パックのマニフェストで宣言されていないアドレスへの呼び出しは、エッジで 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.
id、featureGroup、空の bodies、ホストのアプリにルーターをマウントする register を備え、各ハンドラー内に権限チェックがあり、拒否の本文が標準の形式である RouteModule を生成すべきです。証明は、ライセンス行ゲートが 0 で終了し、その後、構成された各エディションのツリーで npm ci、npm test、npm run build が合格することです。第 2.25 章「エディションごとのビルド」では、モジュールのスケルトンとゲートが拒否する内容を示しています。
コスト
この方法で作業すると速くなりますが、代償がないわけではありません。各エージェントのパスには予算と 1 時間の有効期間があり、長いリファクタリングでは更新が必要です。リードテイントにより、顧客文書を 1 つ読んだセッションは、あなたが確認するまで何も書き込めなくなります。最初の数回は煩わしく感じますが、まさに正しい動作です。スクリプトはサンドボックスの外にあるものを一切変更できないため、ステージングに到達する必要がある自動化は、他のすべての人と同様に、変更リクエストと 2 名のレビュー担当者を経由します。アシスタントが Larkfield の請求テーブルをどこかにメールで送った理由を説明するより、こうした制限があるほうがずっとよいと私は考えます。




