rust-node-bootstrap

Rust+Node.js 项目引导

一站式搭建 Rust+Node.js 混合项目的所有基础设施。

何时使用此技能

符合以下任一条件时启用：

• 用户提到“bootstrap”（引导）、“scaffold”（搭建脚手架）、“new project”（新建项目）或“set up from scratch”（从头开始设置）
• 仓库中有 Cargo.toml 或 package.json，但缺少另一个
• 缺少 .github/workflows/、scripts/ 或 publish.config.ts
• 逐步为现有项目添加 forge 基础设施

决策树

Starting from scratch?
  YES → Full scaffold (all steps in order below)
  NO  → Incremental setup ↓

Has package.json?       → NO: Create root package.json + pnpm-workspace.yaml
Has Cargo.toml?         → NO: Create Cargo workspace
Has .github/workflows/? → NO: Generate from rust-node-ci skill templates
Has scripts/?           → NO: Generate from rust-npm-publish skill templates
Has publish.config.ts?  → NO: Create from rust-npm-publish skill examples
Has specs/?             → NO: Initialize LeanSpec

收集项目信息

字段	示例	必填
项目名称	my-tool	是
npm 作用域	@myorg	是
Rust 二进制名称	my-cli	是
Cargo 软件包名称	my-cli-rs	是
主要 npm 软件包	packages/cli	是
仓库 URL	github.com/myorg/my-tool	是
平台	darwin-x64, darwin-arm64, linux-x64, windows-x64	否（默认：全部 4 个）

脚手架结构

完整的注释版目录树请参阅 references/project-structure.md。

my-tool/
├── .github/workflows/       ← CI + publish workflows
├── .lean-spec/config.json   ← LeanSpec configuration
├── specs/                   ← Spec-driven development
├── packages/cli/            ← Main npm package (thin JS wrapper)
│   ├── package.json         ← bin + optionalDependencies
│   └── bin.js               ← Resolves platform binary, spawns it
├── rust/                    ← Rust workspace
├── scripts/                 ← Publish & version scripts
├── publish.config.ts        ← Publish pipeline configuration
├── package.json             ← Root (version source of truth)
├── pnpm-workspace.yaml      ← pnpm workspace definition
└── Cargo.toml               ← Rust workspace manifest

文件生成顺序

顺序很重要——后续文件依赖前面的文件：

1. 根配置 — package.json、pnpm-workspace.yaml、Cargo.toml、turbo.json。使用 templates/bootstrap/。
2. 发布配置 — publish.config.ts（用于生成脚本和工作流）
3. 主要软件包封装 — 使用 rust-npm-publish 技能模板中的 bin.js + package.json，填入作用域、二进制名称和平台
4. 脚本 — 从 rust-npm-publish 技能模板复制
5. 工作流 — 从 rust-node-ci 技能模板复制，并自定义矩阵
6. LeanSpec — 初始化 .lean-spec/config.json 和 specs/
7. AGENTS.md — 项目级 Agent 指令，列出已安装的技能

验证

pnpm install && pnpm build && cargo check --workspace && pnpm tsx scripts/sync-versions.ts

完整的引导后检查清单请参阅 references/checklist.md。

安装配套技能

搭建脚手架后，安装用于持续开发的技能：

# CI/CD workflows and composite actions
npx skills add -g onsager-ai/dev-skills --skill rust-node-ci -a claude-code -y

# npm publishing pipeline and versioning
npx skills add -g onsager-ai/dev-skills --skill rust-npm-publish -a claude-code -y

模板

目录	内容
templates/bootstrap/	根配置：package.json、Cargo.toml、pnpm-workspace.yaml、turbo.json、publish.config.ts

设置与激活

npx skills add -g onsager-ai/dev-skills --skill rust-node-bootstrap -a claude-code -y

在 Rust+Node.js 上下文中，用户提到“bootstrap”（引导）、“scaffold”（搭建脚手架）、“new project”（新建项目）或“init”（初始化）时自动激活。