Thêm Product E2E Eval

Kỹ năng hướng dẫn thêm/mở rộng luồng đánh giá Product E2E (Chromium thật, server, runner, provider) cùng fixture, matcher và đường dẫn bằng chứng trong kho Paperclip.

Lập trìnhNâng cao★ 108,442⑂ 17,963Điểm AI 7/10Cập nhật lần cuối: 29 thg 10, 2026

Làm được gì

Chuẩn hoá quy trình thêm hoặc mở rộng Product E2E Eval trong monorepo Paperclip: Chromium thật, server Paperclip, database, runner, provider và tuỳ chọn Daytona.
Xác định gốc kho bằng PAPERCLIP_ROOT hoặc git rev-parse --show-toplevel, kiểm tra sự tồn tại của tests/runner-e2e và packages/paperclip-runner.
Đăng ký workflow vào catalog.ts, fixture-registry.ts, everyday-cases.ts, everyday-flow.ts và nối ID profile/environment/case qua bảng selector, matcher.
Áp quy tắc bảo mật: không để credential trong catalog, ảnh chụp, log; ảnh Daytona phải là digest bất biến; không xuất bản trace/video/database thô.
Phân loại thất bại theo bằng chứng (lỗi sản phẩm, hành vi model/provider hay hạ tầng) và giữ nguyên điểm máy chấm.

Dành cho ai

Lập trình viên đóng góp case đánh giá cho kho paperclipai/paperclip.
Kỹ sư QA/nền tảng bảo trì bộ test runner E2E và Everyday Workflows.
Nhóm cần chạy chiến dịch E2E tốn phí một cách có kiểm soát, chỉ chọn phạm vi nhỏ nhất.

Ví dụ sử dụng

"Thêm một case Everyday Workflow mới" → tạo case trong everyday-cases.ts/everyday-flow.ts, đăng ký ở catalog.ts, rồi kiểm tra bằng pnpm test:e2e:runner -- --list --suite everyday-workflows.
"Hiệu chỉnh matcher chấm điểm" → thử với một kết quả đúng và một kết quả sai hợp lý, đảm bảo thiếu bằng chứng thì không thể pass.
"Phân tích lần chạy bị timeout" → dựa vào evidence đóng gói và dashboard để quy kết nguyên nhân là lỗi sản phẩm, provider hay hạ tầng.

· · · Hướng dẫn cài đặt · · ·

Dùng thử ngay, không cần cài

Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.

Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình:
https://raw.githubusercontent.com/paperclipai/paperclip/HEAD/.agents/skills/add-product-e2e-eval/SKILL.md

Mình muốn: (viết việc bạn cần ở đây)

Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.

↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.

Cài vào ứng dụng Claude (không cần terminal)

Tải tệp ZIP bằng nút bên dưới.
Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.

↓ Tải ZIP

Cài vào Claude Code

Để Claude làm — dán câu dưới đây vào Claude Code

Hãy cài skill mình tìm thấy trên AI Skill Mart.
Copy thư mục .agents/skills/add-product-e2e-eval từ repo GitHub paperclipai/paperclip vào ~/.claude/skills/add-product-e2e-eval/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.

Cài bằng lệnh thủ công

git clone https://github.com/paperclipai/paperclip.git && mkdir -p ~/.claude/skills && cp -r paperclip/.agents/skills/add-product-e2e-eval ~/.claude/skills/

⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.

Mở terminal.
Clone kho: git clone https://github.com/paperclipai/paperclip.git
Tạo thư mục kỹ năng: mkdir -p ~/.claude/skills
Sao chép kỹ năng: cp -r paperclip/.agents/skills/add-product-e2e-eval ~/.claude/skills/
Khởi động lại Claude Code và kiểm tra add-product-e2e-eval xuất hiện trong danh sách kỹ năng.
Kỹ năng chỉ hoạt động bên trong kho Paperclip: hãy làm việc tại gốc kho đã clone hoặc đặt biến môi trường PAPERCLIP_ROOT trỏ tới đó.
Chạy pnpm install, sau đó pnpm test:e2e:runner -- --list để xác nhận các suite được nhận diện.

Xem mã nguồn trên GitHub ↗Giấy phép: MIT