news 2026/2/12 12:09:42

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

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
【规范驱动的开发方式】之【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)。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/2/7 18:13:23

day35打卡

浙大疏锦行

作者头像 李华
网站建设 2026/2/7 19:27:03

走向场景,走向融合:2025年末国产大模型的平台化竞赛与Agent新范式

目录 1 写作口径与方法&#xff1a;只谈“2025年12月仍在主推/可用”的国产大模型 1.1 为什么必须卡在“2025年12月最新”这个时间点 1.2 “不出现老旧模型”的执行标准 2 2025年末国产大模型的共同转向&#xff1a;从“会写”到“会做” 2.1 语言大模型正在变成“推理与执…

作者头像 李华
网站建设 2026/2/7 0:00:06

【time-rs】Duration 结构体详解

这是一个 Rust 时间库中的 Duration 结构体实现&#xff0c;提供高精度的时间跨度表示。 1. 主要特性 纳秒级精度&#xff1a;由整秒和纳秒部分组成支持负值&#xff1a;与标准库的 std::time::Duration 不同&#xff0c;支持负时间间隔安全边界检查&#xff1a;使用 RangedI32…

作者头像 李华
网站建设 2026/2/12 7:33:46

10398_基于SSM的教学评价管理系统

1、项目包含项目源码、项目文档、数据库脚本、软件工具等资料&#xff1b;带你从零开始部署运行本套系统。2、项目介绍教学评价系统是以Java平台作为开发环境&#xff0c;采用MySQL数据库作为后台&#xff0c;使用Eclipse作为开发工具进行设计。本系统主要实现了教学评价模块、…

作者头像 李华
网站建设 2026/2/8 2:37:56

Go语言变量

Go变量声明的核心机制 静态类型语言要求变量在使用前必须声明&#xff0c;明确内存边界。Go作为静态语言&#xff0c;通过变量声明实现这一机制&#xff1a; 变量绑定特定内存区域&#xff0c;类型信息确定操作边界声明形式为&#xff1a;var 变量名 类型 值未显式初始化时自动…

作者头像 李华
网站建设 2026/2/8 19:52:39

【高可用系统架构】

系统高可用实现手段 冗余与无单点设计 部署关键节点时避免单点故障&#xff0c;例如负载均衡采用双节点Keepalived方案&#xff08;如Nginx/HAProxy/LVS&#xff09;&#xff0c;通过虚拟IP实现故障自动切换。网络通信配置多线路&#xff08;如移动电信双线&#xff09;&#x…

作者头像 李华