live-dev-init

live-dev-init

このスキルは、ほかのデプロイや設定作業を実行する前に、開発環境を初期化し、事前チェックを行います。

bash ブロックは POSIX 形式です（Windows では Git Bash）。1 つのコマンド／パイプを超えるロジックは、該当する場合、シェルの制御フローではなく resources/*.js に記述します。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	下の表に従ってインストールし、再確認します。スキャンの必須ゲートを省略してはいけません。

OS	インストール	代替手段
macOS	brew install gitleaks — brew が使えない場合があります（コースのインストーラーは brew ではなく、Xcode CLT + curl を使用します）	最新リリースの gitleaks_*_darwin_$(uname -m).tar.gz を curl で取得 → ~/.local/bin に展開します（ディレクトリを作成し、存在しない場合はシェルプロファイルに追記します）。sudo および /usr/local/bin は使用しません。
Windows	winget install gitleaks.gitleaks	gitleaks_*_windows_x64.zip をダウンロード → gitleaks.exe を展開 → %USERPROFILE%\bin に配置 → setx PATH "%PATH%;%USERPROFILE%\bin" を実行します。~/.local/bin とシェルプロファイルはここでは使用できません。

続いて、プロジェクトの状態を修復します。

ファイル／状態	必須の値	備考
.nvmrc	catalog.json:node_lts_major	唯一の信頼できる情報源です。resources/vercel-preview.yml は node-version-file: '.nvmrc' を読み取ります。yml に Node のメジャーバージョンをハードコードしてはいけません。
.gitignore	.env、.env.local、.env*.local、サービスアカウント JSON の glob	最初のコミットを作成する前に修復してください。Vault ポリシーでは、これらが無視されていることが前提です。
ブランチ	develop が存在すること（なければ main から作成するよう提案する）。develop から feature/<name> を作成して作業すること

Secret Vault Policy（絶対ルール、例外なし）。 認証情報は Vercel Env Vars／GitHub Secrets／gitignore 対象の .env.local にのみ保存します。コードにハードコードしたり、実際の .env の値をコミットしたり、実際のシークレットをチャット、ログ、コミットメッセージに出力したりしてはいけません。