agent-qa-plugin-kernel Skill
在配置 agent-qa 网页测试通过 Kernel 插件运行于 Kernel 云浏览器时使用,或在 Kernel 远程连接被拒绝时使用。
安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。
技能指令原文(SKILL.md)
Kernel remotes for agent-qa
The Kernel plugin gives an agent-qa web test a Kernel cloud browser. Before the test connects it
creates a browser, or takes one from a browser pool. After the test it deletes the browser, or
returns it to the pool. Kernel runs Chromium only.
Declare the plugin and a remote
plugins:
- name: kernel
package: "@vostride/agent-qa-plugin-kernel"
options:
apiKey: "{{secret:KERNEL_API_KEY}}"
registry:
remotes:
- name: kernel
plugin: kernel
settings:
headless: true
timeoutSeconds: 60
- The
pluginsentry holds the account:apiKey, andapiUrl, which defaults to Kernel's API.
Write the key as a {{secret:}} reference to a name in the file workspace.secretsFile
names. Never write the key itself in the config.
- The remote holds one place:
pluginnames thepluginsentry, andsettingshold that place's
Kernel settings.
use.browser.remote: kernelin the config, a suite or a test runs the test there.- Add the plugin with
npx agent-qa plugins add @vostride/agent-qa-plugin-kernel: it pins the
package at the project's agent-qa version and writes the plugins entry. agent-qa plugins list
prints that line when the package is missing or the version differs.
Settings
headless(defaulttrue):falsegives a headful browser.timeoutSeconds(default60, 10 to 259200): how long Kernel keeps the browser once agent-qa's
connection drops.
stealth,region,proxy,viewport(width,height,refreshRate): Kernel's own create
fields.
pool: a browser pool's id or name. The remote then takes a warm browser from the pool instead
of creating one, and waits while the pool is empty. The pool's configuration sets the browser,
so stealth, region, proxy and viewport are refused on a remote with pool.
profile: a Kernel profile's name, or{ id: }. It loads read-only: nothing the
test does is saved back. It needs context: reuse on the remote, because the profile lives in
the browser's first context:
- name: kernel-signed-in
plugin: kernel
context: reuse
settings:
profile: shop-test-user
extra: any other Kernel request field. It is merged last, so it overrides the settings above.
After a test in a new context, a pooled browser goes back to the pool for reuse. After a test with
context: reuse, it is discarded, so the next test gets a clean one.
Kernel has no session page, so a Kernel test shows no session link. The live view URL of a headful
browser carries a credential, so agent-qa masks it and never shows it.
When a remote is refused
auth: Kernel refused the API key. Check the secret's value.capacity: Kernel answered 429 or 529. The account has no free sessions, or is rate limited.
Wait, lower the run's concurrency, or use a pool.
refusedwith pathsettings.profile: the remote setsprofilewithoutcontext: reuse.refusedwith anothersettings.path: that field is wrong for this remote. The line
says why.
unreachable: Kernel could not be reached. Check the network.
Check and describe
agent-qa doctorruns the plugin's account check. It reads the browser list to prove the key,
the organization's free sessions when the key may read them, and each pool a remote names. It
creates no browser.
agent-qa plugins describe --jsonlists every option and setting with its type,
default and description.