菜单
Lightweight verification for UI-only changes to @dbt-tools/web. Runs lint, unit tests, coverage, a fresh build, Playwright E2E, and a coverage gap report. Use instead of the full verifier when changes are confined to packages/web/src/ and/or packages/web/e2e/. Skips CodeQL and pack+npx smoke.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Reload in-memory artifacts after dbt run or a known artifact change. Use on the same target without restarting MCP.
Establish the dbt artifact root for this session (local path, s3://, or gs://). Use before any other dbt-tools analysis primitive.
Check MCP session state—target, load time, stale flag, runs, warehouse type. Use as a gate before analysis primitives.
Establish the dbt artifact root for this session (local path, s3://, or gs://). Use before any other dbt-tools analysis primitive.
Check whether dbt artifacts exist, are fresh, and which readiness level applies. Use as a gate before manifest- or run_results-based analysis.
Return metadata and context for one dbt resource by unique_id. Use when explaining what a model, source, or test does.
| name | ui-feature-verify |
| description | Lightweight verification for UI-only changes to @dbt-tools/web. Runs lint, unit tests, coverage, a fresh build, Playwright E2E, and a coverage gap report. Use instead of the full verifier when changes are confined to packages/web/src/ and/or packages/web/e2e/. Skips CodeQL and pack+npx smoke. |
| compatibility | Requires pnpm and Node as in repo .node-version; Playwright Chromium via @dbt-tools/web devDependencies. Run from repository root unless noted. |
Use this skill when:
packages/web/src/ (components, styles, types, lib, helpers).packages/web/e2e/ (Playwright specs, fixtures, helpers) even if nothing under web/src/ changed — E2E-only work still needs build + browser install + E2E (steps 5–7).Do not use this skill when changes touch published packages (dbt-artifacts-parser, @dbt-tools/core), scripts under scripts/, CI workflows, or package.json files in isolation (no @dbt-tools/web app or E2E scope). Use the full verifier agent for those. If the diff mixes those areas with packages/web/src/ or packages/web/e2e/, prefer this skill for the web/E2E verification slice and call out any remaining gates the full verifier must cover.
Working-tree check. Run git status --short. If files outside packages/web/ are modified, warn the user and ask whether to proceed. If another agent may still be writing files, wait for it to finish before continuing.
Lint. Run pnpm lint:report from the repository root. Must exit 0. If it fails, apply lint-and-fix until it passes, then rerun.
Unit tests. Run pnpm --filter @dbt-tools/web test. If tests fail, apply test-and-fix and rerun until green.
Coverage. Run pnpm coverage:report from the repository root. Must exit 0. If below thresholds, add unit tests and rerun. Thresholds: lines 60%, branches 50%, functions 60%, statements 60% (see CLAUDE.md).
Build (always rebuild). Run pnpm --filter @dbt-tools/web build. Do not skip even if dist/ appears current—a stale build causes silent E2E failures. If it fails, apply build-and-fix and rerun.
Playwright browser check. Run pnpm --filter @dbt-tools/web exec playwright install chromium --with-deps. Idempotent when browsers are present; fast. Do not skip.
E2E. Run pnpm --filter @dbt-tools/web test:e2e. If E2E fails, apply dbt-tools-web-e2e-fix and rerun until green. E2E-only edits (no web/src/ changes) still require steps 5–7 (fresh build, Playwright install, E2E).
Coverage gap report. Review the diff for this session (git diff --name-only HEAD~1..HEAD or the user's stated scope). List every new interactive UI element (button, tab, pivot, navigation link) added. For each, confirm a toBeVisible or equivalent assertion exists in the corresponding spec under packages/web/e2e/. Report any element without a spec assertion as a gap. Do not claim the feature is shipped until each gap is covered or explicitly accepted by the user with a reason.
Intentionally omits pnpm codeql and dbt-tools-web-pack-npx-smoke. Both are expensive and irrelevant for source-only UI changes. Use the full verifier agent when those gates are needed.