Git 地址：https://github.com/Fission-AI/OpenSpec

Fission-AI/OpenSpec 是一个开源工具/框架，旨在为 AI 代码助手（如 GitHub Copilot、Claude Code、Cursor 等）引入“规格驱动开发”（Spec-Driven Development）流程。它的核心目标是让开发者和 AI 在写代码之前先就明确 需求规格（spec） 达成一致，从而得到更可预测、更易审查的代码产出。

更适合已有项目进行 Ai 驱动开发。

使用流程

1. 安装

安装前准备：

  • Node.js 版本 >= 20.19.0 - 使用以下命令检查您的版本node --version

安装：

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

验证安装：

openspec --version

2. 初始化

在已有的项目中，导航至项目目录：

cd my-project

运行初始化程序：

openspec init

初始化期间发生的情况：

  • 系统会提示您选择任何原生支持的 AI 工具（例如 Claude Code、CodeBuddy、Cursor、OpenCode、Qoder 等）；其他助手始终依赖于共享的AGENTS.md存根。

  • OpenSpec 会自动为您选择的工具配置斜杠命令，并且始终AGENTS.md在项目根目录写入一个受管理的交接文件。

  • openspec/项目中添加了新的目录结构

在运行完成后，会出现这样的提示：

此时可以将这段文本复制，发送给 cursor

最好是将 1. 这段内容发送给cursor

cursor 将会读取项目，并为项目生成介绍 （/openspec/project.md）

3. 使用

在初始化完成后，在 cursor 对话框中输入： / 将会出现如下命令：

如果想要开发一个功能，这里以我当前存在的一个项目为例，这是一个 Nuxt3 + Vue3 的模拟小红书的项目：

  1. 生成功能提案：使用 /openspec-proposal 命令，让 AI 生成详细的功能提案

这里成功之后，将会生成这几个文件，其中详细记载了功能

  1. 审核提案&修改提案：我们进行审核，如果有任何不满意的地方，可以直接用 自然语言 沟通进行修改

  2. 实施提案&项目编写：当项目提案已经没有问题，可以进行编写，使用 /openspec-apply add-home-feed 开始编写

    1. 此时 AI 将会根据提案、任务进行开发

    2. AI 开发完成后，手动审查代码，测试功能是否完成

  3. 功能完成&提案归档： 功能开发完成，并通过测试，则进行归档，使用 /openspec-archive home-feed 命令进行变更归档，归档操作：

    1. 验证所有规范格式

    2. 合并 Delta 到 openspec/specs/

    3. 移动变更到 openspec/changes/archive/

    4. 清空 openspec/changes/ 准备下一个功能

    5. 生成归档时间戳