菜单
Pack @dbt-tools/web to a tarball and smoke-test the published dbt-tools-web CLI via npx without npm publish. Use when verifying the npm distribution, pre-release checks, bin/dist-serve layout, or fixing pack/npx failures for the web package.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/yu-iskw/dbt-tools-ts --skill dbt-tools-web-pack-npx-smoke命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
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.
基于 SOC 职业分类
正在显示 SKILL.md
| name | dbt-tools-web-pack-npx-smoke |
| description | Pack @dbt-tools/web to a tarball and smoke-test the published dbt-tools-web CLI via npx without npm publish. Use when verifying the npm distribution, pre-release checks, bin/dist-serve layout, or fixing pack/npx failures for the web package. |
| compatibility | Requires pnpm and Node as in repo .node-version; npx (npm). Run from repository root unless noted. |
npx smokeUse this skill when the user or task implies:
@dbt-tools/web (tarball, bin, dist + dist-serve).dbt-tools-web via npx without publishing to the public registry.npx + local .tgz failures (Permission denied, missing dist-serve, wrong deps in tarball, ETARGET for workspace peers).npx smoke job.Do not substitute this for Playwright E2E (pnpm test:e2e) or full UI regression; use dbt-tools-web-e2e-fix for browser E2E.
Ensure the npm pack artifact installs and exposes the dbt-tools-web binary correctly. This catches mistakes in package.json bin, files, prepack build, and workspace dependency rewriting that unit tests and Vite dev do not cover.
From the repository root after pnpm install:
CI parity (recommended): bash scripts/smoke-npx-with-verdaccio.sh starts Verdaccio, publishes @dbt-tools/core and @dbt-tools/web into the local registry, packs web, and runs smoke:npx-tgz with NPM_CONFIG_REGISTRY pointed at Verdaccio. The dbt-artifacts-parser dependency is resolved from npm; this repository does not build or publish the parser package.
Manual tarball-only path (only if dbt-artifacts-parser and @dbt-tools/core versions exist on the registry you use, or you set NPM_CONFIG_REGISTRY after publishing peers elsewhere):
pnpm --filter @dbt-tools/web pack — creates dbt-tools-web-<version>.tgz at the repo root.pnpm --filter @dbt-tools/web run smoke:npx-tgz or npx -y --package="$TGZ" -- dbt-tools-web --help from a clean temp dir (see references/commands-and-pitfalls.md).Details, optional HTTP smoke, ETARGET / missing peers, and the absolute-path npx pitfall are in references/commands-and-pitfalls.md.
bash scripts/smoke-npx-with-verdaccio.sh from the repo root; it must exit 0.dbt-tools-web-*.tgz at repo root → smoke with a registry that has dbt-artifacts-parser and @dbt-tools/core at the packed versions.ETARGET, Permission denied, missing dist-serve). Fix web package.json, Vite server build (vite.server.config.ts), prepack/build scripts, or Verdaccio/publish wiring, then rerun.pack triggers prepack and may rebuild the web package even after pnpm build; that is expected and matches publish behavior.
dbt-tools-web-e2e-fixbuild-and-fixWhen invoked as part of verification, run this smoke after pnpm build succeeds so TypeScript/Vite issues are caught first. Prefer bash scripts/smoke-npx-with-verdaccio.sh for CI parity. Report whether the script, or pack + npx --help, passed.
Full gate order and reporting live in .claude/agents/verifier.md.