OpenSpec 是 Fission AI 团队开源、面向 AI 编程助手的「规范驱动开发」轻量级框架与 CLI 工具，核心是 Spec First, Code Later（先定规范、再写代码），解决 AI 编程需求跑偏、上下文丢失、结果不可控的问题。

现根据下面的官网安装好两个工具:

https://qoder.com/cli

https://openspec.pro/

下面开始使用:

安装完成后进入项目目录,执行初始化

openspec init

然后选择AI编程工具,我使用的是Qoder,上下键控制,按空格选中或取消

如果选错了可以输入下面指令重新选择,这个会覆盖现有配置,重新选择工具

openspec init --force

在项目目录下启动qoder编程工具

qodercli

输入指令生成我们的需求设计和任务,我这里是添加个用户登录功能

/opsx:new 添加用户登录

下面可以看到ai编程工具的思考过程

接下来授权后会看到它的设计和任务输出

下面是生成的文档结构目录

openspec/
├── specs/        # 真相源：系统当前已实现的稳定行为规范
└── changes/      # 变更提案：每个功能/修改独立文件夹
    └── [变更ID]/
        ├── proposal.md  # 为什么做、改什么
        ├── specs/       # 本次新增/修改的需求
        ├── design.md    # 技术方案
        └── tasks.md     # 可执行任务清单

一定要打开看看确认设计\任务列表是否符合你的要求!!!

觉得可以再让ai编程助手开始写

/opsx:apply

接下来会涉及到文件的读写授权,可以看到tasks.md里的任务列表,每做完一个会在前面括号里打个x

下面到测试这步的时候,ai编程助手会自己启动项目执行curl测试

等了一个多小时,ai编程工具开发并测试完成,我们自己在验证一下就可以了

执行归档

/opex:archive

归档完成后,目录下也有了记录

总结一下OpenSpec的几个命令:

1.初始化

openspec init

2.新增需求

仅创建空变更脚手架（目录结构+空白模板），需后续手动补全规范。
本质是 「扩展流程」的起点，适合需求模糊或复杂的场景（如重构核心模块、跨系统集成）。

配合 /opsx:continue 一步步往下推进。

/opsx:new 需求xxx

3.生成快捷流程

一键生成完整规划制品（proposal + specs + design + tasks），直接进入开发阶段。
本质是 「快捷流程」，适合需求明确、改动简单的场景（如修复小 bug、新增简单功能）。

/opsx:proposa 需求xxx

4.生成计划

/opsx:ff

5.执行计划

/opsx:apply

6.归档

/opsx:archive

7.调研

当你“不知道做什么”或者“不确定怎么做”的时候，就用 /opsx:explore；当你“心里有数，只想快速干活”的时候，就直接用 /opsx:propose 或 /opsx:new。

/opsx:explore [你想调研的技术主题]