mcpField
S
speckit-install

speckit-install

github.com/full-stack-skills开发064 次安装4 周前更新
代码仓库

关于 speckit-install

使用 uv 安装和升级 Specify CLI 的技能，涵盖持久安装到 PATH 和通过 uvx 临时运行；不负责初始化项目。

主要功能

  1. 01使用 uv 安装 Specify CLI
  2. 02通过 uvx 临时运行 Specify
  3. 03升级现有 CLI 安装
  4. 04排查安装与访问问题

适用场景

  1. 01首次设置 Spec Kit
  2. 02为 CI runner 预装 Specify CLI
  3. 03升级 CLI 安装
  4. 04解决 specify 命令缺失

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/full-stack-skills/speckit-skills --skill speckit-install

安装后在 Claude Code 中输入/speckit-install确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
examples/
ci-only-install.md
linux.md
macos.md
windows.md

详细介绍

Spec Kit 安装技能

安装 Specify CLI，使 specify 可在 PATH 中使用（或使用一次性 uvx）。此技能仅涵盖 安装 CLI；不会运行 specify init。安装后要初始化项目，请使用 speckit-initial。

适用场景

  • 首次设置 Spec Kit（“安装 Spec Kit”“安装 Specify CLI”）。
  • 需要预先安装 CLI 的 CI 或脚本。
  • 升级 CLI（uv tool install --force）。
  • 用户报告“找不到 specify 命令”或“找不到命令：specify”。

前置条件

  • uv：Astral uv，用于安装 CLI。如果尚未安装 uv，请先引导用户安装（例如，在 Linux/macOS 上运行 curl -LsSf https://astral.sh/uv/install.sh | sh，或参阅 uv 文档了解 Windows 安装方法）。
  • Python 3.11+：使用 uv 时需要（uv 通常会捆绑或使用系统 Python）。
  • Git（安装时可选；之后使用 git 执行 specify init 时必需）。

工作流

  1. 检查是否已安装

    • 建议运行 specify --version 或 specify check。如果命令成功，说明 CLI 已安装；建议使用 speckit-initial 初始化项目，或使用 speckit-check 验证环境。

  2. 持久安装（推荐）

    • 运行：uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
    • 这样，specify 就可以在所有项目中通过 PATH 使用。
    • 升级：uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git

  3. 一次性使用（不安装到 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 ... 命令重新运行。

  4. 企业或受限网络

    • 如有需要，设置 GH_TOKEN 或 GITHUB_TOKEN 以访问 GitHub API。
    • 对于 specify init（由 speckit-initial 负责处理）：使用 --github-token <token> 或环境变量。安装时，uv 可能需要网络访问权限来克隆仓库；如果出现 TLS 问题，请说明 uv/spec-kit 可能仅在明确记录的情况下支持 --skip-tls 或类似选项（除非用户处于受控环境，否则避免推荐不安全选项）。

输出

  • 持久安装：specify 可通过 PATH 使用；用户可以在任意目录中运行 specify init、specify check。
  • 一次性使用：PATH 不会发生变化；用户每次使用时都运行 uvx --from git+https://github.com/github/spec-kit.git specify ...。

后续步骤

  • 安装后：使用 speckit-initial 在项目中运行 specify init，或使用 speckit-check 验证环境。

不同环境

环境说明
Linux如有需要，先安装 uv；然后运行 uv tool install specify-cli --from git+https://github.com/github/spec-kit.git。WSL：与 Linux 相同。
macOS与 Linux 相同；如有需要，请确保 uv 可使用 Python 3.11+。
Windows安装 uv（参阅 uv 文档）；使用 PowerShell 或 cmd。初始化项目时，speckit-initial 会在需要时使用 --script ps。
企业网络 / 代理如果 GitHub API 受到限制，请使用 GH_TOKEN/GITHUB_TOKEN；确保 uv 可以访问 GitHub。
CI建议在可缓存的步骤中持久安装：uv tool install specify-cli --from git+https://github.com/github/spec-kit.git；然后在同一运行器中运行 specify init 或 specify check。

故障排除

  • 未找到 uv：请引导用户安装 uv。
  • Python 版本：uv 通常会管理 Python；如果错误提示提到 Python，请确保已安装 3.11+。
  • 网络 / SSL：检查防火墙、代理和 GitHub 访问；除非必要且有文档说明，否则不要禁用 TLS。
  • 权限错误：在 Linux/macOS 上，使用 uv 进行用户级安装通常不需要 sudo；如果使用系统 Python，可考虑进行用户级 uv 安装。

参考资料

评论

支持 Markdown