用途:在项目首次启用 Spec Kit,或切换 AI Agent、在新目录或已有目录中初始化时使用。
主要能力:运行 specify init 拉取 .specify/ 目录(含 memory、scripts、templates、specs),并向所选 AI Agent 注册 /speckit.* 斜杠命令。
前置条件:需已安装 Specify CLI(见 speckit-install);若 specify 不在 PATH,先引导用户运行 speckit-install。Git 可选,非 git 仓库或跳过 git 设置时用 --no-git。
常用参数:--ai 指定 Agent(claude、cursor-agent、gemini、copilot、windsurf、qwen、opencode、codex、qoder、amp、shai、bob、kilocode、auggie、roo、codebuddy);--script 选 sh(默认)或 ps(Windows PowerShell);目标可为 . 或 --here(当前目录)或 <project_name>(新子目录);--force 覆盖已有 .specify/;--no-git 跳过 git 设置;--ignore-agent-tools 只拉模板与结构;--github-token 或 GITHUB_TOKEN 用于私有仓库或限流。
示例:specify init . --ai cursor-agent;specify init . --ai claude;specify init . --ai copilot --script ps;specify init my-app --ai gemini。
输出:项目生成 .specify/ 目录,所选 Agent 中出现 /speckit.constitution、/speckit.specify、/speckit.plan 等斜杠命令。
后续:可运行 speckit-check 验证环境,再用 speckit-constitution 或 speckit-specify 开始工作流。
限制与排错:specify 未找到需先安装 CLI;Windows 斜杠命令未出现需确认使用 --script ps 且 Agent 配置为从项目加载命令;私有仓库或限流需设置 GITHUB_TOKEN 或 --github-token。