
## 1. 是什么

OpenSpec 是一个**规范驱动开发**工具，专为 AI 编码助手设计。核心理念很简单：**写代码前，先让人类和 AI 对“要做什么”达成一致**。

它解决的是“凭感觉聊天”式开发的痛点——需求散落在聊天记录里，AI 容易遗漏需求或偏离预期。OpenSpec 通过轻量级的规范流程，把模糊提示变成可审查、可落地的工程计划。

**核心结构：**
```
openspec/
├── specs/        # 已实现的功能（真相之源）
└── changes/      # 待实现的提案
    └── [变更名]/
        ├── proposal.md   # 为什么要做、做什么
        ├── design.md     # 技术方案
        ├── tasks.md      # 实施清单
        └── specs/        # 规范增量（补丁）
```

## 2. 快速上手

**环境要求：** Node.js 20.19.0 或更高版本

**安装与初始化：**
```bash
# 全局安装
npm install -g openspec-cn/openspec

# 进入项目目录
cd your-project

# 初始化
openspec init
```

初始化会创建 `openspec/` 目录结构，并根据你的 AI 工具配置对应的斜杠命令。

## 3. 核心工作流

OpenSpec 采用四步工作流，全程通过斜杠命令与 AI 交互：

| 命令 | 阶段 | 功能 |
|------|------|------|
| `/opsx:new` | 规划 | 创建新变更，生成首个工件模板 |
| `/opsx:ff` | 规划 | “快进”——一次性生成所有规划文档 |
| `/opsx:apply` | 实施 | 按任务清单实现代码 |
| `/opsx:archive` | 收尾 | 归档已完成变更，更新主规范 |

**实操示例**（以“添加深色模式”为例）：

```
# 1. 创建变更
/opsx:new add-dark-mode
→ 创建 openspec/changes/add-dark-mode/

# 2. 生成全部规划文档
/opsx:ff
→ ✓ proposal.md  ✓ specs/  ✓ design.md  ✓ tasks.md

# 3. 开始实施
/opsx:apply
→ 逐步完成 tasks.md 中的任务清单

# 4. 归档
/opsx:archive
→ 移至 changes/archive/，更新 specs/
```

## 4. 命令速查

### 斜杠命令（AI 对话）

| 命令 | 读/写 | 用途 |
|------|-------|------|
| `/opsx:explore` | 只读 | 探索想法、调研问题 |
| `/opsx:new` | 写入 | 创建新变更 |
| `/opsx:continue` | 写入 | 逐个创建工件 |
| `/opsx:ff` | 写入 | 一次性创建所有工件 |
| `/opsx:apply` | 写入 | 按任务清单实现代码 |
| `/opsx:verify` | 只读 | 验证实现与规范的一致性 |
| `/opsx:archive` | 写入 | 归档已完成变更 |

### CLI 命令（终端）

| 命令 | 用途 |
|------|------|
| `openspec list` | 列出进行中的变更 |
| `openspec list --specs` | 列出所有规范 |
| `openspec show [item]` | 查看变更/规范详情 |
| `openspec validate [item]` | 验证变更/规范格式 |
| `openspec archive <id> --yes` | 非交互式归档 |

## 5. 关键原则

**1. 棕地优先** —— 不要求从零开始，与存量项目完美兼容

**2. 规范即真相** —— `specs/` 是已实现功能的唯一真相源，`changes/` 是待实施的提案

**3. 增量变更** —— 每个变更独立成文件夹，归档后合并回主规范，历史清晰可追溯

**4. 人在回路** —— AI 生成提案后必须经过人工审查确认，再进入实施阶段

## 6. 支持的工具

OpenSpec 支持 20+ AI 编码助手，包括：
- **原生斜杠命令**：Claude Code、Cursor、GitHub Copilot、Windsurf、CodeBuddy
- **AGENTS.md 兼容**：其他工具可读取 `openspec/AGENTS.md` 获取工作流指引

OpenSpec 是一个规范驱动开发工具，专为 AI 编码助手设计。核心理念很简单：写代码前，先让人类和 AI 对“要做什么”达成一致。

OpenSpec 简明教程

高级软件开发工程师

开发工具

人工智能

低代码

OpenSpec是一款规范驱动开发工具，专为AI编码助手设计，通过轻量级规范流程将模糊需求转化为可落地的工程计划。它采用四步工作流，支持20+AI工具，确保开发过程清晰可追溯。核心结构包括specs/和changes/目录，实现棕地优先、规范即真相等关键原则，提升AI开发效率与质量。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

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

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

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

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

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

社区新版编辑器体验调研

OpenSpec 简明教程-腾讯云开发者社区-腾讯云

OpenSpec 简明教程

OpenSpec 简明教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐