spec-kit-init

spec-kit-init 是围绕 Rust 单文件安装器 init-spec-kit 的轻量 npm 包装：在已安装 Node.js 的环境中，用 npx 或 npm install -g 按当前系统架构找到 dist/ 里的可执行文件并透传所有参数，无需单独下载二进制。

底层行为与仓库内 Rust CLI（及嵌入的 GitHub Spec Kit 资源）一致：把 specify init 生成的模板解压到目标项目目录。

要求

• Node.js ≥ 16
• 发布到 npm 的压缩包内需包含对应平台的 init-spec-kit（或 Windows 上的 init-spec-kit.exe），见下文「维护者：发布前准备」

使用方式

在项目根目录（或任意目录，配合 --path）执行：

# 推荐：不全局安装，每次拉取并运行
npx spec-kit-init --help

# 实际初始化（默认中文、Cursor；与直接运行 init-spec-kit 相同）
npx spec-kit-init

# 指定语言与客户端
npx spec-kit-init --locale en
npx spec-kit-init --agent claude
npx spec-kit-init --agent codex --locale en

# 仅查看会写入哪些路径
npx spec-kit-init --dry-run

本包在 package.json 的 bin 里注册了两个命令名，指向同一脚本：

• spec-kit-init：与包名一致，适合 npx spec-kit-init …
• init-spec-kit：与底层二进制同名，适合 npx -p spec-kit-init init-spec-kit … 或全局安装后执行 init-spec-kit

全局安装示例：

npm install -g spec-kit-init
init-spec-kit --help

常用参数（透传给 Rust CLI）

| 参数 | 说明 | |------|------| | --path DIR | 目标项目目录，默认当前目录 | | --agent | cursor（默认）、claude、codex | | --locale | zh（默认）、en | | --dry-run | 只打印将要创建的路径，不写盘 |

完整说明以 --help 为准。

如何解析 dist/ 里的二进制

启动脚本会按顺序在下列目录中查找可执行文件：

1. 环境变量 INIT_SPEC_KIT_DIST（若设置）：指向包含二进制的目录
2. npm/init-spec-kit/dist/（发布包内或本地开发时 copy 进来的目录）
3. 仓库根目录 dist/（在 monorepo 内本地链接本包时，若未把二进制打进子目录仍可使用）

在每个候选目录下：

• 优先：dist/<platform>-<arch>/init-spec-kit（Windows 为 init-spec-kit.exe）
  例如：darwin-arm64、linux-x64、win32-x64
• 否则：扁平路径 dist/init-spec-kit 或 dist/init-spec-kit.exe

<platform>-<arch> 与 Node 的 process.platform、process.arch 一致。

维护者：发布前准备

1. 在仓库根目录构建并拷贝 Rust 产物到根目录 dist/（例如运行 ./scripts/package-init-spec-kit.sh 或 Windows 下的 package-init-spec-kit.ps1）。
2. 在 npm/init-spec-kit/ 下执行 npm pack 或 npm publish。
3. prepack 会运行 scripts/stage-dist.cjs：若本地尚无可用的 ./dist，则从 ../../dist（仓库根）复制到本包 dist/，以便 tarball 内含二进制。

package.json 中 publishConfig.registry 指向 https://registry.npmjs.org/，即使本机用镜像源安装依赖，npm publish 仍会发到 npm 官方（需已登录对应账号）。

若 npm 上 spec-kit-init 名称不可用，可将 package.json 的 name 改为其他未占用名称后再发布。

说明

• 本 npm 包通过 Node spawn 调用原生二进制；verify-spec-kit 等其它可执行文件若存在于仓库 dist/ 会一并被打进发布用 dist/，但不会通过本包的 bin 脚本启动，需在安装目录或解压后的 dist/ 中直接运行。
• 更完整的背景、构建 Spec Kit 资源与 Rust 说明见本工具仓库根目录的 README.md。

许可证

MIT（与仓库声明一致）