Agent Skillspaperclipai/paperclip › add-product-e2e-eval

add-product-e2e-eval

GitHub

用于添加或扩展 Paperclip 全栈 E2E 工作流、夹具及报告证据,支持本地或 Daytona 执行。涵盖定位仓库、阅读文档、定义工作流、注册目录、配置断言及运行测试等步骤,确保符合生产环境标准与安全规范。

.agents/skills/add-product-e2e-eval/SKILL.md paperclipai/paperclip

Trigger Scenarios

需要添加新的端到端测试用例 扩展现有的 E2E 工作流 创建或修改 E2E 夹具和匹配器

Install

npx skills add paperclipai/paperclip --skill add-product-e2e-eval -g -y
More Options

Non-standard path

npx skills add https://github.com/paperclipai/paperclip/tree/master/.agents/skills/add-product-e2e-eval -g -y

Use without installing

npx skills use paperclipai/paperclip@add-product-e2e-eval

指定 Agent (Claude Code)

npx skills add paperclipai/paperclip --skill add-product-e2e-eval -a claude-code -g -y

安装 repo 全部 skill

npx skills add paperclipai/paperclip --all -g -y

预览 repo 内 skill

npx skills add paperclipai/paperclip --list

SKILL.md

Frontmatter
{
    "name": "add-product-e2e-eval",
    "description": "Add or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution."
}

Add a Product E2E Eval

Use this skill for Product E2E Evals: real Chromium, Paperclip server, database, runner, provider, and optionally Daytona. Everyday Workflows are in this family even when their packaged results are imported into Evalbook. Runner protocol cases against the mock control plane belong in add-runner-eval.

Locate the repository using PAPERCLIP_ROOT when supplied, or git rev-parse --show-toplevel from a checkout. From outside Git, inspect workspace roots such as ~/paperclipai/paperclip; verify the selected root contains tests/runner-e2e and packages/paperclip-runner. Run commands from that repository root. The copied skill may live outside the checkout. Read doc/evals.md, then the authoritative tests/runner-e2e/README.md, FIXTURES.md, SECURITY.md, and EVERYDAY-WORKFLOWS.md for the selected area. Inspect the nearest existing catalog entry, case, harness flow, matcher, evidence writer, and report test before changing anything. Keep the user journey on production browser/API surfaces; do not add private runner hooks or direct fixture database writes.

Define one bounded workflow with a clear user outcome, durable state assertions, and independent evidence. Declare profile, environment, expected provider turns, timeout, cleanup, screenshots, artifact checks, and billing scope. Keep credentials and secrets out of catalog data, screenshots, fixture metadata, logs, and tracked files. Daytona images must be immutable digest references. Use the existing result validator, failure classifier, screenshot policy, and Product E2E report pipeline rather than duplicating them.

Register the workflow in tests/runner-e2e/catalog.ts and the relevant fixture-registry.ts paths. Everyday cases and actions live in everyday-cases.ts and everyday-flow.ts; match the existing suite's structure. Wire its profile/environment/case IDs through existing selector and matcher tables, and add report/catalog coverage tests where the surrounding suite does so. Calibrate new grading assertions with a valid outcome and a plausible wrong outcome; missing evidence must not produce a pass. Confirm discovery before running it:

pnpm test:e2e:runner -- --list --suite <suite-name>
pnpm test:e2e:runner -- --list --suite everyday-workflows

--all intentionally excludes the manual everyday-workflows suite and other explicit-only cells. Use the exact suite or execution ID for those. The Product E2E generator is pnpm test:e2e:runner:report; an Everyday Workflows result may also be imported into Evalbook with its canonical importer, but it remains a Product E2E run and should use its packaged dashboard/report first.

Run credential-free checks first:

pnpm test:e2e:runner:typecheck
pnpm test:e2e:runner:unit
pnpm test:e2e:runner -- --list

For an authorized live check, use the smallest explicit local --id selector. Select Daytona only with the configured immutable image and credentials. A full --all campaign is paid and is for the governed workflow. Verify results from the packaged attempt evidence and dashboard; passing model-authored tests cannot override the independent oracle.

Classify a completed wrong workflow as product or model/provider behavior as the assertions warrant. Startup, transport, and timeout symptoms require evidence-based attribution: they may indicate a Paperclip/Runner product bug, provider behavior, or infrastructure. Preserve the observed failure and cause separately, keep the existing machine grade/classifier unchanged, and retain partial attempts, retries, source SHA, catalog/definition digest, model/profile, environment, grader version, timing, tokens, runtime estimates, and cost coverage. Do not claim qualification from a partial/manual selection.

Update README.md, FIXTURES.md, SECURITY.md, or EVERYDAY-WORKFLOWS.md when their authoritative contract changes, and link from doc/evals.md. Do not recreate Evalbook HTML or publish raw trusted traces, videos, archives, databases, workspaces, credentials, SVG, provider session IDs, or hidden reasoning. Public sanitized fixture conversation, marked screenshots, and allowlisted structured evidence are expected when the existing publisher permits them.

Version History

  • 8326e33 Current 2026-09-22 20:25

Same Skill Collection

.agents/skills/add-runner-eval/SKILL.md
.agents/skills/check-pr/SKILL.md
.agents/skills/company-creator/SKILL.md
.agents/skills/create-agent-adapter/SKILL.md
.agents/skills/create-issue-interaction-ui/SKILL.md
.agents/skills/create-paperclip-bundled-skill/SKILL.md
.agents/skills/deal-with-security-advisory/SKILL.md
.agents/skills/diagnose-why-work-stopped/SKILL.md
.agents/skills/doc-maintenance/SKILL.md
.agents/skills/garden-inbox/SKILL.md
.agents/skills/paperclip-create-plugin/SKILL.md
.agents/skills/paperclip-dev-workspace-run-verify-fix/SKILL.md
.agents/skills/paperclip-evals/SKILL.md
.agents/skills/paperclip-page/SKILL.md
.agents/skills/pr-gardening/SKILL.md
.agents/skills/pr-report/SKILL.md
.agents/skills/prcheckloop/SKILL.md
.agents/skills/prepare-paperclip-pr/SKILL.md
.agents/skills/release-changelog-discord-message/SKILL.md
.agents/skills/release-changelog/SKILL.md
.agents/skills/release/SKILL.md
.agents/skills/terminal-bench-loop/SKILL.md
packages/adapters/hermes/skills/paperclip-task-bridge/SKILL.md
packages/plugins/plugin-llm-wiki/skills/index-refresh/SKILL.md
packages/plugins/plugin-llm-wiki/skills/paperclip-distill/SKILL.md
packages/plugins/plugin-llm-wiki/skills/wiki-ingest/SKILL.md
packages/plugins/plugin-llm-wiki/skills/wiki-lint/SKILL.md
packages/plugins/plugin-llm-wiki/skills/wiki-maintainer/SKILL.md
packages/plugins/plugin-llm-wiki/skills/wiki-query/SKILL.md
skills-releases/paperclip/v0/SKILL.md
skills-releases/paperclip/v7-roster/SKILL.md
skills/agentmail/SKILL.md
skills/paperclip-board/SKILL.md
skills/paperclip-converting-plans-to-tasks/SKILL.md
skills/paperclip-create-agent/SKILL.md
skills/paperclip/SKILL.md
skills/para-memory-files/SKILL.md
.claude/skills/design-guide/SKILL.md

Metadata

Files
0
Version
8326e33
Hash
73457e44
Indexed
2026-09-22 20:25

Главная - Вики-сайт
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-09-22 20:47
浙ICP备14020137号-1