spec-kit 教程｜第 09

页内导航

你要查命令、做对比，还是找 FAQ？

本页支持按章节跳转，也适合当成教程末尾的统一参考区来使用。

第 9 章 常用命令速查表

快速查 CLI、斜杠命令与 V-Model 扩展命令。

第 10 章 与 OpenSpec 的对比

理解两个工具的定位差异与适用场景。

第 11 章 常见问题 FAQ

集中回答初始化、模板、协作与扩展相关问题。

适用场景

当你已经理解流程，但记不清具体命令时，优先来查这一章。

9.1 CLI 命令（终端执行）

核心命令（基于 specify --help 实测确认）：

命令	说明
`specify init <name> --ai claude`	初始化项目
`specify check`	检查所有依赖工具是否已安装
`specify version`	查看版本和系统信息
`specify extension`	管理扩展（子命令组）
`specify preset`	管理预设（子命令组）

9.2 扩展管理子命令

这些命令经过用户实测确认。

命令	说明
`specify extension list`	查看已装扩展
`specify extension add <name>`	安装扩展
`specify extension remove <name>`	卸载扩展
`specify extension search <keyword>`	搜索扩展
`specify extension info <name>`	查看扩展详情
`specify extension update <name>`	更新扩展
`specify extension enable <name>`	启用扩展
`specify extension disable <name>`	禁用扩展（不卸载）
`specify extension set-priority <name> N`	调整扩展优先级
`specify extension catalog`	管理扩展目录

9.3 预设管理子命令

这些命令同样经过用户实测确认。

命令	说明
`specify preset search <keyword>`	搜索预设
`specify preset add <name> --priority N`	安装预设
`specify preset list`	查看已装预设
`specify preset info <name>`	查看预设详情
`specify preset set-priority <name> N`	调整优先级
`specify preset enable <name>`	启用预设
`specify preset disable <name>`	禁用预设（不卸载）
`specify preset resolve <template>`	查看模板解析顺序
`specify preset remove <name>`	卸载预设
`specify preset catalog list/add/remove`	管理预设目录

9.4 斜杠命令（Claude Code 内执行）

命令	阶段	核心产出
`/speckit.constitution`	定宪法	`.specify/memory/constitution.md`
`/speckit.specify`	写规格	`specs/NNN-xxx/spec.md`
`/speckit.clarify`	澄清	更新后的 `spec.md`
`/speckit.plan`	做计划	`plan.md` + `data-model.md` + `contracts/`
`/speckit.tasks`	拆任务	`tasks.md`
`/speckit.implement`	写代码	实际代码文件
`/speckit.analyze`	做检查	一致性分析报告
`/speckit.checklist`	核对	质量检查清单
`/speckit.taskstoissues`	转 Issue	GitHub Issues

9.5 V-Model 扩展命令

命令	配对关系
`/speckit.v-model.requirements`	需求编号 →
`/speckit.v-model.acceptance`	→ 验收测试
`/speckit.v-model.system-design`	系统设计 →
`/speckit.v-model.system-test`	→ 系统测试
`/speckit.v-model.architecture-design`	架构设计 →
`/speckit.v-model.integration-test`	→ 集成测试
`/speckit.v-model.module-design`	模块设计 →
`/speckit.v-model.unit-test`	→ 单元测试
`/speckit.v-model.trace`	全量追溯矩阵

一句话理解

spec-kit 更偏完整规范体系与多角色协作，OpenSpec 更偏轻量快速和存量项目增量改进。

10.1 对比总表

维度	spec-kit	OpenSpec
维护方	GitHub 官方	Fission AI
工作流阶段	5 个核心 + 3 个可选	3 个（Propose-Apply-Archive）
适合项目类型	新项目为主，也支持存量	存量项目（brownfield）为主
文档产出量	~800 行（全面细致）	~250 行（精简快速）
测试集成	V-Model 扩展 + Analyze 检查	无内置测试机制
AI 行为约束	宪法 + 模板注入	规格文件引导
扩展生态	30+ 扩展 + 预设系统	自定义工作流
上手时间	约 30 分钟	约 5 分钟
变更追踪	独立功能目录（完整重写）	Delta 标记（ADDED/MODIFIED/REMOVED）
支持 AI 工具	27+ 种	主要面向 Claude Code

10.2 选择建议

需要测试同学深度参与：优先选 spec-kit（可用 V-Model 扩展）。
追求轻量快速迭代：OpenSpec 会更轻。
大团队、多角色协作：spec-kit 更清晰。
在存量代码库上增量改进：OpenSpec 的 Delta 机制更合适。

11.1 Q1：spec-kit 只能配合 Claude Code 使用吗？

不是。spec-kit 支持 27+ 种 AI 编码工具，包括 GitHub Copilot、Cursor、Gemini CLI、Windsurf 等。安装时通过 --ai 参数指定你使用的工具即可。

11.2 Q2：宪法文件需要经常改吗？

一般不需要。宪法定义的是不可动摇的项目基本原则。如果需要修改，应该经过团队评审，并通过 /speckit.constitution 进行版本化更新。

11.3 Q3：spec-kit 可以用在已有项目上吗？

可以。在项目根目录运行 specify init . --ai claude 即可。它不会修改现有代码，只会添加 .specify/、.claude/ 和 specs/ 目录。

11.4 Q4：多人同时用 spec-kit 会冲突吗？

不会。每个功能都有独立编号目录，例如 specs/001-xxx/、specs/002-xxx/，不同人负责不同功能时互不干扰，Git 分支也按功能隔离。

11.5 Q5：V-Model 扩展是必须装的吗？

不是必须。如果团队有测试角色，并希望测试在早期介入，强烈建议安装；如果只是简单 CRUD 开发，核心流程通常已经足够。

11.6 Q6：spec-kit 的模板可以自定义吗？

可以。你可以把同名模板放到 .specify/templates/overrides/ 中进行项目级覆盖，也可以通过 Preset 系统统一管理多套模板配置。

11.7 Q7：生成的 specs/ 目录需要提交到 Git 吗？

需要。这是 spec-kit 的核心价值之一：规格文件要作为代码库的一部分永久保留，让新同事和新的 AI 对话都能持续读取历史决策。

文档说明

本教程基于 spec-kit v0.4.3（2026-03-26 发布）编写。本页为参考页，重点面向查阅和统一答疑。

阅读闭环

参考篇读完后，这套教程的主体结构就完整了

现在你已经拥有：基础篇（01–03）、核心主线（04）、进阶与角色页（05–08）以及参考篇（09–11）。

上一章 第 8 章 · 实战演练

回看完整案例演练，把主线流程再跑一遍。

返回入口 教程首页

回到入口页，查看全部章节导航。

命令速查、对比选型与常见问题