OpenSpec是什么：OpenSpec + Cursor 完整实战
OpenSpec 完全解析：AI 编程时代的规范驱动开发框架
目录
- OpenSpec 完全解析：AI 编程时代的规范驱动开发框架
- 一、核心定义
- 二、为什么我们需要 OpenSpec？
- 三、核心概念与架构
- 1. 双文件夹模型（核心设计）
- 2. 关键术语
- 四、完整工作流程
- 五、主要特点与优势
- 六、与其他工具的对比
- OpenSpec vs SpecKit
- OpenSpec vs 传统需求文档
- 七、另一个"OpenSpec"（避免混淆）
- 八、快速上手
- OpenSpec + Cursor 完整实战
- 一、准备工作
- 1. 环境准备
- 2. 初始化项目
- 二、第一步：在 Cursor 中创建变更提案
- 1. 生成变更提案
- 2. 查看自动生成的提案
- 三、第二步：编写规范（最关键的一步）
- 错误响应（400/409）
- 4. 业务规则
- 5. 测试场景
- 2. `app/services/user_service.py`（业务逻辑）
- 3. `app/api/users.py`（API 路由）
- 4. `main.py`（入口文件）
- 5. 自动生成的单元测试 `tests/test_users.py`
- 五、第四步：验证代码与规范的一致性
- 六、第五步：运行并测试实际效果
- 实际测试效果
- 七、第六步：归档变更
- 八、实际使用效果对比
- 九、Cursor 中使用的高级技巧
- 十、常见问题解决
一、核心定义
OpenSpec是由 Fission AI 团队开发的开源轻量级规范驱动开发（Spec-Driven Development, SDD）框架和命令行工具，专为 AI 辅助编程场景设计。它在人类开发者与 AI 编码助手之间建立了一个持久化的共识层，解决了 AI 编程中需求模糊、幻觉、上下文丢失和代码与规范脱节等核心问题。
截至 2026 年 5 月，它在 GitHub 上已获得超过 46.8k 星标，是目前最受欢迎的 AI 开发规范工具之一。
二、为什么我们需要 OpenSpec？
AI 编程时代最大的痛点不是"写代码太慢"，而是"代码不可控"。传统的"Vibe Coding"（凭感觉写代码）模式会导致：
- 需求散落在几十条聊天记录中，找不到完整上下文
- AI 上下文窗口一满就"忘记"之前的约定
- 同一个功能，AI 前后写出两套完全不同的实现
- 团队协作时，没有人知道现在的代码"应该"是什么样
- 变更缺乏可追溯性，无法知道"为什么这样做"
OpenSpec 的解决思路很简单：写代码之前，先让人和 AI 对"要做什么"达成共识，用结构化的 Markdown 文件固化下来，让规范成为项目的"唯一真相来源"。