news 2026/4/4 10:36:16

【规范驱动的开发方式】之【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/3/29 1:52:34

鸿蒙PC UI控件库 - TextInput 文本输入框详解

视频地址&#xff1a; https://www.bilibili.com/video/BV1jomdBBE4H/ &#x1f4cb; 目录 概述特性快速开始API 参考使用示例主题配置最佳实践常见问题总结 概述 TextInput 是控件库中的基础文本输入框组件&#xff0c;支持验证、提示、图标、多种尺寸和状态&#xff0c;…

作者头像 李华
网站建设 2026/4/3 13:42:58

夜莺监控设计思考(三)时序库、agent 的一些设计考量

夜莺和 agent 对接的设计逻辑夜莺和时序库对接的设计逻辑如果是夜莺老用户&#xff0c;应该知道在 V4 以及之前的版本&#xff0c;夜莺是有自研时序库的。而 V5 开始放弃了自研时序库&#xff0c;转而做各类数据源的对接&#xff0c;这其中是怎么一个考虑&#xff1f;V4 之前的…

作者头像 李华
网站建设 2026/3/15 12:09:06

华为OD机试双机位C卷 - 去除多余空格 (C++ Python JAVA JS GO)

去除多余空格 2025华为OD机试双机位B卷 - 华为OD上机考试双机位B卷 200分题型 华为OD机试双机位C卷真题目录点击查看: 华为OD机试双机位C卷真题题库目录&#xff5c;机考题库 算法考点详解 题目描述 去除文本多余空格&#xff0c;但不去除配对单引号之间的多余空格。给出关…

作者头像 李华
网站建设 2026/4/3 19:06:55

TDengine 新性能基准测试工具 taosgen

从 3.3.7.0 开始&#xff0c;在 TDengine 安装包中多了一个新工具 taosgen, 此工具是替换 taosBenchmark 的新的基准性能测试工具&#xff0c;taosgen 支持数据生成、写入性能测试等功能。taosgen 以“作业”为基础单元&#xff0c;作业是由用户定义&#xff0c;用于完成特定任…

作者头像 李华
网站建设 2026/4/3 18:32:18

JavaWeb-Request应用与Cookie[特殊字符]️Session

HtttpServletRequest代表客户端的请求&#xff0c;用户通过Http协议访问服务器&#xff0c;HTTP请求中的所有信息会被封装到HttpServlertRequest&#xff0c;通过这个HttpServlertRequest方法&#xff0c;获得客户端的所有信息&#xff1b; 获取前端传递的参数请求转发 LoginSe…

作者头像 李华