安装指南

前置要求

Linux/macOS(或 Windows; 现在支持 PowerShell 脚本, 无需 WSL)
AI编码助手: Claude Code , GitHub Copilot , Codebuddy CLI 或 Gemini CLI
uv 用于包管理
Python 3.11+
Git

安装

初始化新项目

最简单的入门方式是初始化一个新项目:


uvx --from git+https://github.com/linfee/spec-kit-cn.git specify-cn init <PROJECT_NAME>

或者在当前目录中初始化:


uvx --from git+https://github.com/linfee/spec-kit-cn.git specify-cn init .
# 或使用 --here 标志
uvx --from git+https://github.com/linfee/spec-kit-cn.git specify-cn init --here

指定 AI 助手

你可以在初始化时主动指定你的 AI 助手:


uvx --from git+https://github.com/linfee/spec-kit-cn.git specify-cn init <project_name> --ai claude
uvx --from git+https://github.com/linfee/spec-kit-cn.git specify-cn init <project_name> --ai gemini
uvx --from git+https://github.com/linfee/spec-kit-cn.git specify-cn init <project_name> --ai copilot
uvx --from git+https://github.com/linfee/spec-kit-cn.git specify-cn init <project_name> --ai codebuddy

指定脚本类型(Shell vs PowerShell)

所有自动化脚本现在同时提供 Bash(.sh)和 PowerShell(.ps1)两种变体.

自动行为:

Windows 默认: ps
其他操作系统默认: sh
交互模式: 除非你传递 --script 参数, 否则会提示你选择

强制指定特定脚本类型:


uvx --from git+https://github.com/linfee/spec-kit-cn.git specify-cn init <project_name> --script sh
uvx --from git+https://github.com/linfee/spec-kit-cn.git specify-cn init <project_name> --script ps

忽略助手工具检查

如果你希望获取模板而不检查正确的工具:


uvx --from git+https://github.com/linfee/spec-kit-cn.git specify-cn init <project_name> --ai claude --ignore-agent-tools

验证

初始化后, 你应该在 AI 助手中看到以下可用命令:

/speckit.specify - 创建规范
/speckit.plan - 生成实施计划
/speckit.tasks - 分解为可执行任务

.specify/scripts 目录将同时包含 .sh 和 .ps1 脚本.

故障排除

Linux 上的 Git 凭据管理器

如果你在 Linux 上遇到 Git 身份验证问题, 可以安装 Git 凭据管理器:


#!/usr/bin/env bash
set -e
echo "正在下载Git凭据管理器v2.6.1..."
wget https://github.com/git-ecosystem/git-credential-manager/releases/download/v2.6.1/gcm-linux_amd64.2.6.1.deb
echo "正在安装Git凭据管理器..."
sudo dpkg -i gcm-linux_amd64.2.6.1.deb
echo "正在配置Git使用GCM..."
git config --global credential.helper manager
echo "正在清理..."
rm gcm-linux_amd64.2.6.1.deb