用途:在项目中首次启用 Spec Kit,或切换 AI Agent、在新目录或已有目录中初始化。前提是 Specify CLI 已安装;若未安装,应先执行 speckit-install。
主要能力:运行 specify init 后,项目会生成 .specify/ 目录(含 memory、scripts、templates、specs),并在所选 AI Agent 中注册 /speckit.* 斜杠命令(如 /speckit.constitution、/speckit.specify、/speckit.plan)。
使用方式:常用参数包括 --ai(必填,可选 claude、cursor-agent、gemini、copilot、windsurf、qwen、opencode、codex、qoder、amp、shai、bob、kilocode、auggie、roo、codebuddy)、--script(sh 默认,或 ps)、--force(覆盖已有 .specify/)、--no-git、--ignore-agent-tools、--github-token 或 GITHUB_TOKEN。目标可为当前目录(specify init . 或 --here)或新子目录(specify init <project_name>)。示例:specify init . --ai cursor-agent;specify init . --ai claude;specify init . --ai copilot --script ps;specify init my-app --ai gemini。
适用场景:首次初始化、切换 Agent、Windows 需要 PowerShell 脚本、私有仓库或限流访问。
限制:需先安装 Specify CLI;Git 可选,非 git 仓库可用 --no-git;--force 会覆盖已有 .specify/,需谨慎;Windows 斜杠命令未出现时需确认使用了 --script ps 且 Agent 配置为从项目加载命令。完成后可运行 speckit-check 验证环境,再用 speckit-constitution 或 speckit-specify 开始工作流。