5.6 案例研究：Claude Code + Cursor + OpenSpec 实战指南
参考来源：本章内容整理自知乎文章《Claude Code + Cursor + OpenSpec：2025 年最强 AI 编程铁三角完整实战指南》
作者背景：一个靠这套组合月接 6 个外包的全栈游民
阅读时长：约 12 分钟
前言：为什么 2025 年你必须学会这套组合？
2024 年底还在单用 Cursor，经常被 Claude「自由发挥」气到砸键盘。
2025 年 3 月接入 OpenSpec + Claude Code 之后：
- 单人 9 天交付一个中型 SaaS（带 RBAC + 多租户 + RAG）
- 代码重构 0 返工，甲方验收一次通过
- 每月稳定 40w+ 收入，工作时长从 60h 降到 25h
这篇文章把过去 8 个月踩过的所有坑、总结出的所有最佳实践，全部打包成一份可直接复制的 Markdown 文件，你照着做就能起飞。
一、工具简介（30 秒看懂三者关系）
| 工具 | 定位 | 核心优势 | 短板 | 2025 年最新版本 |
|---|---|---|---|---|
| OpenSpec | 规范之神 | 结构化 Markdown 规范，强制 AI 按合同写代码 | 无 GUI | v2.4（支持 monorepo） |
| Claude Code | 深度代理 | 终端里真正的「AI 高级工程师」，会自己 git、跑测试、回滚 | 没有实时预览 | claude-code 2.2 |
| Cursor | 交互之王 | VS Code 分支 + 超强 LSP + Composer + BugBot | 规划能力弱，容易跑偏 | 0.42+（原生支持 Claude 4 Opus） |
三者关系一句话
text
OpenSpec 写合同 → Claude Code 当架构师 → Cursor 当超级打工人二、一次性配置完成（总共 8 分钟）
bash
# 1. 全局安装（只需要一次）
npm install -g @anthropic-ai/claude-code @fission-ai/openspec
# 2. 进入项目
cd your-awesome-project
# 3. 初始化 OpenSpec（最重要一步！）
openspec init
# → 会生成 openspec/ 目录，包含 project.md / AGENTS.md / changes/
# 4. 启动 Claude Code 并关联规范
claude
# 在终端里输入：
# /config auto-accept-changes true
# /load openspec/AGENTS.md
# /load openspec/project.mdCursor 配置（3 步）
- Settings → Models → 添加 Anthropic API Key（选 Claude 4 Opus）
- Settings → Rules → 新建
openspec.mdc规则，内容直接复制openspec/project.md - 安装 Claude Code 扩展（Cursor 商店搜索即可），快捷键
Cmd+Esc一键唤醒终端 Claude
三、核心工作流（每天只用这 5 步）
第 1 步：OpenSpec 立合同（3-8 分钟）
text
├─ openspec new add-user-rbac
└─ 填写 4 个必填区：
• Requirements（需求）
• Constraints（约束）
• Design（我通常让 Claude 先写草稿）
• Tasks（自动拆成 1-8 个子任务）第 2 步：Claude Code 做规划（5-15 分钟）
在 claude 终端输入：
text
/plan @openspec/changes/add-user-rbac.md Think ultrahard, output step-by-step implementation plan第 3 步：Cursor 暴力执行（10-40 分钟）
- 把 Claude 的计划复制到 Cursor Composer（
Cmd+K） - 疯狂按 Tab 让 Cursor 写代码
- 出 bug 直接
@bugbot或截图扔给 Claude Code
第 4 步：Claude Code 终审 + 自动化提交
text
/review all changes against @openspec/changes/add-user-rbac.md If pass →
/openspec:archive add-user-rbac --yes Then create PR with conventional commits第 5 步：归档，成为永久规范
openspec/changes/add-user-rbac.md自动移到archived/project.md自动更新「已实现功能清单」
四、2025 年最新必备模板（直接复制）
项目根目录放入以下文件：
openspec/project.md（全局规范）
markdown
# 项目全局规范（Source of Truth）
技术栈：Next.js 15 (app router) + TypeScript + Tailwind + Prisma + Zod
代码风格：Airbnb + Prettier（4 空格缩进禁止）
依赖原则：只允许以下外部库：[...省略 20 个]
安全要求：所有输入必须 Zod 校验，密码 bcrypt，JWT 7 天过期
性能要求：所有页面 SSR，LCP < 2.5s
测试要求：所有 API 必须有 integration test（playwright）openspec/AGENTS.md（AI 角色分工）
markdown
Claude Code：负责架构、规划、代码审查、Git 操作
Cursor：负责实时补全、调试、UI 组件实现
严禁 Claude Code 直接写 UI 组件！必须交给 Cursor！五、黄金 Prompt 合集（直接复制就起飞）
bash
# 规划神器
Plan mode: 基于 @openspec/changes/xxx.md，输出 4-8 个线性子任务，带文件路径和优先级
# 执行神器
Implement: 严格按照 @openspec/changes/xxx.md 的 Design 部分实现当前任务。保持 <300 行
# 审查神器
Review: 交叉检查所有 diff 是否 100% 符合 @openspec/project.md 和 changes/xxx.md
# 终极一键归档
/openspec:archive xxx --yes && gh pr create --fill六、真实案例：9 天交付 40w 项目复盘
需求
多租户 SaaS 后台（RBAC + 审计日志 + RAG 知识库）
时间分解
| 天数 | 操作 | 耗时 |
|---|---|---|
| D1 | openspec init + 写 project.md | 2h |
| D2-3 | 用 Claude Code 规划 12 个变化提案 | 6h |
| D4-7 | Cursor 每天执行 3 个变化（平均 40 分钟一个） | 20h |
| D8 | Claude Code 统一审查 + 压力测试 | 5h |
| D9 | 自动归档 + 交付 | 2h |
成果
总工作时长 35 小时，收费 40 万。
七、常见坑 & 必会避坑技巧
| 坑 | 解决方案 |
|---|---|
| AI 疯狂加新依赖 | project.md 写死白名单，Claude 看到就害怕 |
| 代码风格不统一 | Cursor Rules 同步 OpenSpec 规则 |
| 后期改需求导致大重构 | 每个需求都走 openspec new，强制走变更流程 |
| Claude Code 卡死 | 立刻 Ctrl+C → 新终端 /clear → /load 继续 |
| Cursor 一直改不相关文件 | Composer 里先选中「Only modify files in tasks」 |
八、结语：把 AI 当「实习生」而不是「大神」
记住永远的铁律：
- 合同（OpenSpec） > 架构师（Claude Code） > 打工人（Cursor）
- 永远不相信 AI 的一次性输出
- 所有关键逻辑必须人工 review
- 归档即胜利（不归档等于白干）
照着这篇文章做，一周后你会发现：
「原来写代码可以这么轻松，我只是负责提需求和 review 而已。」
补充说明：为什么这套组合有效？
问题根源：Vibe Coding 的隐性成本
传统的「Vibe Coding」方式（直接和 AI 聊天写代码）存在以下问题：
- 上下文丢失：AI 只记住当前对话，一旦上下文重置，之前的「计划」就消失了
- 需求漂移：没有明确的规范，AI 会「自由发挥」
- 无法追溯：聊天记录难以作为文档保存
- 隐性成本：调试神秘 bug、重构糟糕架构、反复提示修复
OpenSpec 的解决方案
OpenSpec 通过「规范驱动开发」解决这些问题：
text
起草提案 → 审核对齐 → 批准计划 → 实现任务 → 归档更新
Draft Review Approve Implement Archive
│ │ │ │ │
▼ ▼ ▼ ▼ ▼
proposal.md 反馈迭代 确认范围 编写代码 合并到 specs/
tasks.md 移至 archive/
specs/*.md三工具协作的优势
| 维度 | 单用 Cursor | 铁三角组合 |
|---|---|---|
| 需求管理 | 散落在聊天记录 | OpenSpec 统一管理 |
| 架构设计 | 依赖 AI「直觉」 | Claude Code 深度规划 |
| 代码实现 | 快但容易跑偏 | Cursor 按规范执行 |
| 代码审查 | 人工逐行 | Claude Code 自动审查 |
| 变更追踪 | 无 | 完整归档历史 |