news 2026/6/9 22:02:27

【规范驱动的开发方式】之【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/6/9 16:18:15

注意力机制的演化

一、注意力机制的起源&#xff1a;为什么需要它&#xff1f; 问题背景&#xff1a; Seq2Seq的瓶颈2014年之前&#xff0c;序列到序列任务&#xff08;如机器翻译&#xff09;用的是编码器-解码器架构&#xff1a; 输入: "我 爱 北京"↓[Encoder RNN]↓ 固定长度向量 …

作者头像 李华
网站建设 2026/6/8 13:08:14

软件测试面试题集合

软件测试面试题,这是一份集锦&#xff0c;也是一份软件测试人员 学习的好工具书&#xff0c;非常实用。 01. 为什么要在一个团队中开展软件测试 工作&#xff1f; 因为没有经过测试的软件很难在发布之前知道该软件的质量&#xff0c;就好比 ISO 质量认证一样&#xff0c;测试同…

作者头像 李华
网站建设 2026/6/3 23:40:46

OpenVSCode Server终极性能调优与资源管理完整指南

OpenVSCode Server终极性能调优与资源管理完整指南 【免费下载链接】openvscode-server 项目地址: https://gitcode.com/gh_mirrors/op/openvscode-server OpenVSCode Server作为基于浏览器的代码编辑器服务器&#xff0c;其性能表现直接影响开发效率。本文将为您提供一…

作者头像 李华
网站建设 2026/6/9 6:01:41

【系统微服务化】

微服务化改造的关键步骤 圈定服务边界与数据表 确定微服务包含哪些数据表是改造的第一步。库存服务涉及15张表&#xff0c;包括自营库存表、商家虚拟库存表等。这些表与商品基本信息表关联较弱&#xff0c;便于独立拆分。业务架构师和数据架构师需深入分析业务场景和表关系&…

作者头像 李华
网站建设 2026/6/6 14:01:25

高可用架构(一)

高可用架构改造要点总结 针对小程序点餐平台的高并发场景&#xff08;10万QPS、500万日订单、99.99%可用性&#xff09;&#xff0c;以下是关键改造措施&#xff1a; 前端接入优化CDN加速静态资源 商品图片等静态数据通过多地CDN节点分发&#xff0c;减少服务端负载。Nginx集群…

作者头像 李华