【规范驱动的开发方式】之【spec-kit】的安装入门指南

前言：

安装新python 3.14.2

新旧python共存，设置默认python到最新版（当前最新：3.14.2）

当前python --version输出 3.10.11，说明PATH中存在 Python 3.10 的路径，且优先级高于 3.14。你只需找到PATH中 3.10 的路径，将 3.14 的路径移到它前面，就能让python默认指向 3.14.2。

具体操作步骤（Windows PowerShell）

步骤 1：先找到PATH中已有的 Python 路径

执行以下命令，查看当前PATH中所有 Python 相关路径：

powershell 复制代码

# 列出PATH中包含Python的路径
$env:PATH -split ';' | Where-Object { $_ -match 'Python' }

输出会类似：

plaintext 复制代码

C:\Users\Administrator\AppData\Local\Programs\Python\Python310
C:\Users\Administrator\AppData\Local\Programs\Python\Python310\Scripts

这就是导致python指向 3.10 的根源（3.10 路径在PATH中，且 3.14 路径未添加 / 优先级低）。

步骤 2：修改PATH变量（调整优先级）

打开环境变量设置（Win+R → sysdm.cpl → 高级 → 环境变量）；win10以上版本直接在设置搜索"环境变量"；

在「用户变量」（优先改用户变量，避免影响系统）中找到Path，点击「编辑」；

步骤3：添加 3.14 路径：点击「新建」，粘贴

plaintext 复制代码

C:\Users\Administrator\AppData\Local\Programs\Python\Python314
（如果需要pip，再新建）
C:\Users\Administrator\AppData\Local\Programs\Python\Python314\Scripts）

调整优先级：选中刚添加的 3.14 路径，点击「上移」按钮，直到它出现在所有 Python 3.10 路径的上方；

示例调整后顺序：

plaintext 复制代码

C:\Users\Administrator\AppData\Local\Programs\Python\Python314
C:\Users\Administrator\AppData\Local\Programs\Python\Python314\Scripts
C:\Users\Administrator\AppData\Local\Programs\Python\Python310
C:\Users\Administrator\AppData\Local\Programs\Python\Python310\Scripts

点击「确定」保存所有设置（需关闭所有 PowerShell 窗口重新打开才会生效）。

在powershell中刷新PATH （不想重启就使用新的PATH变量）

关闭之前的powershell，打开新的powersell，输入：

powershell 复制代码

$env:PATH = [Environment]::ExpandEnvironmentVariables([Environment]::GetEnvironmentVariable("PATH", "User") + ";" + [Environment]::GetEnvironmentVariable("PATH", "Machine"))

关键说明
生效范围： 以上方法仅对当前 PowerShell 会话生效，其他已打开的 PowerShell/CMD 窗口仍需手动执行该命令，或关闭重启。
优先级： 如果刚把 Python 3.14 的路径移到 PATH 顶部，执行刷新命令后，当前会话的python会立即指向 3.14.2。

最后，可以看到 python --version # 输出显示3.14.2

进入虚拟环境

powershell 复制代码

PS C:\Users\Administrator> d:
PS D:\> cd .\GithubOFAi\
PS D:\GithubOFAi> cd .\specify\
PS D:\GithubOFAi\specify> ls
PS D:\GithubOFAi\specify> python --version
Python 3.14.2
PS D:\GithubOFAi\specify> python -m venv venv
PS D:\GithubOFAi\specify> ls

    Directory: D:\GithubOFAi\specify

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d----          2025/12/13    14:46                venv

PS D:\GithubOFAi\specify> .\venv\Scripts\activate
(venv) PS D:\GithubOFAi\specify>

看到 (venv) PS D:\GithubOFAi\specify> 说明完成切换到虚拟环境。

设置国内pip镜像（临时）

新的python默认连接到pypi.org，可是国内环境无法直接访问，所以要设置国内pip镜像，我们临时设置用当前的powershell：

powershell 复制代码

pip install requests -i https://mirrors.aliyun.com/pypi/simple/

永久生效需要重启一下，我这里用临时方式，避免重启和不必要的等待。

安装UV工具 (也可以指定源）

powershell 复制代码

pip install uv -i https://pypi.tuna.tsinghua.edu.cn/simple/

我的执行结果：

powershell 复制代码

(venv) PS D:\GithubOFAi\specify> pip install uv -i https://pypi.tuna.tsinghua.edu.cn/simple/
Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple/
Collecting uv
  Downloading https://pypi.tuna.tsinghua.edu.cn/packages/08/a0/ab5b1850197bf407d095361b214352e40805441791fed35b891621cb1562/uv-0.9.17-py3-none-win_amd64.whl (22.1 MB)
     ---------------------------------------- 22.1/22.1 MB 49.9 MB/s  0:00:00
Installing collected packages: uv
Successfully installed uv-0.9.17
(venv) PS D:\GithubOFAi\specify>

安装 Specify CLI:

powershell 复制代码

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

如果你没法访问github，可以使用gitee：

地址为：https://gitee.com/boomer001/spec-kit

该地址为528次提交，最新的请自行搜索。

如果希望使用中文的同学，可以使用中文版：
https://github.com/Linfee/spec-kit-cn

由于我使用的是qwen cli，所以我用的是qwen的模板，我已经下载好并且分享在这里，节省100个人的2分钟，也就帮世界节省了200分钟了。

安装好specify之后用命令：

bash 复制代码

# Create new project
specify init <PROJECT_NAME>

# Or initialize in existing project
specify init . --ai claude
# or
specify init --here --ai claude

# Check installed tools
specify check

选择你正在使用的CLI工具。

然后可以使用以下步骤进行项目的初始化：(原文）

Use the /speckit.constitution command to create your project's governing principles and development guidelines that will guide all subsequent development.

Use the /speckit.specify command to describe what you want to build. Focus on the what and why, not the tech stack.

Use the /speckit.plan command to provide your tech stack and architecture choices.

Use /speckit.tasks to create an actionable task list from your implementation plan.

Use /speckit.implement to execute all tasks and build your feature according to the plan.

翻译成人话：就是通过以上步骤，那么可以将开发代码前就把项目计划和细节写好。从文档中把项目的主要方向和脉络都统统写成文字和文档。然后再进行编码去实现。

结束语：

作为人类，我们只需要把文档写好，然后通过自动化CLI编码助手去完成实际的编码工作。当然，调试和修改肯定是不可避免的，但是只要更加进一步地把文档细致化，肯定能对软件开发工程有非常积极的贡献。

我个人认为这种方向是正确的，以后的编码工作肯定不是一点一滴地需要人类去介入源代码，而是更多的是高屋建瓴，思想指导，以及规范和框架来约束AI的工作，指挥AI去工作的。

时间有限，我今天先分享到这里。后面我会用实际项目来检验一下这个方向的软件开发的核心哲学（原文的话：Core Philosophy）。

【规范驱动的开发方式】之【spec-kit】 的安装入门指南