用途:在当前项目目录中初始化 Git 仓库并创建初始提交;如果目录已经是 Git 仓库,则跳过。
主要能力:脚本内部处理检查与执行,包括在 Git 不可用时跳过、在已处于 Git 仓库内时跳过,以及运行 git init、git add . 和带初始提交信息的 git commit。成功时输出 [OK] Git repository initialized。
使用方式:从项目根目录运行对应脚本。Bash 运行 .specify/extensions/git/scripts/bash/initialize-repo.sh;PowerShell 运行 .specify/extensions/git/scripts/powershell/initialize-repo.ps1。若扩展脚本不存在,可回退到 Bash 的 git init && git add . && git commit -m "Initial commit from Specify template",或 PowerShell 的 git init; git add .; git commit -m "Initial commit from Specify template"。
定制:资料说明可替换脚本以加入项目特定的 Git 初始化步骤,例如自定义 .gitignore 模板、默认分支命名(git config init.defaultBranch)、Git LFS 设置、Git 钩子安装、提交签名配置和 Git Flow 初始化。
适用场景:需要为项目快速建立带初始提交的 Git 仓库,或在 Specify 模板项目中完成 Git 初始化流程。
限制:Git 未安装时会提示用户并跳过初始化,项目仍可在没有 Git 的情况下继续运行;若 git init、git add 或 git commit 失败,会显示错误并停止该命令,不会继续使用部分初始化的仓库。