OpenSpec是Fission-AI开源的规范驱动开发框架,专为AI编程助手设计,核心理念是"先写规范,再写代码",通过结构化规范文件让AI执行有据可依,减少需求模糊导致的代码返工。
核心基础信息
- 开发语言:基于TypeScript编写,通过npm安装,支持Node.js 20.19.0及以上版本。
- 开源协议:采用MIT免费开源协议,GitHub项目拥有34900+ Stars。
- 兼容工具:支持Claude Code、Cursor、GitHub Copilot、Windsurf等25+主流AI编码助手,不绑定特定IDE。
核心设计特点
- 四大设计原则:灵活无阶段门、迭代式而非瀑布流、轻量低仪式感、优先适配存量代码库,而非仅支持全新项目。
- 文件化需求管理:所有需求不再散落在聊天记录中,而是以结构化Markdown文件存储在项目仓库的
openspec/specs/目录下,与代码同生命周期管理。 - Delta Spec增量机制:修改需求时无需重写整个规范文件,仅描述变更部分即可,让规范的演进过程清晰可追溯。
- 三层验证体系:从格式、语义到业务逻辑逐层校验规范正确性,确保AI理解的需求和你想表达的内容完全一致。
标准工作流
- 起草阶段:创建变更提案,明确要修改的内容、原因和执行任务清单。
- 实施阶段:AI依据审核通过的规范增量编写代码,按任务清单逐项落地。
- 归档阶段:功能上线后将变更提案归档,把增量规范合并入主规范库,成为后续开发的事实依据。
中文本地化版本
OpenSpec-cn是针对中文开发者推出的汉化版本,全中文CLI交互、内置中文规范模板,支持中文场景下的需求标记,同时完全兼容原版的目录结构和规范格式,中英文版本可在同一团队中混用。