OpenSpec 是什么1. 基础定义OpenSpec是由 Fission-AIY Combinator 2026 冬季孵化项目推出的开源轻量 Spec-Driven DevelopmentSDD 规范驱动开发框架专门解决 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. 标准化需求与变更追溯所有功能、修改都生成结构化 Spec 规范文档包含需求、场景、验收用例每一次迭代变更独立归档可查看历史版本、谁修改、修改范围区分草稿 / 评审 / 已批准 / 已上线四种规范状态支持团队评审流程3. 轻量化、兼容新旧项目不需要重构现有代码老项目可增量接入不用一次性写完全系统规范不绑定开发语言Go/Java/Python/ 前端 JS/TS 全栈通用兼容市面上 20 AI 编码工具无厂商锁定4. 降低团队协作沟通成本规范文件存入 Git新人接手、交接开发时直接读取openspec/目录即可看懂模块设计不用反复询问老开发。项目目录结构核心存储载体所有规范统一放在项目根目录openspec/分为两大核心文件夹·specs长期稳定模块规范上线后永久留存·changes临时变更草稿开发完成后合并归档进specs四、标准工作流核心流程opsx 四步闭环完整标准化开发流程全程由 CLI AI 斜杠命令驱动/opsx:propose 提案开发者描述需求OpenSpec 自动生成结构化变更提案changes 文件夹输出规范草稿明确做什么、不做什么、约束条件。/opsx:apply 执行AI 读取规范文件严格按照规范编写代码禁止超出规范范围实现额外功能。/opsx:sync 校验同步自动对比代码与规范一致性校验逻辑、入参、异常场景是否符合预期输出校验报告。/opsx:archive 归档功能验收通过后将变更合并到全局specs基准规范永久留存历史记录变更闭环。五、能用来干什么实战场景1. 个人开发规范 AI 编码减少返工新增接口、页面、工具函数前先产出 SpecAI 不会擅自加额外逻辑长时间暂停开发后直接读取历史规范不用重新复述需求自动生成验收测试场景写完代码自动对照规范自查2. 团队协作统一需求标准交接无断层产品 / 开发共同评审 Spec编码前对齐需求避免上线前需求变更Git 提交规范变更文档代码评审时同步看设计约定新人入职直接翻阅仓库内所有模块规范快速熟悉业务3. 全类型项目落地后端接口开发在 Spec 中定义接口入参、返回、错误码、鉴权规则AI 自动生成 OpenAPI 文档、CRUD 代码、单元测试前端页面 / 组件规范交互逻辑、状态切换、样式约束、边界场景防止 AI 随意修改全局样式算法 / 脚本工具定义输入输出、精度约束、异常分支AI 严格按指标实现逻辑存量老项目迭代不用一次性重构全部文档新增功能只写对应模块 Spec逐步沉淀项目知识库4. 自动化工程能力CI/CD 集成流水线自动校验代码是否匹配 Spec 规范不合规阻断合并可视化看板MCP 配套 Web 面板查看所有进行中、已完成变更任务进度看板多 AI 统一适配一套规范同时给 Copilot、Claude、Cursor 使用输出结果一致六、Spec 规范文件标准格式MarkdownYAML每个 spec.md 文件包含机器可解析元数据 自然语言需求示例模板结构化格式让 AI 能精准识别需求、场景、验收标准不会曲解意图。七、核心优势总结轻量化5 分钟安装初始化无复杂配置不用重型项目管理系统零供应商锁定兼容所有主流 AI 编码工具不绑定 IDE / 模型存量项目友好支持增量规范不用一次性完善全系统文档可追溯、可评审所有需求变更永久存入代码仓库审计清晰大幅节省 Token减少反复沟通澄清需求降低 AI 调用成本