Spec-kit零基础教程,配合Cursor, Claude

概览

spec-kit项目地址

视频概览

国内镜像地址

了解从vibe coding到SDD,规范驱动开发是的规范变得可执行,能够直接生成可运行的实现,而不仅仅是指导实现。

Gihub官方的SDD工具包,用来帮你在各种 AI 编码环境中(如 Copilot、Cursor 等)按 SDD 的方式工作。它把"写规格、做计划、拆任务、实现和审查"这一整套流程固化成可复用的命令和模板。

主要组成包括:

  • CLI 工具:初始化项目、生成目录和基础文件;
  • Prompt / Slash 命令模板:针对产品、架构、开发、测试等不同"角色"预置好提示词;
  • 标准文件结构:如
    CONSTITUTION.md:项目"宪法"(目标、边界、约束)
  • 集成适配:预设好在Cursor等IDE中使用的Slash命令

准备

确保本机安装了spec-kit,

使用uv进行安装的,

uv : 一个极其快速的Python包和项目管理器,用Rust编写,知道pip的

如果电脑上没有uv,可以参考安装

在windows的cmd或ps中,执行以下命令:

复制代码
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

验证uv

安装spec-kit,

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@v0.9.2

验证安装specify --help

项目初始化

已有项目初始化specify init --here

新项目初始化specify init [项目名]

工作流程:

初始化-》章程-》需求-》澄清-》计划-》任务-》分析-》开发

开发是否满意-》是-》更新-》总结 / 否-》修改

在cursor项目中

specify init . --ai cursor-agent

检查安装的tool,specify check

在cursor聊天中输入

复制代码
/speckit.constitution # 建立项目准则
/speckit.specify # 建立基线
/speckit.plan # 建立实施计划
/speckit.tasks # 建立任务
/speckit.implement # 执行

输入specify init specify_test_demo之后,会让你选择Agent代理,

选择script type,

项目初始化成功

注意agent安全提示和git管理,

使用claude的话,相关技能就安装好了,可以通过指令实现调用

参考

https://juejin.cn/post/7563949011524091919

https://lzw.me/a/ai-coding-sdd-speckit-openspec-cursor.html

https://www.yanfukun.com/read/spec-kit/dirstrc

Git上传

本地项目初始化了,

先在github创建空仓库,不要勾选

然后初始化本地git仓库,git init

将所有文件添加到暂存区, git add .

提交到本地仓库, git commit -m "初始化项目"

关联远程仓库, git remote add origin xx

创建main分支, git branch -m M

推送代码到仓库,git push -u origin main

为了不影响主线main或master的稳定性,每次开发新功能或修复bug时,都应拉取一个新的功能分支

本地主干更新代码:

git checkout main

git pull

创建并切换到新分支

git checkout -b feature/login

在新分支上进行开发,可以安全的进行代码修改

编写代码后,将更改添加到暂存区并提交,

git add

git commit -m "feat: 完成用户登录接口"

开发过程中,需要同步主干的最新进度到当前分支,可以在分支执行

git merge main

开发完成后,将分支推送到远程仓库进行备份

git push -u origin feature/login

然后将开发完成的分支合并回主分支。

此时可以看到pull request,点击创建得到新的pull request,

通过可以点击continue merge

merge过后,有delete branch的选项,

然后记得本地main要pull一下最新的。

相关推荐
DO_Community12 小时前
DigitalOcean 的 AI 推理路由器是如何构建的
人工智能·开源·agent·claude·deepseek
可夫小子15 小时前
动态工作流:Claude 把「一个 AI」变成了「一支 AI 团队」
claude
解决问题16 小时前
cc Prompt 全链路分析:从默认值到模型 API
claude
m0_5358175516 小时前
macOS下Claude Code从0到1配置教程(附API密钥获取+常见报错修复)
gpt·macos·node.js·api·claude·claudecode·88api
晨欣17 小时前
Claude Opus 4.8:模型小幅升级,平台大步向前
llm·claude·anthropic·claude code·harness
jerrywus18 小时前
AI API 聚合网关怎么选:价格、接入配置与团队管控实测
openai·agent·claude
DylanlZhao20 小时前
Superpowers 原理探析
agent·ai编程·claude
糖果店的幽灵1 天前
Claude Code 完全实战指南 - 第六章:实战 — 股票交易 Skill v1.0(需求与数据获取)
claude