SuperAPI AI 工具集

speckit-install

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:安装 Specify CLI,使 specify 命令可在 PATH 中使用,或通过 uvx 一次性运行。该技能只负责安装 CLI,不运行 specify init;项目初始化需使用 speckit-initial。

适用场景:首次配置 Spec Kit(如“install Spec Kit”“install Specify CLI”);CI 或脚本中预装 CLI;升级 CLI(uv tool install --force);用户遇到“specify command not found”。

前置条件:需要 uv(Astral uv)来安装 CLI,未安装时先引导安装,例如 Linux/macOS 执行 curl -LsSf https://astral.sh/uv/install.sh | sh,Windows 参见 uv 文档;使用 uv 时需 Python 3.11+;Git 对安装可选,但后续 specify init 配合 git 时需要。

工作流:先检查是否已安装,可运行 specify --version 或 specify check,成功则说明已安装,建议改用 speckit-initial 或 speckit-check。持久安装(推荐)执行 uv tool install specify-cli --from git+https://github.com/github/spec-kit.git,使 specify 在所有项目中可用;升级执行 uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git。一次性使用(不写入 PATH)执行 uvx --from git+https://github.com/github/spec-kit.git specify init <project_name_or_.> --ai <agent>,适合快速试用或 CI 单次运行;同一会话中后续 specify init 或 specify check 可复用相同 uvx 前缀,未安装时需重新带完整 uvx --from ...。

企业或受限网络:如 GitHub API 受限,可设置 GH_TOKEN 或 GITHUB_TOKEN;安装时 uv 需能克隆仓库,若出现 TLS 问题,仅在明确文档支持时考虑 --skip-tls 等选项,避免在非受控环境推荐不安全做法。

输出:持久安装后 specify 在 PATH 中,可在任意目录运行 specify init、specify check;一次性方式不改变 PATH,每次需使用 uvx --from git+https://github.com/github/spec-kit.git specify ...。

不同环境:Linux 与 WSL 相同,先装 uv 再执行持久安装命令;macOS 同 Linux,确保 Python 3.11+;Windows 安装 uv 后使用 PowerShell 或 cmd,项目初始化时 speckit-initial 会在需要时使用 --script ps;企业/代理环境使用 GH_TOKEN/GITHUB_TOKEN 并确保 uv 可访问 GitHub;CI 建议在可缓存步骤中持久安装,再在同一 runner 运行 specify init 或 specify check。

故障排查:uv 未找到则引导安装 uv;Python 版本报错时确保 3.11+;网络/SSL 问题检查防火墙、代理与 GitHub 访问,非必要不关闭 TLS;Linux/macOS 权限错误通常无需 sudo,使用 uv 用户级安装即可。

限制:该技能不执行 specify init,不负责项目初始化;具体收费、价格、平台支持范围等资料暂未提供。