菜单
Add a method across all five AerolVM SDKs (TypeScript, Python, Go, Rust, Java) in lockstep, plus the synced docs example. Use when the user asks to "expose this in the SDK", "add an SDK method", "wire this up in the clients", or whenever a new /v1 endpoint needs SDK coverage. Proactively suggest after a new /v1 endpoint lands to keep SDK parity.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | add-sdk-method |
| description | Add a method across all five AerolVM SDKs (TypeScript, Python, Go, Rust, Java) in lockstep, plus the synced docs example. Use when the user asks to "expose this in the SDK", "add an SDK method", "wire this up in the clients", or whenever a new /v1 endpoint needs SDK coverage. Proactively suggest after a new /v1 endpoint lands to keep SDK parity. |
The SDKs are kept lockstep so the docs' five-tab examples stay accurate. Touching one SDK without the others should be rare and explained in the PR.
| SDK | Public surface | Transport (versioned) | Tests |
|---|---|---|---|
| TypeScript | sdk/typescript/src/Sandbox.ts, MicroVM.ts, types.ts | sdk/typescript/src/internal/api/v1/ | sdk/typescript/src/*.test.ts |
| Python | sdk/python/microvm/client.py, types.py | sdk/python/microvm/_internal/api/v1/ | sdk/python/tests/ |
| Go | sdk/go/pkg/microvm/, sdk/go/pkg/types/ | sdk/go/internal/apiclient/v1/ | *_test.go next to source |
| Rust | sdk/rust/src/lib.rs, types.rs | sdk/rust/src/ | inline #[cfg(test)] |
| Java | sdk/java/src/main/java/... | same tree | sdk/java/src/test/java/... |
types.*.v1/ (or equivalent) versioned module.
Use the SDK's existing versioned() helper / apiVersion option — do not
hand-build /v1/... URLs at the call site. This is what lets apiVersion
pin work without rewriting every method.Sandbox or MicroVM).(cd sdk/typescript && npm ci && npm run build && npm test)
(cd sdk/python && python -m unittest discover -s tests -v)
(cd sdk/go && go test ./...)
(cd sdk/rust && cargo test)
(cd sdk/java && mvn -B -ntp test)
CI is path-filtered (.github/workflows/test.yml) — only the SDKs whose folders changed will run on PR, so local verification of unchanged SDKs is the only way to catch parity drift before merge.
apiVersion; method signatures don't include v1.Keep the Go tree at its ~85% line-coverage bar when new or changed code lands. Finds the packages your branch touched, measures their coverage, locates the uncovered lines, and writes table-driven tests in the package's existing style. Use before opening any PR, or when the user says "add tests", "the new code has no tests", "check coverage", "bring this up to 85%", or "why did coverage drop". Proactively suggest right after a new package/driver/handler is written and before the PR goes up.
Safely modify Service.CreateSandbox or anything it transitively calls. Walks the boot path step-by-step, enforces the failure-cleanup rules, and reminds you to document boot-latency impact in the PR. Use when the user asks to "change sandbox creation", "add this to sandbox boot", "modify CreateSandbox", or any change that lands inside internal/service/service.go near the create path. Proactively suggest as soon as a change is proposed that adds DB queries, HTTP calls, file I/O, or lock acquisitions to sandbox boot.
Make changes to the TCP host-port pool or L4 bootstrap safely. Highest-risk area in the repo — PR
Add a Daytona-SDK-compatible route under /daytona/... by translating Daytona's wire shape to internal/service calls. Keeps version branching out of internal/. Use when the user asks to "support this in the Daytona facade", "add a /daytona route", "make Daytona SDK work with X", or wants to extend Daytona compatibility coverage. Proactively suggest when adding a feature that has a corresponding Daytona SDK call.
Add a new AerolVM docs page (.mdx) with synced five-language tabs and register it in the Starlight sidebar. Enforces the repo's hard rules — no raw curl, all five SDK languages, syncKey="lang" on every tab block. Use when the user asks to "add a docs page", "document this feature", "write the docs for X", or after shipping a user-facing capability that isn't documented yet. Proactively suggest after a new SDK method or top-level feature lands.
Add an E2B-SDK-compatible route under /e2b/... by mirroring the Daytona facade pattern. The /e2b package does not exist yet — copy pkg/api/daytona/ as the template. Forces the open create-idempotency design question to be answered before coding. Use when the user asks to "build the e2b facade", "add an /e2b route", "make E2B Python SDK work with X", or work on plans/sdk-compatibility/e2b/. Proactively suggest when an E2B SDK call needs server-side support.