用途:在当前项目目录中初始化 Git 仓库;若目录已经是 Git 仓库则不重复初始化,直接跳过。
用法:从项目根目录运行对应脚本。Bash 使用 .specify/extensions/git/scripts/bash/initialize-repo.sh;PowerShell 使用 .specify/extensions/git/scripts/powershell/initialize-repo.ps1。若找不到扩展脚本,可退回执行 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 init、git add . 和带初始提交信息的 git commit。
可定制:可替换脚本来加入项目特定的初始化步骤,例如自定义 .gitignore 模板、默认分支命名(git config init.defaultBranch)、Git LFS 设置、Git 钩子安装、提交签名配置以及 Git Flow 初始化。
输出:成功时提示 ✓ Git repository initialized。
限制与降级:未安装 Git 时向用户告警并跳过初始化,项目仍可继续运行,规格仍可创建在 specs/ 下;若已安装 Git 但 git init、git add . 或 git commit 失败,则向用户暴露错误并停止该命令,避免留下部分初始化的仓库。