OpenSpec Vibe 项目

项目简介

OpenSpec 是一套面向 AI 编程助手的"规格驱动开发"（Spec-Driven Development，SDD）框架，由 Fission-AI 团队用 AI 编程方式构建并开源。它要解决的问题非常现实：当 AI 越来越能写代码时，真正的瓶颈从"怎么写"变成了"先想清楚要写什么"。OpenSpec 通过在写代码之前先产出一份可评审的规格说明（proposal、specs、design、tasks），让 AI 与开发者在同一份"事实来源"上对齐，避免 AI 在模糊需求下盲目生成代码。

项目的设计哲学强调"流畅而非僵化、迭代而非瀑布、简单而非复杂"，既适用于全新项目（greenfield），也专为存量代码库（brownfield）优化。所有规格文件都是纯 Markdown，没有需要额外学习的特殊语法，开发者可以直接阅读、评审与版本管理。

核心功能

• 规格先行工作流：用 /opsx:propose 让 AI 先生成提案、规格、技术设计与任务清单，开发者确认后才进入编码阶段
• 纯 Markdown 规格文件：需求与验收场景以普通 Markdown 书写，无专有语法，便于 Git 管理与团队评审
• 探索式对话入口：/opsx:explore 提供零风险的思路探讨，帮助用户在动手前把需求想清楚
• 一键应用与归档：/opsx:apply 按任务清单逐项实现，/opsx:archive 完成后归档变更并同步更新规格
• 团队级 Stores 规划库：把规格放在独立仓库中，一份需求可被多个代码仓库、多个编码智能体共享读取
• 跨仓库特性支持：一个变更、一份计划，即使代码分散在 API 服务、Web 应用与共享库三个仓库也保持一致
• 多 AI 助手兼容：适配 Claude Code、Cursor 等主流编程智能体，支持原生插件安装或 CLI 方式接入

技术实现

OpenSpec 以 Node.js 项目形态发布在 npm 上，包名为 @fission-ai/openspec，要求 Node.js 20.19.0 或更高版本，可全局安装后通过 openspec init 在任意项目内初始化。它的核心是一套围绕 openspec/ 目录结构的约定：specs/ 存放已固化的需求规格，changes/ 存放进行中的变更提案，每个变更包含 proposal.md（为什么做、改什么）、specs/（需求与场景）、design.md（技术方案）与 tasks.md（实现清单）。

规格文件采用结构化的 Markdown 约定：用 ## ADDED Requirements 声明新增需求，每个需求下用 #### Scenario: 描述具体可验证的场景，配合 WHEN/THEN 句式约束行为。这种写法既方便人读，也方便 AI 稳定解析。CLI 提供初始化、校验、归档等命令，并与主流编程智能体通过 slash 命令（如 /opsx:propose、/opsx:apply）集成。对于团队，Stores 机制允许把规格库作为独立 Git 仓库，通过 git push 共享，实现"规格先行、代码后追"的协作模式，避免需求散落在各自的仓库或逐渐失真的 Wiki 中。

快速上手

1. 确认本地已安装 Node.js 20.19.0 或更高版本
2. 全局安装 CLI：npm install -g @fission-ai/openspec@latest
3. 进入项目目录并初始化：cd your-project && openspec init
4. 在支持的 AI 编程助手中运行 /opsx:propose "你的想法"，生成提案、规格、设计与任务清单
5. 评审通过后执行 /opsx:apply 逐项实现，完成后用 /opsx:archive 归档并同步规格

适用人群

• 使用 Claude Code、Cursor 等 AI 编程工具、希望用规格约束 AI 输出的开发者
• 需要让多人与多个编码智能体围绕同一份需求对齐的研发团队
• 维护存量代码库、需要谨慎引入 AI 生成代码的工程团队
• 研究 AI 辅助软件工程流程、关注 SDD 方法论的从业者

出品方

Fission-AI 团队，开源仓库：https://github.com/Fission-AI/OpenSpec，npm 包：@fission-ai/openspec。