Spec Kit：从可测试意图到可追踪验收
Spec Kit 安装与更新：工具配置不等于应用部署
选择固定安装版本、正确脚本类型和明确集成，在初始化与升级时保护现有项目文件。
你将学会
- 安装的是开发工具，不是生产服务
- 在空项目中明确初始化选项
- 把升级与产品交付分开
开始前需要
- 了解基本需求、Git 与测试
- 分清本地开发和应用部署
追踪小功能从意图到证据的过程，区分流程约定与已验证行为。
先看结论
- 工具安装和应用部署是两个不同里程碑。
- 练习项目应明确指定脚本类型与助手集成。
- 版本检查不能独立证明软件包来源。
安装的是开发工具，不是生产服务
固定版本安装指南要求 Python 3.11 或更高版本，并介绍 specify-cli 的源码和 PyPI 分发方式。推荐使用 uv 管理安装，也支持 pipx。Windows 可以直接使用 PowerShell，不必依赖 WSL；仓库提供 Bash、PowerShell 和 Python 脚本变体。
应主动选择并记录发行版本与来源，不要把文档里的旧示例版本照抄成“最新推荐”。本文引用的提交标识研究依据，并不承诺它就是最适合安装的发行版。本次没有在工作区安装或升级相关工具。
在空项目中明确初始化选项
下方示例假定 Specify 已安装，并使用 PowerShell 脚本类型创建新的练习目录。更换集成前先检查安装版本支持哪些选项。学习阶段不要强制初始化当前非空仓库，应先理解将新增哪些指令和模板文件。
README 说明 --non-interactive 用于无人交互会话，--ignore-agent-tools 用于不检查助手工具而获取模板。后者不会安装或认证缺失的助手。specify version 成功只说明命令可用并报告版本，不能证明可执行文件究竟来自哪种分发渠道。
把升级与产品交付分开
README 区分 specify self check、self upgrade --dry-run 和实际 self upgrade。直接执行升级命令会进行修改，而不只是展示计划。团队更新流程前应保留本地覆盖配置、检查兼容性，并记录旧安装与项目状态以便恢复。
初始化 Spec Kit 文档不会让生成的应用自动上线。应用构建、测试、配置、部署和部署后验收仍属于目标项目的交付工作。本教程没有创建云资源、安装仓库钩子、安装软件包或发布真实服务。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
记录选定发行版和支持的运行环境。
- 2
初始化新的可丢弃目录。
- 3
检查生成文件与助手可用性。
- 4
真正更新前先预览升级操作。
可复制示例
specify version
specify init speckit-practice --integration copilot --script ps --non-interactive
specify self check
specify self upgrade --dry-run常见问题
Windows 必须使用 WSL 吗？
所检查的指南支持在 Windows 直接使用 PowerShell 脚本。
--ignore-agent-tools 会安装助手吗？
不会，它只是跳过工具检查，不提供助手或认证。
资料来源
- Spec Kit / docs/installation.md来源核查 2026-09-14
- Spec Kit / README.md来源核查 2026-09-14