Agent Skills › liaohch3/claude-tap › e2e-test

e2e-test

GitHub

用于在修改 claude-tap 核心逻辑后运行端到端测试。涵盖代理处理、TraceWriter、HTML 查看器及信号处理等模块，提供完整套件及单用例执行命令，并指导根据失败类型排查代码问题。

.agents/skills/e2e-test/SKILL.md liaohch3/claude-tap

Trigger Scenarios

修改了 claude-tap 的核心逻辑需要验证端到端功能完整性修改了代理处理器或 SSE 重组装代码修改了 TraceWriter 的写入或刷新行为修改了 HTML 查看器生成逻辑修改了 LiveViewerServer 的 SSE 流处理修改了信号处理或优雅关闭逻辑修改了手动更新命令或清理逻辑

Install

npx skills add liaohch3/claude-tap --skill e2e-test -g -y

More Options

Non-standard path

npx skills add https://github.com/liaohch3/claude-tap/tree/main/.agents/skills/e2e-test -g -y

Use without installing

npx skills use liaohch3/claude-tap@e2e-test

指定 Agent (Claude Code)

npx skills add liaohch3/claude-tap --skill e2e-test -a claude-code -g -y

安装 repo 全部 skill

npx skills add liaohch3/claude-tap --all -g -y

预览 repo 内 skill

npx skills add liaohch3/claude-tap --list

SKILL.md

Frontmatter

{
    "name": "e2e-test",
    "description": "Run claude-tap end-to-end tests with pytest",
    "user_invocable": true
}

claude-tap E2E Test

Run this skill after modifying core logic in claude-tap, especially:

Proxy handler / SSE reassembly (__init__.py)
TraceWriter (JSONL writing, flush behavior)
HTML viewer generation (viewer.html, _generate_html_viewer)
LiveViewerServer (SSE streaming)
Signal handling / graceful shutdown
Manual update command / trace cleanup

Steps

Run the full test suite:

uv run pytest tests/test_e2e.py -v --timeout=120

Or run a single test:

uv run pytest tests/test_e2e.py::test_e2e -v           # Full E2E pipeline
uv run pytest tests/test_e2e.py::test_trace_cleanup -v  # Trace cleanup
uv run pytest tests/test_e2e.py::test_startup_does_not_contact_pypi -v  # No startup update network

Read the output. Each test prints PASSED or FAILED.
If tests fail, check:
- test_e2e fails: Core proxy pipeline issue. Check proxy_handler, _handle_streaming, TraceWriter.write.
- test_trace_cleanup fails: Manifest logic issue. Check _load_manifest, _cleanup_traces, _register_trace.
- test_startup_does_not_contact_pypi fails: Startup made an unexpected update-related network request.
- test_live_viewer_ fails*: Viewer HTML issues. Check viewer.html for preserveDetail chain, updateNavButtons.
- Timeout: May be a network/port issue, not a claude-tap bug.