OpenSpec 实战指南：在 Cursor 中落地 AI 原生开发工作流
OpenSpec 是规范驱动开发（SDD）在 Cursor IDE 中的实践方案，旨在将 AI 从编码助手升级为工程合作伙伴。
0. 安装和初始化
安装要求：Node.js >= 20.19.0
npm install -g @fission-ai/openspec@latest
openspec --version
装好后可以查看版本，输出版本号说明安装成功。注意 1.0.0 之后的版本命令已更新，请使用新命令。
选择你的工程目录，打开终端输入 openspec init 初始化目录。
在初始化向导中选择 Cursor IDE。
确认后显示如下：
至此，项目初始化完成。
1. 核心架构解密：CLI 与 Agent 的关系
在 OpenSpec 中，经常看到两类命令：openspec ... 和 /opsx:...。理解它们的底层关系，是掌握这套系统的关键。
1.1 角色定义
- CLI (
openspec ...) —— '机械臂'- 本质：底层的命令行工具（类似于 Git 或 NPM）。
- 能力：只懂文件操作。负责创建文件夹、移动文件、验证 JSON 格式、合并文档。没有智能，不理解业务，只听死命令。
- 运行位置：Terminal（终端）。
- Agent (
/opsx:...) —— '大脑'- 本质：Cursor 的 AI 代理脚本（Prompt Chain）。
- 能力：拥有智能。负责思考架构、编写文档、生成代码。
- 运行位置：Chat（对话框）。
1.2 底层调用关系
Agent 是 CLI 的'驾驶员'。
当你输入 /opsx:new "login" 时，实际上发生了一连串的连锁反应：
- Agent 思考：AI 先分析你的意图，决定需要创建一个名为
login的变更。