【GitHub趋势】OpenSpec:AI 编程助手的规范驱动开发框架

项目简介

OpenSpec 是面向 AI 编程助手的规范驱动开发（Spec-Driven Development，SDD）框架，由 Fission-AI 维护。它的核心思路是：在写第一行代码之前，先让人与 AI 就「要做什么、怎么验收」达成一致，把需求从易丢失的聊天上下文里抽出来，沉淀为可版本管理、可迭代的结构化规范。

项目采用 MIT 许可证，通过 npm 全局安装 CLI，并在项目内生成 openspec/ 目录树。每个功能变更对应独立文件夹，内含提案、增量规范、技术设计与任务清单等工件，支持 Cursor、Claude Code、GitHub Copilot 等 20 余种 AI 工具通过斜杠命令协作，适合个人项目到企业团队的棕地（既有代码库）迭代场景。

核心特性

• 先对齐再编码：通过 /opsx:explore 探索模糊需求，或用 /opsx:propose 直接创建变更提案，避免 AI「自信地做错方向」。
• 增量规范（Delta Specs）：不整篇重写文档，只标注相对现有规范的 ADDED / MODIFIED / REMOVED，变更边界清晰。
• 工件化工作流：每个变更自动生成 proposal.md（为什么做）、specs/（需求与场景）、design.md（技术方案）、tasks.md（实现清单），结构统一。
• 灵活迭代、无 rigid 阶段门：随时修改任意工件，不像传统瀑布或部分重型 SDD 工具那样卡死在固定阶段。
• 多工具生态：默认 core 配置含 propose、explore、apply、sync、archive；扩展配置还可启用 verify、onboard 等命令，覆盖主流 AI IDE 与 Agent。

快速开始

OpenSpec 要求 Node.js 20.19.0 及以上。全局安装 CLI 后，在项目根目录初始化，即可在 AI 对话中使用斜杠命令驱动完整开发流程：

# 全局安装 OpenSpec CLI
npm install -g @fission-ai/openspec@latest

# 进入你的项目并初始化规范目录
cd your-project
openspec init

# 更新 AI 助手的指令与斜杠命令（升级包后建议重复执行）
openspec update

初始化完成后，在 Cursor 等支持的 AI 工具中可直接对话。若需求尚不清晰，先运行 /opsx:explore 让 AI 阅读代码库、权衡方案；若目标明确，则执行 /opsx:propose add-dark-mode 创建变更文件夹。确认提案后使用 /opsx:apply 按 tasks.md 逐项实现，完成后 /opsx:archive 将变更合并入主规范库。也可通过 openspec config profile 切换扩展工作流，启用 /opsx:verify、/opsx:onboard 等命令。

为什么火了

AI 编程助手能力越强，「需求只活在聊天记录里」带来的不可预测性就越明显——改来改去、理解偏差、返工成本陡增。OpenSpec 踩中了 2025–2026 年「上下文工程」「Agent 工作流」的主流痛点：用轻量规范层把人类意图结构化，又不引入 GitHub Spec Kit 那样偏重的阶段门与复杂 setup，因此在开发者社区快速积累口碑。

另一方面，项目近期重构了基于工件的 OPSX 工作流（/opsx:propose → /opsx:apply → /opsx:archive），并宣称支持 25+ AI 工具、npm 月下载量可观，与 Cursor、Claude Code 等生态深度绑定。在「Vibe Coding」与「可控 AI 开发」的争论中，OpenSpec 提供了中间路线——既保留 AI 编码速度，又用可追踪的 spec 作为单一事实来源，适合 Trending 榜上持续受关注的现实需求。

引用链接