OpenSpec 是一个面向 AI 编程助手的规范驱动开发 (Spec-Driven Development) 开源框架，旨在解决 AI 编写代码时因需求模糊或上下文丢失而导致的不一致问题。其核心理念是“先对齐规范，再编写代码”，即在 AI 动手实现功能之前，人与 AI 先就需求、技术方案和任务清单达成共识。
该项目托管在 GitHub 上的 Fission-AI/OpenSpec，采用 MIT 许可证，目前支持 20 余种主流 AI 工具（如 Claude Code、Cursor、GitHub Copilot 等），并已发布 1.2.0 稳定版本。
一、核心工作流OpenSpec 将一个功能的开发拆分为三个清晰的阶段，每个阶段都通过特定的斜杠命令来驱动 AI：
1. 提案 (Propose)：使用 /opsx:new 或 /opsx:propose 命令。AI 会在 openspec/changes/ 目录下为当前功能创建一个专属文件夹，并自动生成四个核心文档：
proposal.md：说明“为什么做”和“要改什么”。specs/：定义具体的新增或修改的需求与场景。design.md：描述技术实现方案。tasks.md：列出可供检查的实现清单。
2. 实施 (Apply)：使用 /opsx:apply 命令。AI 会严格按照 tasks.md 中的清单逐步实现代码，每完成一项便进行勾选，避免进行超出范围的额外修改。
3. 归档 (Archive)：使用 /opsx:archive 命令。当变更完成后，该命令会将本次的修改合并回主规范（openspec/specs/），并将变更文件夹移至归档目录，保持项目整洁。
OpenSpec 的设计注重灵活性与实用性，尤其强调对存量项目（Brownfield）的支持：
轻量级与灵活性：与 GitHub 的 Spec Kit 等强调严格阶段门禁的重型框架不同，OpenSpec 允许你随时更新任意一个制品文档（如提案或设计），没有僵化的流程限制，更适合迭代开发。上下文持久化：规范文件作为代码的一部分存储在文件系统中，受 Git 管理。这解决了在普通聊天中，AI 在新会话开始时容易“失忆”的问题。存量项目友好：针对已有代码库，OpenSpec 提供了 /opsx:onboard 命令，它可以扫描现有代码并生成初始规范，帮助项目快速接入。二、快速安装需要 Node.js 20.19.0 或更高版本。
全局安装 OpenSpec：
npm install -g @fission-ai/openspec@latest# 查看版本号，确认安装成功openspec --version# 查看帮助信息
openspec --help
三、初始化项目现在你可以在项目目录中初始化 OpenSpec：
# 进入你的项目目录cd your-project
# 初始化 OpenSpec
openspec init
初始化时，CLI 会询问你使用哪个 AI 工具（如 Cursor、Github Copilot、Claude Code 等），并自动配置相应的斜杠命令。
现在告诉你的 AI：/opsx:propose <你想构建的内容>
如果你想要扩展工作流 ( /opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard )，请使用 openspec config profile 选择，并通过 openspec update 应用。
四、为什么选择 OpenSpec？AI 编程助手功能强大，但当需求仅存在于聊天记录中时，其行为难以预测。OpenSpec 添加了一层轻量级的规范层，让你在编写任何代码之前就明确要构建什么。
构建前达成一致 — 人类与 AI 在代码编写前对齐规范保持有序 — 每个变更都有独立的文件夹，包含提案 proposal、规范 specs、设计 design 和任务 tasks灵活工作 — 随时更新任何制品，无僵化的阶段门槛使用你的工具 — 通过斜杠命令与 20+ AI 助手协同工作对比分析
vs. Spec Kit (GitHub) — 详尽但重量级。阶段门槛僵化，大量 Markdown，需要 Python 环境。OpenSpec 更轻量，让你自由迭代。
vs. Kiro (AWS) — 功能强大，但锁定在其 IDE 中，且仅限 Claude 模型。OpenSpec 与你已有的工具协同工作。
vs. 无规范 — 没有规范的 AI 编程意味着模糊的提示和不可预测的结果。OpenSpec 在不增加繁琐仪式的情况下带来可预测性。
更新 OpenSpec
升级包：
npm install -g @fission-ai/openspec@latest刷新智能体指令：
在每个项目中运行此命令以重新生成 AI 指导，并确保最新的斜杠命令处于激活状态。
openspec update使用说明
模型选择：OpenSpec 最适合高推理能力模型。推荐 Opus 4.5 和 GPT 5.2 用于规划和实现。
上下文卫生：OpenSpec 受益于干净的上下文窗口。在开始实现前清除上下文，并在整个会话中保持良好的上下文卫生。