SDD（Spec-Driven Development，规范驱动开发） 是一套研发思想：先定规范、再写代码。开发前把需求、接口、架构、校验规则写成结构化文档，以此约束人工与 AI 编码，避免理解偏差，所有变更可追溯、可校验，解决 AI 写代码 "脑补跑偏"、需求无留存的问题。

OpenSpec 是落地 SDD 的轻量开源工具框架，专为 AI 编程助手（Cursor、Claude Code 等）打造。它在项目里统一存放提案、设计、任务三类规范文档，配套 CLI 命令驱动标准化流程，强制 AI 编码前读取本地规范，沉淀全流程变更记录，适配团队协作与存量项目迭代。是一款轻量化、高灵活度的开源工具，能够高效助力开发者完成项目规范定义、流程梳理、内容归档等全链路开发工作。

项目路径：https://github.com/Fission-AI/OpenSpec

一、OpenSpec 安装教程

OpenSpec 支持全局安装，安装后可在任意目录调用全局命令，快速完成项目配置与流程操作。推荐使用 npm 安装最新稳定版本，确保功能完整、兼容性最佳。

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

执行以上命令即可完成全局安装，安装成功后，终端可识别 openspec 全局指令，无需重复配置环境变量。

二、项目初始化流程

安装完成后，即可在自有项目中初始化 OpenSpec 配置，具体步骤如下：

cd your-project
openspec init

三、OpenSpec 两大核心工作流

为适配不同项目的开发需求，OpenSpec 内置两套差异化工作流：开箱即用的默认快速路径（Core Profile），以及支持精细化自定义的扩展工作流（Expanded Workflow），开发者可根据项目复杂度自由选择。

3.1 默认快速路径 (Core Profile)

这是开箱即用的基础命令集，覆盖了从探索到归档的核心流程。

• /opsx:explore：探索模式。当你有一个模糊的想法时，用它来与 AI 进行自由对话，AI 会研究代码库、对比方案，帮你把想法变具体，且不会生成任何代码或文档。

• /opsx:propose：提出变更方案。当思路明确后，使用此命令让 AI 生成所有必需的规划文档（proposal.md, specs/, design.md, tasks.md）。

• /opsx:apply：开始执行任务。AI 将严格按照 tasks.md 中的任务清单，逐一实现代码并勾选完成项。

• /opsx:update：修订规划制品。在实施过程中，如果需要调整需求或设计，可以用此命令来修改已有的规划文档并保持一致性。

• /opsx:sync：同步规范。将变更中积累的增量规范（delta specs）合并到主规范（openspec/specs/）中。

• /opsx:archive：归档变更。在代码完成并测试通过后，使用此命令归档整个变更。

3.2 扩展工作流命令 (Expanded Workflow)

这些命令提供了更精细的控制，默认未启用。如需使用，需在项目目录执行 openspec config profile 选择 workflows，再运行 openspec update。

• /opsx:new <change-name>：建立新的变更。此命令只创建变更文件夹，不生成任何文档，为后续步骤做准备。

• /opsx:continue：逐步创建文档。与前一个命令搭配使用，每次只根据依赖关系生成一个文档（如 proposal.md），适合需要分阶段审核的场景。

• /opsx:ff：快速生成所有文档 (Fast-Forward)。跳过逐步创建，一次性生成所有规划文档（proposal.md, specs/, design.md, tasks.md），适合需求明确的场景。

• /opsx:verify：验证实现。对照 proposal.md 等规范文档，检查已实现的代码是否符合预期。

• /opsx:bulk-archive：批量归档。一次性归档多个已完成的变更。

• /opsx:onboard：引导式入门。通过交互式引导，帮助你完整地走完整个工作流。

四、实战落地建议

• 新手入门：建议从核心工作流开始，使用 /opsx:explore → /opsx:propose → /opsx:apply → /opsx:archive 这个标准流程，能帮你快速建立规范驱动的开发习惯。

• 复杂需求：如果需求复杂或需要团队评审，可以启用扩展工作流，使用 /opsx:new 和 /opsx:continue 来精细控制每个文档的产出。

• 需求明确：如果对要做的功能非常确定，想快速推进，可以直接使用 /opsx:ff 一次性生成所有规划文档。