1. 从 vibe coding 到 SDDSpec-kit 到底解决什么问题你可能已经习惯了在 Cursor 里对着聊天框说一句“帮我写个登录接口”然后 AI 噼里啪啦吐出一堆代码跑起来发现字段名对不上、目录结构乱、改一处崩三处。这种“凭感觉写代码”的方式就是大家常说的 vibe coding爽是爽但项目一大就失控。Spec-kit 想做的事情是把“规格驱动开发”Specification-Driven Development简称 SDD变成一套可执行的命令流先写清楚要做什么再让 AI 按规格生成计划、拆任务、写实现最后还能回头审查。Spec-kit 是 GitHub 官方出的 SDD 工具包它本身不是一个编辑器也不是模型而是一组 CLI 命令加提示词模板。你在 Cursor 里初始化之后会得到一套标准文件结构比如CONSTITUTION.md项目宪法写目标、边界、约束、spec.md规格、plan.md技术方案、tasks.md任务列表。然后通过/speckit.constitution、/speckit.specify、/speckit.plan、/speckit.tasks、/speckit.implement这些斜杠命令按顺序把规格一步步变成能跑的代码。这套流程适合谁适合那些已经用 Cursor 写代码、但被 AI 生成结果不稳定折磨过的开发者也适合刚接触 AI 编程、想从一开始就建立规范习惯的零基础读者。你不需要懂复杂的提示词工程只要按顺序执行命令、核对产出文件就行。而要让这套流程在国内网络环境下稳定跑起来关键一步是把 Cursor 的 Base URL 指向 TaoToken 的统一 API 通道再用 Claude 模型来驱动 Spec-kit 的各个阶段。下面我会从环境准备开始一步步带你走完整个 SDD 全流程。2. 前置准备uv 安装 Spec-kit 与 TaoToken 统一 Key 配置在开始改 Cursor 配置之前先把本机环境准备好。Spec-kit 官方推荐用 uv 来安装uv 是一个用 Rust 写的 Python 包和项目管理器速度比 pip 快很多而且能直接管理工具链。如果你电脑上还没有 uvWindows 的 cmd 或 PowerShell 里执行下面这条命令powershell -ExecutionPolicy ByPass -c irm https://astral.sh/uv/install.ps1 | iexmacOS 或 Linux 用户可以用curl -LsSf https://astral.sh/uv/install.sh | sh装完之后验证一下uv --version能输出版本号就说明 uv 可用了。接下来安装 Spec-kit 的 CLI 工具 specify-cli注意要指定版本避免拉到不兼容的代码uv tool install specify-cli --from githttps://github.com/github/spec-kit.gitv0.9.2安装完成后执行specify --help如果能看到 init、check 等子命令说明 Spec-kit 已经装好了。这一步踩过的坑是有些同学直接用 pip install specify-cli结果装到的是另一个同名包命令完全不一样所以一定要用--from git...这种方式。接下来是 TaoToken 的配置。TaoToken 提供统一的 API 通道你只需要一个 Key 就能调用 Claude 等模型。先到官网注册并创建一个 API Key地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 登录后在控制台里找到 API Keys 页面生成 Key。生成之后先复制保存后面配置 Cursor 和 Spec-kit 都要用到。TaoToken 的 API 基础地址是 https://taotoken.net/api 注意这个地址后面不加 UTM 参数直接用在 Base URL 里。模型 ID 方面Claude 系列可以用claude-sonnet-4-20250514这类标识具体以控制台模型列表为准。如果你还没决定用哪个模型可以先到模型对话页面试一下效果地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。对于长期编码和 Agent 场景Coding Plan 会更划算入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。这里要提醒一句Spec-kit 本身不绑定任何模型它只是生成提示词和文件结构真正干活的是 Cursor 里配置的模型。所以把 Cursor 的 Base URL 改到 TaoToken再用 Claude 模型才能让 SDD 流程稳定输出。3. 可复制配置Cursor settings.json 指向 TaoToken 的完整片段Cursor 的模型配置有两种方式一种是在图形界面里填 Base URL 和 Key另一种是直接改settings.json。为了可复制和可版本管理我建议用 settings.json。文件路径根据系统不同Windows 一般在%APPDATA%\Cursor\User\settings.jsonmacOS 在~/Library/Application Support/Cursor/User/settings.jsonLinux 在~/.config/Cursor/User/settings.json。如果你找不到可以在 Cursor 里按CtrlShiftPmacOS 是CmdShiftP输入 “Open Settings (JSON)” 直接打开。打开后把下面这段配置合并进去。注意 JSON 里如果已有同名键要合并而不是重复写{ cursor.general.enableShadowWorkspace: true, cursor.cpp.disabledLanguages: [], cursor.chat.openaiBaseUrl: https://taotoken.net/api, cursor.chat.openaiApiKey: sk-你的TaoTokenKey, cursor.chat.model: claude-sonnet-4-20250514, cursor.chat.customModels: [ { name: claude-sonnet-4-20250514, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey } ] }这里有几个关键点。第一openaiBaseUrl填的是https://taotoken.net/api不要在后面加/v1或者斜杠TaoToken 的兼容层会自动处理路径。第二openaiApiKey填你刚才生成的 Key注意不要泄露到公开仓库。第三模型 ID 要和控制台里的一致如果你用的是其他 Claude 版本把claude-sonnet-4-20250514替换掉即可。如果你用的是 Cline 或者 Claude Code 这类插件配置方式类似但字段名不同。比如 Cline 的 MCP 配置里Base URL 和 Key 要写在对应的 provider 设置里。Codex 的auth.json则是另一种格式{ baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, model: claude-sonnet-4-20250514 }不管用哪种工具三件套都是 Base URL、Key、Model ID缺一不可。改完 settings.json 后保存重启 Cursor让配置生效。然后打开聊天面板随便问一句“你好”看是否能正常返回。如果返回 401说明 Key 不对如果返回 local proxy failed说明 Base URL 写错了或者网络层有问题。这一步先别急着跑 Spec-kit确认模型通道通了再说。4. 验证请求与成功结果specify init 到 /speckit.implement 全流程配置好 Cursor 之后就可以初始化 Spec-kit 项目了。先建一个空目录比如specify_test_demo然后在终端里进入这个目录执行specify init . --ai cursor-agent执行后会让你选择 Agent 代理类型选cursor-agent然后选择 script type一般选默认的 shell 脚本即可。初始化成功后目录里会出现.specify文件夹里面有模板和命令定义。你可以用specify check检查工具是否安装完整specify check如果输出里显示各个组件都 OK就可以在 Cursor 里打开这个项目了。打开后在聊天框里输入斜杠命令应该能看到/speckit.constitution、/speckit.specify、/speckit.plan、/speckit.tasks、/speckit.implement这些选项。第一步建立项目准则。输入/speckit.constitution然后描述你的项目目标、边界和约束比如“这是一个用户登录模块只允许邮箱和密码登录密码必须加密存储不引入第三方登录”。Cursor 会调用 Claude 生成CONSTITUTION.md你核对一下内容是否符合预期。第二步建立规格基线/speckit.specify描述你要做的功能比如“用户可以用邮箱注册注册后收到验证邮件登录时校验密码”。生成spec.md里面会有用户故事、验收标准等。第三步生成实施计划/speckit.planClaude 会根据 spec 生成plan.md里面包含技术选型、目录结构、接口设计。这时候你要检查一下比如它是不是用了你想要的框架数据库表设计是否合理。第四步拆任务/speckit.tasks生成tasks.md里面是一条条可执行的任务比如“创建 User 模型”“实现注册接口”“写单元测试”。每条任务都有明确的输入输出。第五步执行实现/speckit.implementClaude 会按 tasks 逐条生成代码。你可以在 Cursor 里看到文件被创建和修改。每完成一批任务就运行一下测试或者手动验证。如果结果不满意可以回到 spec 或 plan 修改然后重新生成 tasks 和 implement。整个流程走下来你会得到一套完整的项目文件CONSTITUTION.md、spec.md、plan.md、tasks.md以及实际代码。这就是 SDD 的核心规格可执行代码可追溯。验证成功的标志是specify check无报错Cursor 聊天能正常返回 Claude 内容/speckit.implement后文件产出与 tasks 一致。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth即使按步骤操作也可能会遇到一些报错。下面是我实测中常见的几类对照着排查。第一类401 Unauthorized。这个最直接就是 Key 不对或者没生效。检查settings.json里的openaiApiKey是不是复制完整有没有多余空格。另外确认 Key 没有过期到 TaoToken 控制台的 API Keys 页面看一下状态。如果 Key 没问题试试在模型对话页面直接发一条消息看是否能通。如果那边也不通说明 Key 本身有问题重新生成一个。第二类local proxy failed。这个报错通常出现在 Cursor 启动时或者发请求时意思是本地代理层连不上目标地址。先检查openaiBaseUrl是不是写成了https://taotoken.net/api有没有多写/v1或者结尾斜杠。然后确认本机网络能正常访问 TaoToken 的 API 地址可以用 curl 测一下curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-20250514,messages:[{role:user,content:hi}]}如果 curl 能返回内容说明网络和 Key 都没问题那就是 Cursor 配置没生效重启一下或者检查 settings.json 是否被其他配置覆盖。第三类reading choices 报错。这个一般出现在模型返回格式不符合预期时比如返回了空内容或者非 JSON 结构。先确认模型 ID 是否正确有些模型名在 TaoToken 里需要用控制台显示的完整 ID。另外检查请求参数里stream是否为 true某些插件对流式返回处理不好可以临时关掉流式试试。第四类OAuth 相关报错。如果你用的是 Claude Code 或者某些需要 OAuth 的工具可能会提示授权失败。这时候不要走 OAuth 流程直接在配置里填 API Key 方式。Claude Code 的配置里把 Base URL 指向https://taotoken.net/apiKey 填 TaoToken 的 Key模型填 Claude 的 ID就能绕过 OAuth。还有一个容易忽略的点Spec-kit 初始化时如果选了cursor-agent但 Cursor 里没有安装对应的 Agent 插件斜杠命令可能不出现。这时候重新执行specify init . --ai cursor-agent确保.specify目录完整。如果还是不行检查 Cursor 版本是否支持自定义斜杠命令升级到最新版通常能解决。6. 长期编码与 Agent 场景把 SDD 流程固化到日常开发跑通一次全流程之后你可以把这套 SDD 流程固化到日常开发里。每次新功能开发先拉一个功能分支比如git checkout -b feature/login然后在分支上执行/speckit.specify和/speckit.plan生成规格和计划后再写代码。这样主分支始终保持稳定AI 生成的代码也有据可查。对于长期编码和 Agent 场景建议用 TaoToken 的 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它比按量计费更适合高频调用。如果你需要管理多个项目的 Key可以到控制台的 API Keys 页面创建不同的 Key分别配置到不同项目里。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各工具的详细配置说明。另外Spec-kit 生成的CONSTITUTION.md和spec.md建议纳入 Git 版本管理这样团队协作时每个人都能看到规格的变更历史。每次修改规格后重新执行/speckit.plan和/speckit.tasks让计划和任务与规格保持同步。如果发现 AI 生成的代码偏离了规格不要直接改代码而是回到 spec 修改再重新生成。这就是 SDD 和 vibe coding 最大的区别规格是源头代码是产物。最后提醒一点Spec-kit 的斜杠命令依赖 Cursor 的 Agent 能力如果你在 Cursor 里同时装了多个 AI 插件可能会冲突。建议只保留一个主力插件把 Base URL 统一指向 TaoToken避免请求被截胡。配置改完后用specify check和一次完整的/speckit.implement来验证确保整条链路通畅。