OpenSpec：AI 编码规格驱动开发框架

项目简介

OpenSpec 是一套面向 AI 编码助手的规格驱动开发（Spec-driven Development，SDD）框架。AI 编码助手能力很强，但当需求只散落在对话历史里时，结果往往不可预测。OpenSpec 在任何代码写出之前，先加一层轻量的规格说明，让人和 AI 就先做什么达成一致。

它的设计理念是：灵活而非僵化、迭代而非瀑布、简单而非复杂、面向已有项目（brownfield）而非只服务全新项目，并且从个人项目到企业团队都能扩展。

规格文件就是普通的 Markdown，需求搭配具体场景，不需要额外学习特殊语法。

主要功能

• 先对齐再动手：在写代码前，人和 AI 先就规格达成一致。
• 结构化的变更目录：每个变更都有自己的文件夹，包含 proposal（为什么做、改什么）、specs（需求与场景）、design（技术方案）、tasks（实施清单）。
• 随时迭代：任何产物都可以在任何时候更新，没有死板的阶段关卡。
• 适配多种工具：通过斜杠命令与 30+ 种 AI 助手配合使用，openspec init 会为所选工具打印正确的命令形式（例如 Cursor、GitHub Copilot 用 /opsx-propose，Codex 用 $openspec-propose）。
• 默认工作流：/opsx:explore 用于还没想清楚时探索方案；/opsx:propose 用于直接提出要构建的功能。扩展工作流还包含 /opsx:new、/opsx:continue、/opsx:ff、/opsx:verify、/opsx:bulk-archive、/opsx:onboard。
• Stores（Beta）：把规划放在独立仓库中，跨仓库共享需求与变更计划，团队和每个编码 agent 都能读到同一份事实来源。
• 仪表盘：提供 Dashboard 视图查看规格与变更状态。

安装与使用

macOS 或 Linux，在终端执行：

curl -fsSL https://openspec.dev/cli/install.sh | sh

Windows，在 PowerShell 执行：

irm https://openspec.dev/cli/install.ps1 | iex

也可以用包管理器：

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

然后进入项目目录初始化：

cd your-project
openspec init

接着就可以和 AI 对话：先用 /opsx:explore 探索思路，或者直接 /opsx:propose <想构建的内容>。

升级 CLI：独立安装方式执行 openspec install；npm 安装执行 npm install -g @fission-ai/openspec@latest；Homebrew 安装执行 brew upgrade openspec。之后在每个项目内运行 openspec update 刷新 AI 指令与斜杠命令。

完整文档见 openspec.dev/docs。

注意事项

• npm 安装需要 Node.js 22.12.0 或更高版本；独立二进制安装不依赖 Node。
• 推荐使用推理能力强的模型，并保持干净的上下文窗口，在开始实现前清空上下文。
• OpenSpec 会收集匿名使用统计，仅包含命令名和版本号，不包含参数、路径、内容或个人信息，CI 中自动关闭。可通过 openspec config set telemetry.enabled false 或环境变量 OPENSPEC_TELEMETRY=0、DO_NOT_TRACK=1 关闭。
• 项目基于 MIT 许可证开源。

本作品整理自 GitHub 开源项目 Fission-AI/OpenSpec，原作者 @Fission-AI，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。