大家好,我是拾光,很高兴认识你,在此和大家分享一些平日里做的一些事情你是否平时Vibe Coding写代码时没有清晰规范,没有统一标准,想到哪写到哪,后期难维护、难测试、难协作,那么这个项目Spec Kit将十分适配你未来的构思。
项目介绍
更快地构建高质量软件
一个开源工具包,让你专注于产品场景和可预测的结果,而不是从零开始逐个编写代码。
驱动规范的开发颠覆了传统的软件开发模式。几十年来,代码一直处于主导地位——规范只是我们在开始真正的编码工作后构建和丢弃的脚手架。驱动规范的开发改变了这一点:规范变得可执行,直接生成可工作的实现,而不仅仅是指导它们。
开始使用
选项 1:持久安装(推荐)
Install once and use everywhere. Pin a specific release tag for stability (check Releases for the latest):
安装一次,随处使用。固定一个特定的版本标签以确保稳定性(查看 Releases 获取最新版本):
# Install a specific stable release (recommended — replace vX.Y.Z with the latest tag)uv tool install specify-cli--fromgit+https://github.com/github/spec-kit.git@vX.Y.Z# Or install latest from main (may include unreleased changes)uv tool install specify-cli--fromgit+https://github.com/github/spec-kit.git
Then use the tool directly:
然后直接使用该工具:
# Create new project specify init <PROJECT_NAME> #你的项目名称 # Or initialize in existing project specify init . --ai claude # or specify init --here --ai claude # Check installed tools specify check选项 2:一次性使用
Run directly without installing:直接运行而不安装:
# Create new project (pinned to a stable release — replace vX.Y.Z with the latest tag)uvx--fromgit+https://github.com/github/spec-kit.git@vX.Y.Z specify init <PROJECT_NAME># Or initialize in existing projectuvx--fromgit+https://github.com/github/spec-kit.git@vX.Y.Z specify init.--ai claude# oruvx--fromgit+https://github.com/github/spec-kit.git@vX.Y.Z specify init--here--ai claude2.1 /constitution
作用:先定项目原则和约束
你可以把它理解成“项目宪法”或“总规则”。
它通常用来确定这些东西:
- 这个项目最重要的目标是什么
- 开发时必须遵守哪些原则
- 代码、测试、文档、审查的基本要求
- 有哪些不能违反的限制
2.2/specify
作用:把“我要做什么”写成清晰的需求说明
这是“需求规格”阶段。
重点不是怎么实现,而是:
- 要做什么功能
- 给谁用
- 用户场景是什么
- 输入输出是什么
- 成功标准是什么
- 哪些不在本次范围内
2.3/plan
作用:把需求转成实现方案
到了这一步,关注点从“要做什么”变成“准备怎么做”。
它通常会输出类似这些内容:
- 技术方案
- 模块划分
- 数据结构或数据库设计
- API 设计
- 页面/组件结构
- 风险点与依赖项
- 实现顺序
作用位置:需求确认后。
因为 plan 是把 requirement 落成 engineering design。
2.4/tasks
作用:把实现方案拆成可以直接开干的任务清单
这是把 plan 进一步细化成执行项。
通常会拆成:
- 先建项目结构
- 再定义数据库表
- 再实现 API
- 再写前端页面
- 再补测试和文档
每个任务 ideally 会比较具体,能直接分配、直接做、直接验收。
作用位置:plan 之后。
因为 tasks 是对 plan 的执行拆分。
2.5/implement
作用:开始实际执行实现
这一步就是进入“干活”阶段。
它可能会根据前面的 specification / plan / tasks:
- 按任务逐步生成代码
- 修改文件
- 补测试
- 完成部分实现
- 推进整个开发流程
也就是说,前面几个命令偏“定义和设计”,
这个命令偏“真正落地”。
先定规则 → 写清需求 → 制定方案 → 拆成任务 → 开始实现
打开vscode
首先先在vscode扩展商店下载GitHub Copilot Chat
下载期间看一下你的文件夹目录,如果有这个.specify文件夹,并且在vscode中/speckit. 指令后显示那么恭喜你,安装成功
到此就可以尝试规范开发的魅力了
我们来对比一下二者开发时的区别
| 传统开发流程 | Spec Kit流程 |
|---|---|
| 一次性提供所有需求给AI | /specify 定义功能需求 |
| AI凭常识猜测大量细节 | /clarify AI凭常识猜测 |
| 直接生成代码,没有检验点 | /plan 确定技术方案 |
| 发现问题后大量返工 | /tasks生成可执行任务 |
| 文档过时,维护困难 | /analyze 检查一致性 |