• OpenSpec 是什么

1. 基础定义

OpenSpec是由 Fission-AI（Y Combinator 2026 冬季孵化项目）推出的开源轻量 Spec-Driven Development（SDD 规范驱动开发）框架，专门解决 AI 编码助手（Copilot、Claude Code、Cursor、Amazon Q 等）开发时需求模糊、上下文丢失、代码不可控、变更无追溯的痛点openspec.p...。 简单一句话：先定规范、再写代码，让 AI 严格按约定开发，杜绝自由发挥。

OpenSpec 命令行面板

2. 核心定位区分（避免和 OpenAPI 混淆）

很多人会把 OpenSpec 和 OpenAPI（接口规范标准）搞混，二者完全不是一类东西：

3. 技术形态

• 主体：Node.js CLI 工具，全局命令openspec，一键安装npm install -g @fission-ai/openspec
• 配套：/opsx:*AI 专属斜杠指令，IDE 内直接调用规范流程
• 可选扩展：MCP 服务端（对接所有兼容 MCP 的 AI）、Web 可视化看板、任务看板、审批流
• 无强制依赖：核心功能不需要 API Key，完全本地运行，规范文件随代码入库 Git

• 核心作用

1. 解决 AI 编程最大痛点：“猜需求、乱实现”

传统 “聊天式编码（Vibe Coding）” 问题：

• 口头描述需求，AI 理解偏差，反复改代码浪费 Token
• 关闭会话、重启 IDE 后历史上下文全部丢失，重新沟通
• 多人协作时，没人知道这个功能当初设计边界、验收标准

OpenSpec 解决方案：把需求固化成机器可读规范，AI 只能基于规范编码，所有上下文永久存在仓库。

2. 标准化需求与变更追溯

1. 所有功能、修改都生成结构化 Spec 规范文档，包含需求、场景、验收用例
2. 每一次迭代变更独立归档，可查看历史版本、谁修改、修改范围
3. 区分草稿 / 评审 / 已批准 / 已上线四种规范状态，支持团队评审流程

3. 轻量化、兼容新旧项目

• 不需要重构现有代码，老项目可增量接入，不用一次性写完全系统规范
• 不绑定开发语言：Go/Java/Python/ 前端 JS/TS 全栈通用
• 兼容市面上 20+ AI 编码工具，无厂商锁定

4. 降低团队协作沟通成本

规范文件存入 Git，新人接手、交接开发时，直接读取openspec/目录即可看懂模块设计，不用反复询问老开发。

• 项目目录结构（核心存储载体）

所有规范统一放在项目根目录openspec/，分为两大核心文件夹：

·specs：长期稳定模块规范，上线后永久留存

·changes：临时变更草稿，开发完成后合并归档进specs

四、标准工作流（核心流程：opsx 四步闭环）

完整标准化开发流程，全程由 CLI + AI 斜杠命令驱动：

1. /opsx:propose 提案开发者描述需求，OpenSpec 自动生成结构化变更提案（changes 文件夹），输出规范草稿，明确做什么、不做什么、约束条件。
2. /opsx:apply 执行AI 读取规范文件，严格按照规范编写代码，禁止超出规范范围实现额外功能。
3. /opsx:sync 校验同步自动对比代码与规范一致性，校验逻辑、入参、异常场景是否符合预期，输出校验报告。
4. /opsx:archive 归档功能验收通过后，将变更合并到全局specs基准规范，永久留存历史记录，变更闭环。

五、能用来干什么（实战场景）

1. 个人开发：规范 AI 编码，减少返工

• 新增接口、页面、工具函数前，先产出 Spec，AI 不会擅自加额外逻辑
• 长时间暂停开发后，直接读取历史规范，不用重新复述需求
• 自动生成验收测试场景，写完代码自动对照规范自查

2. 团队协作：统一需求标准，交接无断层

• 产品 / 开发共同评审 Spec，编码前对齐需求，避免上线前需求变更
• Git 提交规范变更文档，代码评审时同步看设计约定
• 新人入职直接翻阅仓库内所有模块规范，快速熟悉业务

3. 全类型项目落地

1. 后端接口开发在 Spec 中定义接口入参、返回、错误码、鉴权规则，AI 自动生成 OpenAPI 文档、CRUD 代码、单元测试
2. 前端页面 / 组件规范交互逻辑、状态切换、样式约束、边界场景，防止 AI 随意修改全局样式
3. 算法 / 脚本工具定义输入输出、精度约束、异常分支，AI 严格按指标实现逻辑
4. 存量老项目迭代不用一次性重构全部文档，新增功能只写对应模块 Spec，逐步沉淀项目知识库

4. 自动化工程能力

• CI/CD 集成：流水线自动校验代码是否匹配 Spec 规范，不合规阻断合并
• 可视化看板：MCP 配套 Web 面板查看所有进行中、已完成变更，任务进度看板
• 多 AI 统一适配：一套规范同时给 Copilot、Claude、Cursor 使用，输出结果一致

六、Spec 规范文件标准格式（Markdown+YAML）

每个 spec.md 文件包含机器可解析元数据 + 自然语言需求，示例模板：

结构化格式让 AI 能精准识别需求、场景、验收标准，不会曲解意图。

七、核心优势总结

1. 轻量化：5 分钟安装初始化，无复杂配置，不用重型项目管理系统
2. 零供应商锁定：兼容所有主流 AI 编码工具，不绑定 IDE / 模型
3. 存量项目友好：支持增量规范，不用一次性完善全系统文档
4. 可追溯、可评审：所有需求变更永久存入代码仓库，审计清晰
5. 大幅节省 Token：减少反复沟通澄清需求，降低 AI 调用成本