菜单
Watch mode development using Node --experimental-transform-types. No transpiler needed. Watches ./src/, restarts on changes. Custom entry files supported. Experimental command — may change. Use when running TypeScript in dev mode.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
TypeScript to ESM compilation via tsdown with opinionated defaults. Sourcemaps, clean dist/, unbundled output, .d.mts types by default, publint publish gate. Flags: --no-dts, --bundle, --minify. Default entry src/**/*.ts. Use when building a package for publish or generating declarations.
Code formatting via oxfmt with project configuration. Tabs, single quotes, semicolons always, trailing commas, 100-char line width. Use when formatting source files before committing.
Scaffold new Bombshell project from bombshell-dev/template via giget. Replaces $name placeholder in package.json and README.md. Outputs to .temp/. Use when creating a new package in the Bombshell ecosystem.
TDD-driven development workflow for Bombshell projects using bsh CLI. Covers pnpm run as only entry point, command ordering (test→implement→lint→format→build→test), monorepo vs single-package detection with pnpm --filter, human-owned PRs. Use when starting work on any project that depends on @bomb.sh/tools.
Multi-tool linting pipeline: oxlint, knip, and tsgo run in parallel via pnpm run lint (publint gates pnpm run build instead). Covers Bombshell conventions: URL over node:path, max 2 params with options bag, named exports only, import type, prefer node builtins, no console.log, no generic Error. Use when checking code quality or understanding lint violations.
Migrate existing project to bsh toolchain. Remove prettier, biome, eslint, tsup, unbuild, rollup, vitest configs and dependencies. Replace scripts with bsh equivalents. Adopt createMocks and createFixture from @bomb.sh/tools/test-utils. Consolidate to single @bomb.sh/tools devDependency. Migration order: inventory existing tools, add unimplemented commands, replace 1:1 commands, remove configs and deps, adopt test-utils, verify. Use when onboarding a project to the Bombshell ecosystem.
| name | dev |
| description | Watch mode development using Node --experimental-transform-types. No transpiler needed. Watches ./src/, restarts on changes. Custom entry files supported. Experimental command — may change. Use when running TypeScript in dev mode. |
| metadata | {"type":"core","library":"@bomb.sh/tools","library_version":"0.6.0","requires":["lifecycle"],"sources":["bombshell-dev/tools:src/commands/dev.ts"]} |
Runs a TypeScript file with native Node TypeScript support and watches for changes.
pnpm run dev
pnpm run dev runs bsh dev which shells out to:
node --experimental-transform-types --no-warnings --watch-path=./src/ <file>
./src/index.ts./src/ — restarts on any change in the source directory--experimental-transform-typespnpm run dev -- ./src/other.ts
Additional arguments after the file path are passed through to Node.
This is an experimental command that relies on Node's --experimental-transform-types flag. Most Bombshell packages use a TDD loop (pnpm run test) as their primary development workflow rather than the dev server. The dev command is useful for running scripts or servers during development, not as the main iteration cycle.
Tension: Dev command stability vs experimental Node features. The underlying
--experimental-transform-typesflag may change behavior between Node versions. If you hit issues, fall back to the test-driven workflow.
Node handles TypeScript natively. External transpilers are unnecessary and add complexity.
# Wrong
npx tsx src/index.ts
npx tsx watch src/index.ts
npx ts-node src/index.ts
node -r ts-node/register src/index.ts
# Correct
pnpm run dev
These packages are not needed in Bombshell projects.
// Wrong — package.json
{
"devDependencies": {
"tsx": "^4.0.0",
"ts-node": "^10.0.0",
"esbuild-register": "^3.0.0"
}
}
// Correct — no transpiler dependencies needed
{
"devDependencies": {
"@bomb.sh/tools": "^0.3.1"
}
}
build/SKILL.md — Both handle TS compilation in different modes