概览
了解从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一下最新的。