OpenSpec

先写规格再让 AI 写代码，少返工

OpenSpec 是一个面向 AI 编程助手的规格驱动开发（SDD）工具。它要解决的问题是：当开发者让 Claude Code、Cursor 等 AI 助手写代码时，需求往往散落在聊天记录里，AI 容易跑偏、遗忘上下文，导致返工。OpenSpec 把「先写规格、再写代码」的工程习惯引入 AI 协作流程，让规格文档成为人和 AI 共同的唯一事实来源。核心能力包括：用结构化规格文件描述功能意图与验收标准，让 AI 在动手前先对齐需求；把规格拆解为可执行任务，指导 AI 分步实现；在代码变更时同步维护规格，避免文档与实现脱节；并提供 CLI 与工作流集成，适配主流 AI 编码助手。它本质上是给 AI 编程加了一层「需求契约」，让生成结果更可控、更可审查，适合把 AI 编码从玩具级试验推向团队级工程实践。

开源 unknown 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 68513

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类编程开发

开发团队Fission-AI

所属国家

官网地址https://openspec.dev

GitHubhttps://github.com/Fission-AI/OpenSpec

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai,context-engineering,engineering,planning,prd,sdd,sdlc,spec,spec-driven-development,specification

GitHub 星标★ 68513

30天Star增速

HF 下载量

上线时间2025-08-05 00:00:00

最近更新2026-09-16 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-13

浏览次数0

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Node.js 20.19.0 或更高版本
可用的 AI 编程助手（Claude Code、Cursor、GitHub Copilot、Amazon Q、Codex 等 30+ 工具）
能访问 npm 源以全局安装包
（可选）pnpm、yarn、bun 或 nix 作为替代安装方式
一个待接入 OpenSpec 的项目目录

安装与启动步骤

1安装 OpenSpec CLI

用 npm 全局安装官方包 @fission-ai/openspec，安装后会在终端提供 openspec 命令。
```
npm install -g @fission-ai/openspec@latest
```
2进入项目目录

切换到你要引入规格驱动开发的已有项目根目录，OpenSpec 支持在存量项目上使用。
```
cd your-project
```
3初始化 OpenSpec

在项目内执行初始化，会生成规格目录结构并输出你所选 AI 工具对应的调用命令形式。
```
openspec init
```
4选择工作流配置

默认 profile 已含 explore 与 propose；如需 new/continue/ff/verify 等扩展工作流，先选 profile 再应用。
```
openspec config profile
openspec update
```
5用 AI 提出需求

在 AI 助手里输入斜杠命令提出要构建的内容；还没想清楚可先用 /opsx:explore 探索方案。
```
/opsx:propose "your idea"
```
6如需让 AI 代装

可将 README 中的 setup prompt 粘贴给编码助手，由它安装 CLI、运行 init 并验证结果。

关键配置

配置项	必填	说明	示例
`profile`	否	切换默认或扩展工作流，选完后需执行 openspec update 生效。	`expanded`

如何确认成功

openspec init 执行无报错并在项目内生成规格结构，且 openspec init 输出中能看到对应 AI 工具的推荐调用命令。

常见问题

Q：不确定我的 AI 工具是否支持？

A：README 称支持 30+ 工具，可在仓库 docs/supported-tools.md 查看完整列表。

Q：为什么斜杠命令名字不一样？

A：/opsx:propose 是规范名，Cursor 与 GitHub Copilot 为 /opsx-propose，Amazon Q 为 @opsx-propose，Codex 为 $openspec-propose；openspec init 会打印你所选工具的正确形式。

Q：Node 版本不够怎么办？

A：README 明确要求 Node.js 20.19.0 或更高，请先升级 Node 再安装。

Q：能用 npm 以外的包管理器吗？

A：可以，README 说明同样支持 pnpm、yarn、bun 和 nix，具体见 docs/installation.md。

Q：推荐用什么模型？

A：官方建议使用高推理模型，规划与实现阶段推荐 Codex 5.5 和 Opus 4.7。

注意事项

开始实现前清空上下文窗口，保持良好上下文卫生，OpenSpec 在干净上下文中效果更好。
同时提供 CLI 与工作流集成，适配主流 AI 编码助手，支持个人项目到企业级规模。
除了 greenfield，也面向 brownfield 存量项目设计。
官网 https://openspec.dev 与仓库 docs 目录有更完整的安装与工作流说明。

核心亮点

把需求固化成结构化规格文件，AI 每次生成前先对齐，显著减少跑偏和返工
规格与任务拆解联动，让 AI 分步实现、过程可审查，而非一次性黑盒输出
TypeScript 实现并提供 CLI，易接入现有仓库和主流 AI 编码助手工作流

不足之处

需要团队额外维护规格文档，前期投入增加，小项目可能觉得流程偏重
生态与集成仍在演进，不同 AI 助手的适配深度和最佳实践待观察

适用场景

用 Claude Code/Cursor 开发新功能前，先写规格再让 AI 实现
团队协作中让多个 AI 助手按同一份规格产出代码
把 AI 生成的代码纳入可审查的工程流程，降低失控风险

替代项目

GitHub Spec Kit、BMAD-METHOD

项目介绍

OpenSpec 是一个编程开发领域的开源项目，官方简介：Spec-driven development (SDD) for AI coding assistants.。项目使用 TypeScript 开发，在 GitHub 上获得 68077 星标。

上一篇：jupyter-ai

下一篇：agent-skills