Chapter 9 – Openspec

OpenSpec 安装与使用说明

安装步骤

1. 确认已安装 Node.js 和 npm：

   node -v
   npm -v

2. 全局安装 OpenSpec：

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

3. 进入项目目录：

   cd your-project-name

4. 初始化 OpenSpec：

   openspec init

5. 初始化后会生成目录：

   openspec/
   specs/ 当前系统行为
   changes/ 变更记录
   config.yaml 项目配置

常用命令

初始化与配置：

npm install -g @fission-ai/openspec@latest
openspec init
openspec config profile
openspec update

核心工作流命令：

/opsx:propose
/opsx:explore
/opsx:apply
/opsx:archive

扩展命令：

/opsx:new
/opsx:continue
/opsx:ff
/opsx:verify
/opsx:sync
/opsx:bulk-archive
/opsx:onboard

新功能开发流程

简单流程（推荐）：

/opsx:propose
/opsx:apply
/opsx:archive

复杂流程：

/opsx:new
/opsx:ff 或 /opsx:continue
/opsx:apply
/opsx:verify
/opsx:archive

流程说明

• propose：定义要做什么
• apply：实现功能
• verify：验证是否符合预期
• archive：归档沉淀

推荐使用方式

1. 先执行：

   openspec init

2. 使用核心流程完成第一个功能
3. 需要复杂流程时执行：

   openspec config profile
   openspec update

4. 再使用扩展命令开发复杂功能

挑战：使用 Openspec 框架，开发一个新功能