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一下最新的。

相关推荐
七牛开发者6 小时前
从 Fable 案例看 Coding Agent 的未知项管理
ai·agent·claude·loop·codex
ServBay1 天前
同时用 Claude Code、Codex 和 Gemini CLI?一个本地网关就能统一管理
aigc·ai编程·claude
粤海科技君1 天前
WorkBuddy CLI 命令行实战:替代 Claude Code 的工作流
claude·workflow·腾讯
蓝田~1 天前
大模型本地部署与远程调用 — 从 API 到 Agent
java·人工智能·claude·claude code
一枚菜鸟_1 天前
Flutter + Cursor 一天出 App?这 3 个坑让开发者多花了 3 小时
flutter·cursor
武子康1 天前
🔥 codex-plugin-cc 原理全拆:四层桥接 + JSON-RPC 2.0 + JSONL + 后台任务状态机
人工智能·llm·claude
kyriewen2 天前
看了微软几万人用AI编程的数据——效率涨24%的代价没人提
前端·ai编程·claude
武子康2 天前
OpenAI 把 Codex 接进 Claude Code:Coding Agent 从单兵工具进入协作系统
人工智能·openai·claude
喜欢天文的2 天前
一个桌面应用,如何把 7 个 AI 编程工具全部"中间人"掉——CC Switch 深度拆解(上)
claude