OpenSpec 详解：最受欢迎的 AI 规范框架
OpenSpec 是由 Fission-AI 开源的一个轻量级规范驱动开发（SDD）框架，号称"最受欢迎的规范框架"。它为 AI 辅助编码添加了一层轻量级的规范层，让开发者和 AI 在写代码之前先对齐需求，从而避免模糊提示带来的不可预测结果。OpenSpec 支持 25+ 种 AI 工具，采用 MIT 许可证，社区活跃，目前已发布 38 个版本。
1、OpenSpec 概述
1.1、项目背景
OpenSpec 诞生于 AI 编码助手爆发式增长的背景下。AI 模型擅长模式补全但不擅长读心术——当开发者输入"给应用添加照片分享功能"时，AI 必须猜测格式、权限模型、大小限制、存储方式等数十个未声明的假设。OpenSpec 通过在代码编写之前建立明确的规范，解决了这一问题。
1.2、设计理念
OpenSpec 的核心哲学可以概括为五个原则：
• 流动而非僵化（fluid not rigid）
• 迭代而非瀑布（iterative not waterfall）
• 简单而非复杂（easy not complex）
• 为棕地项目而生（built for brownfield not just greenfield）
• 从个人项目到企业级可扩展（scalable from personal projects to enterprises）
1.3、开源信息
• GitHub：https://github.com/Fission-AI/OpenSpec
• 许可证：MIT
• 语言：TypeScript（99.2%）
• Stars：社区活跃，Issues 275+，Commits 602+
• 最新版本：v1.4.1（2026-06-03）
2、核心工作流程
OpenSpec 采用以工件（artifact）为导向的工作流，通过斜杠命令与 AI 交互。典型的工作流程如下：
You: /opsx:propose add-dark-mode
AI: Created openspec/changes/add-dark-mode/
✓ proposal.md — why we're doing this, what's changing
✓ specs/ — requirements and scenarios
✓ design.md — technical approach
✓ tasks.md — implementation checklist
Ready for implementation!
You: /opsx:apply
AI: Implementing tasks...
✓ 1.1 Add theme context provider
✓ 1.2 Create toggle component
✓ 2.1 Add CSS variables
✓ 2.2 Wire up localStorage
All tasks complete!
You: /opsx:archive
AI: Archived to openspec/changes/archive/2025-01-23-add-dark-mode/
Specs updated. Ready for the next feature.3、快速开始
3.1、安装要求
需要 Node.js 20.19.0 或更高版本。
3.2、全局安装
npm install -g @fission-ai/openspec@latest3.3、项目初始化
cd your-project
openspec init3.4、开始使用
告诉 AI 你的需求：
/opsx:propose <what-you-want-to-build>如果需要完整工作流（/opsx:new、/opsx:continue、/opsx:ff、/opsx:verify、/opsx:bulk-archive、/opsx:onboard），可以通过以下命令选择：
openspec config profile
openspec update4、核心命令详解
4.1、/opsx:propose — 提出变更
创建一个新的变更提案，自动生成以下工件：
• proposal.md：变更原因和范围
• specs/：需求规格和场景
• design.md：技术方案
• tasks.md：实现任务清单
4.2、/opsx:apply — 应用实现
根据 tasks.md 中的任务清单，AI 自动执行实现步骤。
4.3、/opsx:archive — 归档变更
将完成的变更归档到 openspec/changes/archive/ 目录，更新规范，为下一个功能做准备。
4.4、扩展工作流命令
• /opsx:new：创建新规范
• /opsx:continue：继续当前工作
• /opsx:ff：快进（fast-forward）
• /opsx:verify：验证实现
• /opsx:bulk-archive：批量归档
• /opsx:onboard：项目接入
5、与竞品对比
5.1、vs GitHub Spec Kit
Spec Kit thorough 但重量级，有严格的阶段门控、大量 Markdown、需要 Python 环境。OpenSpec 更轻量，允许自由迭代。
5.2、vs Kiro（AWS）
Kiro 功能强大但锁定在其 IDE 中，且仅限 Claude 模型。OpenSpec 与你已有的工具配合使用，不限定 IDE 或模型。
5.3、vs 无规范开发
没有规范的 AI 编码意味着模糊提示和不可预测的结果。OpenSpec 带来可预测性，同时避免了繁琐的仪式。
6、项目结构
OpenSpec 初始化后，项目结构如下：
openspec/
├── changes/
│ ├── add-dark-mode/
│ │ ├── proposal.md
│ │ ├── specs/
│ │ ├── design.md
│ │ └── tasks.md
│ └── archive/
│ └── 2025-01-23-add-dark-mode/
└── workspace.yaml7、模型推荐与最佳实践
7.1、模型选择
OpenSpec 最适合高推理能力的模型。官方推荐：
• Codex 5.5（规划和实现）
• Opus 4.7（规划和实现）
7.2、上下文卫生
OpenSpec 受益于干净的上下文窗口。建议在开始实现前清除上下文，并在整个会话中保持良好的上下文卫生。
8、更新与维护
8.1、升级包
npm install -g @fission-ai/openspec@latest8.2、刷新代理指令
在每个项目中运行以下命令，重新生成 AI 指导并确保最新的斜杠命令处于激活状态：
openspec update9、社区与生态
9.1、社区 Schema
第三方 Schema 包通过独立仓库分发，提供与 OpenSpec 集成的其他工具的意见化工作流，类似于 GitHub Spec Kit 的社区扩展目录。
9.2、支持的工具
OpenSpec 支持 25+ 种 AI 助手和工具，包括 Cursor、Windsurf、Claude Code、GitHub Copilot、CodeRabbit、IBM Bob 等，且数量还在增长。
9.3、社区资源
• Discord：https://discord.gg/YctCnvvshC
• X/Twitter：@0xTab
10、总结
OpenSpec 是 AI 时代规范驱动开发的轻量级解决方案。它不像 GitHub Spec Kit 那样重量级和僵化，也不像 Kiro 那样锁定特定 IDE 和模型。OpenSpec 的核心理念是"先对齐，后构建"——在写代码之前，人和 AI 先就规范达成一致。
对于正在使用 AI 辅助编码的开发者，OpenSpec 提供了一种低门槛、高灵活性的规范管理方式。每个变更都有自己的文件夹，包含提案、规格、设计和任务，组织清晰且易于迭代。无论是个人项目还是企业级应用，OpenSpec 都能提供可预测的开发体验，是规范驱动开发领域值得关注的开源项目。
