大家好,我是拾光,很高兴认识你,在此和大家分享一些平日里做的一些事情

你是否平时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 --from git+https://github.com/github/spec-kit.git@vX.Y.Z

# Or install latest from main (may include unreleased changes)
uv tool install specify-cli --from git+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 --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <PROJECT_NAME>

# Or initialize in existing project
uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init . --ai claude
# or
uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init --here --ai claude

在这里插入图片描述
在这里插入图片描述

2.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 检查一致性
Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐