【规范驱动的开发方式】之【spec-kit】 的安装入门指南
【规范驱动的开发方式】之【spec-kit】 的安装入门指南
前言：
安装新python 3.14.2
在 官网下载 python的最新版本，安装推荐的方式完成。
新旧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 相关路径：
# 列出PATH中包含Python的路径$env:PATH-split';'|Where-Object{$_-match'Python'}输出会类似：
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 路径：点击「新建」，粘贴
C:\Users\Administrator\AppData\Local\Programs\Python\Python314 （如果需要pip，再新建） C:\Users\Administrator\AppData\Local\Programs\Python\Python314\Scripts）调整优先级：选中刚添加的 3.14 路径，点击「上移」按钮，直到它出现在所有 Python 3.10 路径的上方；
示例调整后顺序：
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，输入：
$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
进入虚拟环境
PSC:\Users\Administrator> d:PSD:\> cd.\GithubOFAi\PSD:\GithubOFAi> cd.\specify\PSD:\GithubOFAi\specify>lsPSD:\GithubOFAi\specify> python--version Python 3.14.2PSD:\GithubOFAi\specify> python-m venv venvPSD:\GithubOFAi\specify>lsDirectory: D:\GithubOFAi\specify Mode LastWriteTime Length Name---------------------------d----2025/12/13 14:46 venvPSD:\GithubOFAi\specify>.\venv\Scripts\activate(venv)PSD:\GithubOFAi\specify>看到(venv) PS D:\GithubOFAi\specify>说明完成切换到虚拟环境。
设置国内pip镜像 （临时）
新的python默认连接到pypi.org，可是国内环境无法直接访问，所以要设置国内pip镜像，我们临时设置用当前的powershell：
pip install requests-i https://mirrors.aliyun.com/pypi/simple/永久生效需要重启一下，我这里用临时方式，避免重启和不必要的等待。
安装UV工具 (也可以指定源）
pip install uv-i https://pypi.tuna.tsinghua.edu.cn/simple/我的执行结果：
(venv)PSD:\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)PSD:\GithubOFAi\specify>安装 Specify CLI:
uv tool install specify-cli--fromgit+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之后用命令：
# Create new projectspecify init<PROJECT_NAME># Or initialize in existing projectspecify init.--ai claude# orspecify init --here --ai claude# Check installed toolsspecify 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）。