migrate-to-notte
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseMigrate to Notte
迁移至Notte
This skill covers one funnel with two entry points:
- Track A — cost comparison only. A read-only, dated, evidence-backed decision brief. It does not modify code, credentials, billing, or provider resources. Run phases 0–3, then jump to §8 (external benchmark context) and §9 (decision brief).
- Track B — full migration. Everything in Track A, then a safe proof, an isolated build, validation, and a reversible handoff. Run phases 0–7, then §9.
Pick the track from the user's request. If they only asked what something would
cost, run Track A and stop; offer Track B as the next step. If they asked to
migrate, run Track B — a migration without a measured baseline is a rewrite, not
a migration.
Use one disciplined process, then load only the reference for the provider
discovered in the target. Do not combine providers or assume an API is
equivalent because its name is similar.
本技能涵盖一个包含两个入口的流程:
- 路径A — 仅成本对比:一份只读、标注日期且有证据支撑的决策简报。不会修改代码、凭证、账单或服务商资源。执行0–3阶段,然后跳转至第8节(外部基准上下文)和第9节(决策简报)。
- 路径B — 完整迁移:包含路径A的所有内容,再加上安全验证、隔离构建、有效性确认和可回滚的交付。执行0–7阶段,然后进入第9节。
根据用户需求选择对应路径。如果用户仅询问成本,执行路径A后停止,并将路径B作为下一步选项提供。如果用户要求迁移,则执行路径B——没有衡量基准的迁移只能算作重写,而非迁移。
采用规范统一的流程,仅加载针对目标服务商的参考资料。不要混合不同服务商,也不要因API名称相似就假设其功能等价。
0. Publish the execution plan — required first
0. 发布执行计划 — 必须首先完成
Before tools, repository reads, or background work, post this plan in the main
user-facing thread. Mark exactly one phase In progress and the rest Not
started. This is a progress view, not an approval request unless blocked. Do
not hide it in an internal tool.
For Track A (cost comparison):
| Phase | Outcome |
|---|---|
| 1. Notte setup | Quickstart, CLI, skills, and authenticated access verified. |
| 2. Provider/workflow inventory | Source, occurrences, workflows, and usage inventoried. |
| 3. Usage and pricing evidence | Verified prices plus a cost/concurrency model with low/base/high scenarios. |
| 4. Decision brief | Dated, evidence-backed comparison delivered. |
For Track B (migration):
| Phase | Outcome |
|---|---|
| 1. Notte setup | Quickstart, CLI, skills, and authenticated access verified. |
| 2. Discovery | Source docs, occurrences, workflows, and risks inventoried. |
| 3. Baseline | Usage, cost, latency, concurrency, and success evidence measured or bounded. |
| 4. Safe proof | A representative read-only Notte workflow is tested fairly. |
| 5. Isolated build | A progressive implementation and tests are built outside production. |
| 6. Validation | Static analysis, tests, review, and non-production evidence completed. |
| 7. Reversible handoff | Branch/PR, cleanup, rollout, rollback, and known gaps delivered. |
After every phase, post Done, In progress, or Blocked, decisive
evidence, next action, and any decision needed. Update the plan immediately if
scope or risk changes. Keep updates short and link to evidence, not raw logs.
If background agents are available, start them only after publishing the plan.
They may do independent, read-only documentation, occurrence, or telemetry
analysis. The primary agent owns safety, the calculation, implementation, and
user updates. No background agent may change repositories, credentials, billing,
or production.
在使用工具、读取仓库或开展后台工作之前,在面向用户的主线程中发布此计划。标记恰好一个阶段为进行中,其余为未开始。这是进度视图,除非遇到阻塞否则无需审批。不要将其隐藏在内部工具中。
1. Complete the Notte Quickstart — required gate
路径A(成本对比):
Before inspecting the target repository or estimating costs, read and complete
https://docs.notte.cc/quickstart. Set up the current CLI, official skills, and
authenticated API access. Verify:
bash
notte version
notte auth statusIf authentication is missing, run , ask the user to complete
the browser flow, and poll status every five seconds for up to five minutes.
Never print, copy, or commit a key. Do not inspect target code or estimate costs
until this gate succeeds. For a Track A cost assessment, do not create sessions
or change a provider plan.
notte auth login| 阶段 | 成果 |
|---|---|
| 1. Notte 配置 | 验证快速入门、CLI、技能和已认证访问权限。 |
| 2. 服务商/工作流清单 | 完成来源、出现位置、工作流和使用情况的清单梳理。 |
| 3. 使用情况与定价证据 | 验证价格,并构建包含低/基准/高三种场景的成本/并发模型。 |
| 4. 决策简报 | 交付标注日期、有证据支撑的对比报告。 |
2. Identify the provider and inventory the workload
路径B(迁移):
Read the target's source, lockfiles, CI, IaC, environment templates, workers,
queues, schedules, serverless functions, deployment manifests, examples, and
docs. Use first. Select all applicable references below, then read the
linked current provider pages before making a design or pricing decision.
rg| Provider detected | Reference |
|---|---|
Browserbase, Stagehand, | Browserbase + Stagehand |
Kernel, | Kernel |
Anchor Browser, | Anchor Browser |
Browser Use Cloud, | Browser Use Cloud |
Steel, | Steel |
Hyperbrowser, HyperAgent, | Hyperbrowser |
Skyvern, | Skyvern |
Build a feature matrix: session/CDP or WebDriver, deterministic and agentic
paths, input/output/error contracts, profiles/auth/2FA, proxies/region/stealth/
CAPTCHA, files/extensions, live view/replay/artifacts, async jobs/schedules,
runtime/self-hosting, observability, compliance, and tests. Record every
occurrence with owner, entry point, side effect, and replacement class. Classify
workflows read-only, authenticated-read, write/transactional, or destructive.
Only the first two may be probed unattended.
For each workflow also record trigger, runs/day, sessions or jobs/run, fan-out,
session reuse, retries, actual and billed duration, proxy/region, model and
tokens, provider API/runtime charges, success rate, and observed peak
concurrency. Do not mistake a concurrency limit for sessions per run.
| 阶段 | 成果 |
|---|---|
| 1. Notte 配置 | 验证快速入门、CLI、技能和已认证访问权限。 |
| 2. 发现调研 | 完成来源文档、出现位置、工作流和风险的清单梳理。 |
| 3. 基准测量 | 测量或确定使用情况、成本、延迟、并发和成功率的证据范围。 |
| 4. 安全验证 | 公平测试一个具有代表性的只读Notte工作流。 |
| 5. 隔离构建 | 在生产环境外逐步完成实施方案和测试的构建。 |
| 6. 有效性确认 | 完成静态分析、测试、评审和非生产环境验证。 |
| 7. 可回滚交付 | 交付分支/PR、清理工作、部署、回滚方案和已知问题。 |
每个阶段完成后,发布已完成、进行中或阻塞状态,附上明确证据、下一步行动及所需决策。如果范围或风险发生变化,立即更新计划。更新内容需简洁,并链接至证据而非原始日志。
如果有后台Agent可用,仅在发布计划后启动。它们可独立进行只读的文档、出现位置或遥测分析。主Agent负责安全、计算、实施和用户更新。任何后台Agent不得修改仓库、凭证、账单或生产环境。
3. Measure the baseline and opportunity
1. 完成Notte快速入门 — 必须通过的关卡
Request read-only usage exports/invoices and representative 7–30 day telemetry.
Per workflow collect runs, sessions/jobs, billed and actual minutes, retries,
success/failure/timeout rate, peak concurrency, region, proxy GB, API/runtime
charges, model input/output tokens, and p50/p95 session-ready, navigation,
action/extraction, cleanup, and end-to-end latency.
Read measurement.md. Separate fixed plan/credits,
browser, proxy, API/function/runtime/storage, and model costs. Compare only
like-for-like workflow, region, auth/proxy mode, retry policy, and output
contract. Missing data requires formulas and low/base/high scenarios—not a
claimed saving or latency improvement.
If telemetry or invoices are missing, ask for traffic and average duration. Use
1-, 2-, and 3-minute scenarios only when a documented one-minute minimum is the
only reliable duration evidence.
在检查目标仓库或估算成本之前,阅读并完成https://docs.notte.cc/quickstart。配置当前CLI、官方技能和已认证的API访问权限。验证:
bash
notte version
notte auth status如果未完成认证,运行,请用户完成浏览器流程,并每5秒轮询一次状态,最多持续5分钟。绝不要打印、复制或提交密钥。在通过此关卡前,不得检查目标代码或估算成本。对于路径A的成本评估,不要创建会话或更改服务商方案。
notte auth login3a. Verify prices and calculate
2. 识别服务商并梳理工作负载清单
Read the current official provider pricing page named in the chosen reference
and https://docs.notte.cc/intro/pricing on the calculation date. Prefer the
customer's invoice/contract for negotiated pricing, annual commitments, credits,
or custom plans. Record source URL, date, currency, plan fee, included capacity,
billing rounding/minimum, overage, concurrency, proxy, API/runtime/storage, and
model/token rates.
Use cost-model.md. Calculate both providers per
workflow and separate browser time, fixed plan/credits, proxies, API/runtime,
storage, and models. Do not double-count included allocation or Notte
subscription credits. Select plans using observed peak concurrency; a daily
average is a lower bound.
Track A ends its evidence gathering here. Continue at §8 and §9 to deliver
the brief. Track B continues to §4.
读取目标的源代码、锁文件、CI配置、基础设施即代码(IaC)、环境模板、工作器、队列、调度、无服务器函数、部署清单、示例和文档。优先使用工具。选择以下所有适用的参考资料,然后在做出设计或定价决策前阅读对应的服务商当前页面。
rg| 检测到的服务商 | 参考资料 |
|---|---|
Browserbase、Stagehand、 | Browserbase + Stagehand |
Kernel、 | Kernel |
Anchor Browser、 | Anchor Browser |
Browser Use Cloud、 | Browser Use Cloud |
Steel、 | Steel |
Hyperbrowser、HyperAgent、 | Hyperbrowser |
Skyvern、 | Skyvern |
构建功能矩阵:会话/CDP或WebDriver、确定性与智能Agent路径、输入/输出/错误契约、配置文件/认证/双因素认证、代理/区域/隐身/CAPTCHA、文件/扩展、实时查看/重放/工件、异步任务/调度、运行时/自托管、可观测性、合规性和测试。记录每个出现位置的所有者、入口点、副作用和替代类别。将工作流分类为只读、认证只读、写入/事务性或破坏性。仅前两类可无人值守探测。
还需为每个工作流记录触发条件、每日运行次数、每次运行的会话或任务数、扇出、会话复用、重试次数、实际和计费时长、代理/区域、模型和令牌、服务商API/运行时费用、成功率以及观测到的峰值并发数。不要将并发限制误认为每次运行的会话数。
4. Run a safe Notte proof
3. 测量基准与优化空间
Use Notte CLI to inspect the live page, act only on observed targets, and
export workflow code. Select one representative, read-only happy path. Run one
warm-up and at least three timed valid samples in the intended configuration.
Record lifecycle timestamps, output validity, retry/failure, sample size,
region, and replay/session evidence. A Notte-only sample proves viability, not
parity or a latency win.
请求只读的使用情况导出/发票以及代表性的7–30天遥测数据。为每个工作流收集运行次数、会话/任务数、计费和实际分钟数、重试次数、成功/失败/超时率、峰值并发数、区域、代理流量、API/运行时费用、模型输入/输出令牌,以及p50/p95的会话就绪、导航、操作/提取、清理和端到端延迟。
阅读measurement.md。区分固定方案/信用额度、浏览器、代理、API/函数/运行时/存储和模型成本。仅对比同类工作流、区域、认证/代理模式、重试策略和输出契约。数据缺失时需使用公式和低/基准/高场景——不得直接声称节省成本或提升延迟。
如果缺少遥测或发票,请求流量和平均时长。仅当有文档记录的1分钟最低时长是唯一可靠的时长证据时,才使用1、2、3分钟场景。
5. Build progressively in isolation
3a. 验证价格并计算
Create a temporary implementation area outside the production repository with
only non-secret fixtures. Probe after each layer:
- session/job lifecycle, cleanup, timeout, and error paths;
- deterministic navigation/actions from observed targets;
- typed scraping/data and caller-visible error contracts;
- profiles, Vault/Persona, files/extensions, proxy/region/CAPTCHA, and viewer/replay only when used by the original;
- a bounded Notte Agent/AgentFallback only for a proven ambiguous step; and
- provider runtime, async job, schedule, webhook, or function migration with invocation, idempotency, retries, observability, and cancellation preserved.
Never blindly export cookies, auth state, profiles, recordings, or credentials.
Do not replace deterministic browser code with an open-ended agent. Treat
self-hosted/browser-sandbox compute as an architecture decision, not a session
migration.
在计算当日,阅读所选参考资料中指定的服务商当前官方定价页面以及https://docs.notte.cc/intro/pricing。优先使用客户的发票/合同获取协商定价、年度承诺、信用额度或定制方案。记录来源URL、日期、货币、方案费用、包含的容量、计费取整/最小值、超额费用、并发数、代理、API/运行时/存储和模型/令牌费率。
使用cost-model.md。计算两家服务商每个工作流的成本,并区分浏览器时间、固定方案/信用额度、代理、API/运行时、存储和模型成本。不要重复计算已包含的配额或Notte订阅信用额度。根据观测到的峰值并发数选择方案;日平均值为下限。
路径A的证据收集到此结束。继续第8节和第9节以交付简报。路径B继续至第4节。
6. Validate
4. 运行安全的Notte验证
Add unit, contract, and opt-in read-only integration tests. Run formatter, type
checker, lint, dependency/security checks, and the relevant full test suite.
Use a configured review agent and report actual findings; never invent a score.
Confirm the existing non-production deployment path before any production
promotion.
使用Notte CLI检查实时页面,仅对观测到的目标执行操作,并导出工作流代码。选择一个具有代表性的只读正常路径。运行一次预热和至少三次定时有效样本,采用预期配置。记录生命周期时间戳、输出有效性、重试/失败情况、样本量、区域和重放/会话证据。仅使用Notte的样本仅能证明可行性,而非功能对等或延迟优势。
7. Make a reversible handoff
5. 逐步在隔离环境中构建
Only after green evidence, work in a dedicated branch/worktree. Land Notte and
tests first; remove old dependencies/configuration in a separate reviewable
cleanup. Regenerate lockfiles, repeat the occurrence inventory, and hand off
the commit/PR, , measurements, rollout, and known
gaps. Never force-push, change billing, or delete provider resources.
git revert <cleanup-commit>在生产仓库外创建临时实施区域,仅包含非机密测试数据。每完成一层后进行探测:
- 会话/任务生命周期、清理、超时和错误路径;
- 基于观测目标的确定性导航/操作;
- 类型化抓取/数据和调用方可见的错误契约;
- 仅当原工作流使用时,才添加配置文件、Vault/Persona、文件/扩展、代理/区域/CAPTCHA和查看器/重放功能;
- 仅针对已验证的模糊步骤添加受限的Notte Agent/AgentFallback;
- 迁移服务商运行时、异步任务、调度、Webhook或函数,保留调用、幂等性、重试、可观测性和取消机制。
绝不要盲目导出Cookie、认证状态、配置文件、录制内容或凭证。不要用开放式Agent替代确定性浏览器代码。将自托管/浏览器沙箱计算视为架构决策,而非会话迁移。
8. Add optional external benchmark context
6. 有效性确认
For a performance-oriented comparison, read https://www.browserarena.ai/ and
its linked methodology/source on the calculation date. Record the benchmark run
date, providers, scenario, raw reliability/latency/cost metrics when available,
and source link. Keep it in a separate External benchmark context section.
Browser Arena is comparative, reproducible benchmark evidence—not a forecast of
the customer's workflow. Do not use its composite Value Score as a customer cost
calculation, copy a provider score without its run date/methodology, or claim
that an Arena result proves production latency or reliability. Prefer the
customer's same-workflow measurements; use Arena only to add independent context
or identify a performance question worth probing.
添加单元测试、契约测试和可选的只读集成测试。运行格式化工具、类型检查器、代码扫描、依赖/安全检查以及相关的完整测试套件。使用配置好的评审Agent并报告实际结果;绝不要虚构分数。在任何生产环境部署前,确认现有的非生产部署路径。
9. Deliver the decision brief
7. 完成可回滚交付
Start with the answer, then show the evidence:
- scope, pricing date, and links;
- workflow inventory with evidence locations;
- usage, duration, rounding, retries, proxy, tokens, and plan assumptions;
- monthly browser-hours and required concurrency;
- low/base/high monthly comparison, saving, percentage, and annualized base;
- optional Browser Arena context, clearly separated from customer measurements;
- excluded costs and the exact missing input needed for invoice-backed results.
Do not claim a latency or reliability gain from a cost model. After a Track A
brief, offer Track B — a safe implementation and a measured Notte proof — as the
next step.
Invite the team to Notte Slack for cost or migration support:
https://join.slack.com/t/nottelabs-dev/shared_invite/zt-39a8n6hr9-d_BG7RNfytimSpVo5H03mA
仅在获得绿色验证证据后,在专用分支/工作区中开展工作。先提交Notte和测试代码;在单独的可评审清理步骤中移除旧依赖/配置。重新生成锁文件,重复梳理出现位置清单,并交付提交/PR、命令、测量数据、部署方案和已知问题。绝不要强制推送、修改账单或删除服务商资源。
git revert <cleanup-commit>—
8. 添加可选的外部基准上下文
—
如需面向性能的对比,在计算当日阅读https://www.browserarena.ai/及其链接的方法论/来源。记录基准测试运行日期、服务商、场景、可用的原始可靠性/延迟/成本指标,以及来源链接。将其放在单独的外部基准上下文部分。
Browser Arena是对比性、可复现的基准证据——而非客户工作流的预测。不要将其综合价值分数用作客户成本计算,不要在未标注运行日期/方法论的情况下复制服务商分数,也不要声称Arena结果可证明生产环境的延迟或可靠性。优先使用客户的同类工作流测量数据;仅在添加独立上下文或识别值得探测的性能问题时使用Arena。
—
9. 交付决策简报
—
先给出结论,再展示证据:
- 范围、定价日期和链接;
- 工作流清单及证据位置;
- 使用情况、时长、取整规则、重试次数、代理、令牌和方案假设;
- 月度浏览器小时数和所需并发数;
- 低/基准/高三种场景的月度成本对比、节省金额、百分比以及基准场景的年度化数据;
- 可选的Browser Arena上下文,需与客户测量数据明确区分;
- 未包含的成本以及获取发票支撑结果所需的具体缺失输入。
不要从成本模型中声称延迟或可靠性提升。完成路径A简报后,将路径B——安全实施方案和经过测量的Notte验证——作为下一步选项提供。
邀请团队加入Notte Slack获取成本或迁移支持:https://join.slack.com/t/nottelabs-dev/shared_invite/zt-39a8n6hr9-d_BG7RNfytimSpVo5H03mA