live-dev-init

live-dev-init

此技能用于初始化开发环境，并在运行任何其他部署或配置任务前执行预检。

bash 代码块使用 POSIX 语法（Windows 上使用 Git Bash）。任何超过一条命令或管道的逻辑都放在 resources/*.js 中（如适用），绝不使用 shell 控制流。如果你的 Bash 工具是 cmd.exe 或 PowerShell，请在运行前转换每个代码片段。

1. 预检（规划前静默运行）

检查项	探测命令	失败时
git、gh	command -v git、command -v gh、gh auth status	运行 scripts/install-git-gh-macos.command | scripts/install-git-gh-windows.ps1。切勿自行编造安装步骤。
node	node --version ≥ scripts/toolchain/catalog.json:node_lts_major	scripts/course-toolchain-macos.command base | scripts/course-toolchain-windows.ps1 -Profile base
vercel、firebase	npx vercel whoami、npx firebase login:list	npm install -D vercel@latest firebase-tools（切勿使用 -g：会导致 EACCES）。设置配置或部署前必须先通过登录检查。
gitleaks	command -v gitleaks	按下表安装，重新探测，绝不跳过扫描关卡

操作系统	安装方式	备用方案
macOS	brew install gitleaks — brew 可能不存在（课程安装程序使用 Xcode CLT + curl，而非 brew）	下载最新版本 gitleaks_*_darwin_$(uname -m).tar.gz → 解压到 ~/.local/bin（创建目录，并在 shell 配置文件中不存在相关条目时追加）。不使用 sudo，不使用 /usr/local/bin。
Windows	winget install gitleaks.gitleaks	下载 gitleaks_*_windows_x64.zip → 解压 gitleaks.exe → 放入 %USERPROFILE%\bin → setx PATH "%PATH%;%USERPROFILE%\bin"。~/.local/bin 和 shell 配置文件在此处不适用。

然后修复项目状态：

文件 / 状态	必需值	备注
.nvmrc	catalog.json:node_lts_major	唯一事实来源。resources/vercel-preview.yml 使用 node-version-file: '.nvmrc' 读取版本 — 绝不要在 yml 中硬编码 Node 主版本。
.gitignore	.env、.env.local、.env*.local、服务账号 JSON glob	必须在首次提交生成前修复 — 保管库策略假定这些文件已被忽略。
分支	develop 分支存在（否则建议从 main 创建）；从 develop 分出 feature/<name> 分支进行开发

密钥保管库策略（硬性规则，不可覆盖）。 凭据只能存放在 Vercel Env Vars / GitHub Secrets / 被 git 忽略的 .env.local 中。绝不在代码中硬编码，绝不提交真实的 .env 值，绝不在聊天、日志或提交消息中打印真实密钥。