# Fission-AI/OpenSpec – 规范驱动的AI开发框架
## 项目介绍
OpenSpec是一个专注于规范驱动开发（Spec-Driven Development，SDD）的AI编码辅助框架。与传统的AI编程助手不同，OpenSpec强调在动手写代码之前，先用结构化的规范文档来明确需求和设计，从而让AI生成更高质量的代码。
项目的核心理念是”fluid not rigid, iterative not waterfall, easy not complex”——即灵活而非僵化、迭代而非瀑布式、简单而非复杂化。OpenSpec支持从个人项目到企业级项目的全规模开发，已经成为npm上每月下载量极高的热门包。
## 核心特色
规范优先的工作流：先编写详细的SPEC.md规范文档，再让AI根据规范生成代码，保证代码质量。
Artifact引导的新工作流：最新版本支持 /opsx:propose 命令，可以通过对话式交互来迭代和完善规范。
全栈支持：支持前端、后端、全栈项目的规范编写，覆盖React、Node.js、Python等多种技术栈。
与主流AI编码工具集成：可以配合Claude Code、OpenClaw、Cursor等工具使用，作为规范管理的补充。
CLI和API双接口：既有命令行工具，也有npm包 API，方便集成到现有工作流中。
活跃的社区支持：拥有Discord社区和持续更新的文档，遇到问题可以快速获得帮助。
## 安装步骤
第一步：安装Node.js环境
OpenSpec是一个npm包，需要Node.js运行环境。请确保你的系统已安装Node.js（建议v16以上版本）。
第二步：通过npm安装OpenSpec
打开终端，运行以下命令：
npm install -g @fission-ai/openspec
或者使用npx直接运行：
npx @fission-ai/openspec
第三步：初始化项目（可选）
如果你想在一个现有项目中加入OpenSpec，可以运行：
openspec init
这会在项目根目录创建一个默认的SPEC.md模板文件。
第四步：验证安装
运行以下命令验证安装是否成功：
openspec –version
## 使用方法
基础使用流程：
第一步：编写SPEC.md
在项目根目录创建SPEC.md文件，包含以下核心内容：
– 项目概述：项目做什么、解决什么问题
– 技术栈：使用的编程语言、框架、工具
– 功能列表：需要实现的核心功能点
– API设计（如果有后端）：接口定义、参数说明
– 数据模型：关键数据结构
第二步：运行OpenSpec检查规范
openspec check
这个命令会检查SPEC.md的完整性和一致性，确保规范文档没有遗漏。
第三步：结合AI编码工具生成代码
将SPEC.md的内容提供给AI编码工具（如Claude Code、OpenClaw），告诉它”根据这个规范文档来实现项目”。
第四步：使用新工作流（推荐）
运行 /opsx:propose 命令，通过对话式交互来完善规范，OpenSpec会逐步引导你完善每个功能点的细节。
## 适用场景
AI编程辅助：配合AI编码工具使用，让AI生成更符合需求的代码。
需求管理：团队可以用SPEC.md来管理需求，确保开发前对项目有清晰的共识。
代码审查：review代码时对照SPEC.md，检查是否完全实现了规范要求。
新人接手项目：新成员可以通过阅读SPEC.md快速了解项目全貌和设计决策。
## 开源协议
MIT License – 完全开源，可以免费使用和商用。
—
OpenSpec代表了一种新的AI编程工作流——不是让AI直接写代码，而是先让人类明确自己想要什么，再用规范文档来指导AI的行为。这种方式特别适合复杂项目的开发，能有效减少AI生成代码的返工率。
服务支持：如有兴趣不会搭建，可以联系微信：WRYD6166，开源项目搭建10-50元。
暂无评论内容