Agent skill

E2E Test

by bifrost-proxy in bifrost-proxy/bifrost

创建和执行 Bifrost 代理的端到端测试;在添加新功能或修复 bug 后用于验证。必须优先于 rust-project-validate 技能执行。

MITAuto-check passedTesting & QA

Install E2E Test

skills CLI
$ npx skills add bifrost-proxy/bifrost --skill e2e-test -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bifrost-proxy/bifrost e2e-test --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bifrost-proxy/bifrost.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/e2e-test .claude/skills/e2e-test && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
e2e-test
GitHub stars
160
Token cost
~848 tokens
SKILL.md length
166 words
Files
8
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

创建和执行 Bifrost 代理的端到端测试;在添加新功能或修复 bug 后用于验证。必须优先于 rust-project-validate 技能执行。

  • Tasks that involve End-to-end testing
  • SKILL.md covers 何时调用, 参考文档, 使用说明 and CLI 测试方法, plus 1 more section
  • Calls cargo and curl

What it does

E2E Test is an agent skill from bifrost-proxy/bifrost. 创建和执行 Bifrost 代理的端到端测试;在添加新功能或修复 bug 后用于验证。必须优先于 rust-project-validate 技能执行。

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files (for example `01-快速构建启动.md`, `02-SSE请求详情分批推送验证.md` and `03-运行全量测试.md`).

It sits in Testing & QA, covering End-to-end testing. It works with Rust. The repository describes itself as: Bifrost 是一个用 Rust 编写的高性能、AI 友好的代理服务器,它提供强大的请求拦截、修改和规则配置能力,支持 TLS 解密、脚本扩展等高级功能,支持强大的模糊搜索,支持导入导出分享,支持一键重放请求,支持Coding Agent 自主管理。提供类似 postman 的请求管理和验证能力,无缝和代理能力集成。 The licence is MIT.

When your agent uses it

  • Tasks that involve End-to-end testing

Example prompts

  • “/e2e-test”

What it can do on your machine

Read from SKILL.md and the folder at commit cad75f8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • cargo
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

E2E Test loads about 848 tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 166 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~21
When it runs · the whole SKILL.md, loaded when a task matches
~848

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from bifrost-proxy/bifrost at commit cad75f8, republished under its MIT licence (© bifrost-proxy). 166 words, ~848 tokens.

Download SKILL.mdSave it as .claude/skills/e2e-test/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
e2e-test
description
创建和执行 Bifrost 代理的端到端测试;在添加新功能或修复 bug 后用于验证。必须优先于 rust-project-validate 技能执行。

E2E 测试创建与执行

该技能用于创建和执行 Bifrost 的端到端测试,优先覆盖本次变更涉及的能力。

何时调用

  • 添加新功能后需要验证
  • 修复 bug 后需要回归测试
  • 需要创建新的测试用例
  • 需要运行现有的 E2E 测试

参考文档

在执行任务前,必须先阅读 E2E 测试框架的详细文档:

使用说明

  • 启动代理服务时,必须显式设置临时数据目录,避免覆盖本机已有数据;目录前缀统一使用 ./.bifrost-e2e
  • 若需要手动启动服务,优先使用“先编译、再启动”的方式,而不是直接假设 cargo run 或旧进程已生效
  • 新增或修改“规则行为”相关测试时,规则定义必须存放在 e2e-tests/rules/ 下,不能散落到根目录、临时文件或其他测试目录
  • e2e-tests/rules/ 下的规则文件必须按“模块功能 + 测试目标”组织:
    • 先按模块功能拆分子目录,例如 forwarding/、request_modify/、response_modify/
    • 再按单一测试目标拆分 .txt 文件;一个文件只表达一组紧密相关的规则语义,避免把多个无关目标塞进同一个文件
  • 规则文件命名要直接表达测试目标,使用小写下划线风格,例如 headers.txt、wildcard_level.txt、tls_intercept_rule.txt
  • 每个规则文件顶部必须先写清楚测试目标,再写测试规则本体;顶部说明至少应回答“这个文件验证什么语义/行为”
  • 与规则文件配套的测试脚本必须存放在 e2e-tests/tests/,不能继续放在 scripts/、根目录或其他位置;脚本命名建议与测试目标对应,例如 test_header_replace.sh
  • 如果某个测试需要额外样例数据、模板或 mock 文件,分别放到现有的 e2e-tests/test_data/、e2e-tests/mock_servers/ 等目录,不要和规则文件混放
  • 对涉及前端静态资源或管理端推送逻辑的改动,优先执行:
bash
CARGO_TARGET_DIR=./.bifrost-ui-target cargo build --bin bifrost
BIFROST_DATA_DIR=./.bifrost-e2e-test ./.bifrost-ui-target/debug/bifrost start -p 8800 --unsafe-ssl
  • 启动后,必须同时检查:
    • 目标端口是否真的由最新 bifrost 进程监听,例如 lsof -nP -iTCP:8800 -sTCP:LISTEN
    • 管理端 API 是否 ready,例如 curl -sS http://127.0.0.1:8800/_bifrost/api/proxy/address
  • 如果启动过程中出现证书安装交互,先显式处理掉,再继续测试,避免把“服务未启动完成”误判为功能问题
  • 不同场景的步骤已拆分为独立文档;按需打开对应文件执行即可
  • 当 UI 现象和 API 现象不一致时,优先做“进程级 + API + WebSocket frame”三层交叉验证:
    • 先确认当前测试页面连到的是哪一个 bifrost 进程
    • 再确认 /_bifrost/api/traffic、/_bifrost/api/traffic/{id} 返回的真实状态
    • 最后抓浏览器 /api/push 的 framesent/framereceived,判断是“服务端没推”还是“页面没订阅/没消费”
  • 新建规则测试后,顺手检查对应的规则文件与脚本是否一一对应;若无法建立清晰对应关系,应继续拆分目录或文件
  • 测试结束后清理临时目录和残留进程

CLI 测试方法

当本次变更涉及 bifrost CLI 子命令(例如 bifrost value ...、bifrost rule ...、bifrost script ...)时,推荐使用“黑盒 + 独立数据目录”的方式编写与执行测试:

  • 使用独立 BIFROST_DATA_DIR:用 mktemp -d 创建测试目录并导出,避免污染本机 ~/.bifrost
  • 优先复用已编译二进制:默认使用 target/release/bifrost,不存在时再 cargo build --release --bin bifrost
  • 断言策略:
    • 基于 CLI 输出:用 grep/jq(如有)做关键字段断言
    • 基于落盘结果:检查 BIFROST_DATA_DIR 下对应文件/目录是否按预期创建与更新
  • 清理策略:用 trap cleanup EXIT 确保结束后停止残留进程并删除临时目录

现有 CLI 测试用例可直接参考与复用:

  • e2e-tests/test_values_cli.sh:示例化展示了 build、BIFROST_DATA_DIR 隔离、以及 set/get/list/delete/import 的断言方式
  • e2e-tests/tests/test_cli_proxy_start_e2e.sh:启动相关 CLI 的端到端覆盖
  • e2e-tests/tests/test_upgrade_cli.sh:升级相关 CLI 覆盖
针对新 CLI 子命令的脚本模板(示例)

以 bifrost script 为例,核心验证点建议包括:add → show → list → delete 以及脚本文件落盘路径:

bash
TEST_DIR="$(mktemp -d)"
trap 'rm -rf "$TEST_DIR"' EXIT

export BIFROST_DATA_DIR="$TEST_DIR"
BIFROST_BIN="./target/release/bifrost"

"$BIFROST_BIN" script add request cli_test -c 'log.info("hello");'
"$BIFROST_BIN" script show request cli_test | grep -q 'hello'
"$BIFROST_BIN" script list -t request | grep -q 'cli_test'
test -f "$BIFROST_DATA_DIR/scripts/request/cli_test.js"
"$BIFROST_BIN" script delete request cli_test

场景文档

© bifrost-proxy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files in .agents/skills/e2e-test of bifrost-proxy/bifrost.

  • SKILL.md
  • 01-快速构建启动.md
  • 02-SSE请求详情分批推送验证.md
  • 03-运行全量测试.md
  • 04-运行单个测试.md
  • 05-创建新测试.md
  • 06-调试与端到端验证方法.md
  • 07-真实人类测试.md

Open the folder on GitHubat commit cad75f8

Compare with similar skills

E2E Test next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

E2E Test compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
E2E Test this skillbifrost-proxy/bifrost160—~848Automated safety check: PassMIT
Warp Integration Test Videowarpdotdev/warp65k1 repos~2.6kAutomated safety check: PassAGPL-3.0
Hydra Devstreamband/hydra-srt146—~995Automated safety check: PassApache-2.0
Kaniop Developmentpando85/kaniop130—~3.1kAutomated safety check: PassAGPL-3.0
Test Specialisttravisjneuman/.claude101—~3.7kAutomated safety check: PassMIT
Desktop App Driving with Reticlereticlehq/reticle1.2k—~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Records screenshots and video from Warp's Rust integration-test harness, with the commands and environment variables to run a named test and review its artifacts.

    65k GitHub starsUsed in 1 repo~2.6k tokens
    Testing & QAAuto-check passed
  • Hydra Dev

    streamband/hydra-srt

    Run HydraSRT development workflows: mix q quality gate, Elixir unit/E2E tests, native Rust tests, web Vitest/Playwright, and make dev.

    146 GitHub stars~995 tokensUpdated 22 days ago
    Testing & QAAuto-check passed
  • Kaniop Development

    pando85/kaniop

    Kaniop architecture, Rust controller conventions, commands, testing, and repository workflows.

    130 GitHub stars~3.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Test Specialist

    travisjneuman/.claude

    Test-writing patterns for JS/TS, Python, Go, and Rust (unit, integration, E2E, visual regression).

    101 GitHub stars~3.7k tokensUpdated 2 days ago
    Testing & QAAuto-check passed
  • Drives and verifies Electron or Tauri desktop apps through Reticle, which sees the renderer and the IPC calls that a browser-based testing tool cannot observe.

    1.2k GitHub stars~1.3k tokensUpdated today
    Testing & QAAuto-check passed
  • A skill your agent uses when building Farm locally from source, native bindings or Rust plugin artifacts are missing, or an example/E2E needs local core and plugin artifacts.

    5.6k GitHub stars~857 tokensUpdated 16 days ago
    Testing & QAAuto-check passed

More from bifrost-proxy/bifrost

All 9 skills in this repo
  • Juejin Publish

    bifrost-proxy/bifrost

    Publish Markdown articles and Bifrost capability series to Juejin, or verify with Microsoft Edge that a published Juejin page's title and body match the local Markdown.

    160 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Site Cookie Login

    bifrost-proxy/bifrost

    Open a target website, wait for user login, verify login with required cookies plus an HTTP probe, and save cookies into .env for later automation.

    160 GitHub stars~600 tokensUpdated today
    Auto-check: notes
  • Zhihu Publish

    bifrost-proxy/bifrost

    Publish Markdown articles to Zhihu Columns through authentication context recovered locally from Bifrost traffic and a built-in publish payload schema, save drafts, prevent duplicate posts, and…

    160 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Codex Task Inspector

    bifrost-proxy/bifrost

    Inspect Codex async task progress from the correct data directory.

    160 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • E2E Verify

    bifrost-proxy/bifrost

    面向 Bifrost 管理端的端到端 UI 与 API 验证工具. An agent skill from bifrost-proxy/bifrost.

    160 GitHub stars~730 tokensUpdated today
    Auto-check passed
  • GitHub Actions Pat

    bifrost-proxy/bifrost

    用 Personal Access Token 通过 GitHub REST API 分析 Actions CI 的失败 run/job/step、拉取日志、轮询运行状态、做 PR code review,并驱动 fix → push → watch → iterate 的闭环。Token 只从 GITHUBTOKEN 环境变量读取,不落盘、不回显。适合在 bifrost remote /…

    160 GitHub stars~2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about E2E Test

What does E2E Test do?

创建和执行 Bifrost 代理的端到端测试;在添加新功能或修复 bug 后用于验证。必须优先于 rust-project-validate 技能执行。. E2E Test is an agent skill from bifrost-proxy/bifrost.

When should I use E2E Test?

E2E Test fits situations like: tasks that involve End-to-end testing.

How do I install E2E Test in Claude Code?

Run `npx skills add bifrost-proxy/bifrost --skill e2e-test -a claude-code`. Or copy the skill folder (.agents/skills/e2e-test in bifrost-proxy/bifrost) into .claude/skills/e2e-test in your project. Claude Code loads it when a task matches its description.

How do I install E2E Test in Codex?

Run `npx skills add bifrost-proxy/bifrost --skill e2e-test -a codex`. Or copy the skill folder (.agents/skills/e2e-test in bifrost-proxy/bifrost) into .agents/skills/e2e-test in your project. Codex loads it when a task matches its description.

Can I use E2E Test in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bifrost-proxy/bifrost --skill e2e-test -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/e2e-test, .gemini/skills/e2e-test, .github/skills/e2e-test and .opencode/skills/e2e-test in your project.

What does E2E Test need to run?

Going by SKILL.md and its folder, E2E Test needs the command-line tools its instructions call (cargo and curl).

Does E2E Test access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is E2E Test safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does E2E Test use?

E2E Test is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does E2E Test use?

About 848 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to E2E Test?

Skills that share tags, products or a category with E2E Test: Warp Integration Test Video (warpdotdev/warp, 65k stars), Hydra Dev (streamband/hydra-srt, 146 stars), Kaniop Development (pando85/kaniop, 130 stars) and Test Specialist (travisjneuman/.claude, 101 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains E2E Test?

bifrost-proxy (a GitHub user) maintains it in bifrost-proxy/bifrost, which has 160 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 7, 2026.

Source: bifrost-proxy/bifrost on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.