## 你是否也经历过这些"AI开发"的痛？

用了 Claude Code、Cursor、Codex 半年后，我深刻体会到一句话：

> **"AI 编程助手很强，但它只对你刚刚说过的话负责。"**

于是问题来了——

- **需求在聊天记录里，找不到了**
- **AI 改了 30 个文件，不知道改了什么**
- **换了个 AI 助手，上下文全丢了**
- **团队 5 个人用 AI，代码风格完全不同**
- **review 时发现 AI 写的功能根本不是你想要的**

这些问题，归根结底是：**我们把"需求"这件事，全权交给了聊天窗口。**

---

## 解决方案：Spec-Driven Development（规范驱动开发）

最近我发现了 OpenSpec 这个开源工具，它的核心思想很简单：

> **在让 AI 写代码之前，先让它理解"我们要做什么"，并且把"做什么"写下来。**

这听起来像废话？但它解决了一个根本问题：

| 传统 AI 开发 | 规范驱动开发（SDD） |
|-------------|-------------------|
| 需求在聊天记录里 | 需求在项目文件里 |
| AI 自由发挥 | AI 按规范执行 |
| 换了 AI 就丢失上下文 | 规范是工具无关的 |
| 质量靠"运气" | 质量可追溯、可控制 |

---

## OpenSpec 是什么？

OpenSpec 是由 Fission-AI 开发的 **规范驱动开发框架**，GitHub 48k+ Stars，专为 AI 编程助手设计。

它的核心做法是：**每个变更都创建一个独立的文件夹**，里面包含：

```
openspec/changes/add-payment/
├── proposal.md    ← 为什么做这个功能
├── specs/         ← 具体需求和验收标准
├── design.md      ← 技术方案设计
└── tasks.md       ← 实施任务清单
```

然后通过斜杠命令让 AI 按这套规范工作：

```bash
/opsx:propose add-payment      # 提案
/opsx:apply                     # 按规范实施
/opsx:archive                   # 归档
```

---

## 个人开发者：用 OpenSpec 摆脱"AI失忆症"

### 场景 1：功能做到一半，忘了做到哪了

以前用 AI 开发，做到一半去开会，回来发现 AI 已经"自由发挥"了 20 个文件，你根本不知道它做了什么。

**用 OpenSpec 后**：

```bash
/opsx:propose add-user-notification
# AI 生成 tasks.md，列出所有子任务

/opsx:apply
# AI 执行 tasks.md 中的任务 1.1
# ✓ 完成：添加通知服务类

/opsx:apply
# AI 继续执行 1.2
# ✓ 完成：实现邮件发送逻辑

# 下次回来，继续 /opsx:apply
# AI 自动从上次停下的地方继续
```

**好处**：任务清单就在文件里，AI 不会"失忆"，你也不会迷失。

---

### 场景 2：想让 AI 理解项目的"历史债务"

```bash
/opsx:explore legacy-auth-module
# AI 分析现有认证模块的结构
# 输出：目录结构、核心类、依赖关系、扩展点
```

然后：

```bash
/opsx:propose add-oauth2-support
# AI 基于 explore 的分析，生成贴合现有架构的设计
```

**好处**：AI 不是在"真空"里写代码，它理解了你项目的实际情况。

---

## 团队协作：让 AI 成为"听话的程序员"

### 痛点：团队 5 个人用 AI，代码风格完全失控

- 小王用 Claude Code，代码风格偏函数式
- 小李用 Cursor，代码风格偏 OOP
- 小张自己写 Prompt，风格完全随机

**结果**：代码库变成了"八国联军"，review 成本极高。

### 用 OpenSpec 统一标准

**Step 1：团队制定规范模板**

```markdown
# openspec/templates/design.md

## 技术方案要求

1. **命名规范**：遵循项目现有的命名风格
2. **错误处理**：必须包含完整的错误边界
3. **测试覆盖**：每个新增函数必须附带单元测试
4. **文档注释**：公共 API 必须写 JSDoc
```

**Step 2：团队成员统一使用 OpenSpec**

```bash
# 每个变更必须经过 propose → apply → archive
/opsx:propose add-search-feature
# AI 生成符合团队规范的 design.md

# 团队 review specs 后
/opsx:apply
# AI 按规范执行，代码风格统一
```

**效果**：

- ✅ 需求文档在 Git 里，可追溯
- ✅ AI 遵循团队统一的代码规范
- ✅ 任何人都可以接手任何变更
- ✅ Review 时有"规格书"可对照

---

## 老板关心的：质量可控

### 传统 AI 开发的质量问题

```
代码质量 = AI 的"心情" × 你的 Prompt 水平
```

**结果**：不稳定，不可预测，不可控。

### SDD 的质量保障机制

| 阶段 | 产出物 | 质量保障 |
|------|--------|---------|
| **提案** | proposal.md | 明确"为什么做" |
| **需求** | specs/ | 明确"做什么"，包含验收场景 |
| **设计** | design.md | 明确"怎么做"，技术决策透明 |
| **实施** | tasks.md | 分步骤执行，不会遗漏 |
| **归档** | archive/ | 完整历史，可复盘 |

**关键点**：每个阶段都有"人"参与审核，AI 是执行者，人是决策者。

---

## 实战：从零搭建一个"规范驱动"的 AI 开发流程

### 第一步：安装（3分钟）

```bash
# 需要 Node.js 20+
npm install -g @fission-ai/openspec@latest
```

### 第二步：初始化项目

```bash
cd your-project
openspec init

# 选择要集成的 AI 助手：
# ✅ Claude Code
# ✅ Cursor
# ✅ Codex
# ✅ Windsurf
# ... 支持 29 款主流工具
```

### 第三步：基础工作流

```bash
# 1. 提案
/opsx:propose add-user-dashboard

# 2. 审核 specs（人工检查需求是否正确）

# 3. 实施
/opsx:apply
# AI 按 tasks.md 执行

# 4. 归档
/opsx:archive
```

### 第四步：团队扩展

```bash
# 切换到扩展工作流，支持更多命令
openspec config profile
openspec update

# 扩展命令
/opsx:new           # 开始新变更
/opsx:continue      # 继续之前的工作
/opsx:ff            # 快速前进（跳过已完成任务）
/opsx:verify        # 验证实施结果
/opsx:bulk-archive  # 批量归档
```

---

## 常见问题

**Q：OpenSpec 和 Git 的区别是什么？**

A：Git 管理的是"代码变更"，OpenSpec 管理的是"需求到代码的完整链路"。Git 告诉你"改了哪些行"，OpenSpec 告诉你"为什么要改、改了什么需求"。

**Q：会不会增加开发流程的复杂度？**

A：恰恰相反。对于简单功能，`/opsx:propose` 一键生成，比你手写需求文档快 10 倍。对于复杂功能，规范文档让协作更清晰。

**Q：团队成员必须用同一个 AI 工具吗？**

A：不需要。OpenSpec 支持 29 款工具，团队可以混用。但**规范文档是共享的**，所以不同 AI 产出的代码遵循同一套标准。

---

## 总结

OpenSpec 解决的不是"让 AI 写得更快"，而是：

> **让 AI 的输出更可预测、更可控制、更可追溯。**

| 开发模式 | 特点 | 适合场景 |
|---------|------|---------|
| 纯 Prompt | 灵活但混乱 | 个人探索性项目 |
| SDD + OpenSpec | 结构化可控 | 正式项目、团队协作 |

---

**开源地址**：https://github.com/Fission-AI/OpenSpec

**官方网站**：https://openspec.dev

---

*如果这篇文章对你有帮助，欢迎转发给团队的同学。下一期我们聊聊如何用 OpenSpec 做 Code Review，让 AI 也参与质量把控。*

用了 Claude Code、Cursor、Codex 半年后，我深刻体会到一句话：

从"AI炼丹"到"AI智造"：用OpenSpec让代码开发像搭积木一样可控

AI 编程助手很强，但它只对你刚刚说过的话负责。

架构师

人工智能

架构设计

开发工具

OpenSpec规范驱动开发框架解决AI编程痛点：需求丢失、代码混乱、质量不可控。通过规范文档管理需求、设计和任务，让AI按标准执行，确保代码可追溯、风格统一。支持29款AI工具，适合个人和团队使用，提升开发效率和质量控制。开源项目48k+Stars，3分钟快速安装。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

从"AI炼丹"到"AI智造"：用OpenSpec让代码开发像搭积木一样可控-腾讯云开发者社区-腾讯云

从"AI炼丹"到"AI智造"：用OpenSpec让代码开发像搭积木一样可控

从"AI炼丹"到"AI智造"：用OpenSpec让代码开发像搭积木一样可控

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐