OpenSpec 是一个规范驱动的开发框架，用于 AI 编程助手。它帮助团队创建和管理代码规范、变更提案和项目结构。这个工具比较适合开发大的功能，小功能改造可能会浪费时间。

对于一个大的功能，如果不用open spec，可能需要反复和curosr沟通，造成反复的代码更改；

用了open spec，会先生成文档，你再review文档，如果不满意或者有其他变更或者更细的功能开放，继续和cusor描述，会自动加到文档里面，最后你觉得没问题了再执行命令让cusor改代码，类似于前面提到的文档驱动。

安装：
 

npm install -g @fission-ai/openspec@latest

版本查询

openspec --version

初始化

在文件夹内执行：openspec init;

openspec init

输入'回车';

选择IDE--Cursor会按照Cursor建立自己的路径和文件夹

上面执行init命令后，会自动创建 `.openspec` 目录结构和 `AGENTS.md` 文件（新版本open spec生成skill相关文件）

open spec目录

acheive下是空的

specs下也是空的

使用

探索 (Explore) - 在开始前思考问题

新建变更 (New) - 创建变更容器

提案 (Proposal) - 记录为什么要做这个变更

规范 (Specs) - 定义要构建什么（详细需求）

设计 (Design) - 决定如何构建

任务 (Tasks) - 分解为实施步骤

应用 (Apply) - 实施任务

归档 (Archive) - 完成后归档变更

/opsx-explore :在开始前思考问题

思考怎么做？

openSpec new

生成的文件

proposal.md - 变更提案
说明为什么需要修改
列出需要修改的内容
说明影响范围
design.md - 技术设计文档
技术决策和理由
风险评估和缓解措施
部署和回滚策略
新增需求定义
测试场景（使用 #### Scenario: 格式）
tasks.md - 实施任务清单
数据库变更任务
DTO 层修改任务
功能验证任务
specs/xxx/spec.md - 详细规格说明
新增需求定义
测试场景（使用 #### Scenario: 格式）

openSpec new 替换方式或者依次执行命令-创建上述四个文件：

openSpec proposal

openSpec design

openSpec specs

openSpec tasks

 /opsx:apply

运行 /opsx:apply 或直接按 tasks.md 逐项实施即可。