OpenSpec

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

开源 🏷️定价信息待确认 ✅ 目前可打开 编程开发 🍴 复刻 5058 🐛 待处理 193 👀 关注 282
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 73841
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

OpenSpec 项目界面预览图
图片来源:项目官网

项目数据

分类编程开发
开发团队Fission-AI
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型ai,context-engineering,engineering,planning,prd,sdd,sdlc,spec,spec-driven-development,specification
GitHub 星标★ 73841
上线时间2025-08-05 00:00:00
代码更新2026-11-04
仓库体积12.7 MB
本站数据更新2026-11-04
维护状态活跃
收录时间2026-09-13
浏览次数1

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-13 · 当前星标 ★ 73841

使用教程

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

环境要求

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

安装与启动步骤

  1. 1安装 OpenSpec CLI

    用 npm 全局安装官方包 @fission-ai/openspec,安装后会在终端提供 openspec 命令。

    npm install -g @fission-ai/openspec@latest
  2. 2进入项目目录

    切换到你要引入规格驱动开发的已有项目根目录,OpenSpec 支持在存量项目上使用。

    cd your-project
  3. 3初始化 OpenSpec

    在项目内执行初始化,会生成规格目录结构并输出你所选 AI 工具对应的调用命令形式。

    openspec init
  4. 4选择工作流配置

    默认 profile 已含 explore 与 propose;如需 new/continue/ff/verify 等扩展工作流,先选 profile 再应用。

    openspec config profile
    openspec update
  5. 5用 AI 提出需求

    在 AI 助手里输入斜杠命令提出要构建的内容;还没想清楚可先用 /opsx:explore 探索方案。

    /opsx:propose "your idea"
  6. 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

上一篇:jupyter-ai

下一篇:agent-skills

同类项目推荐

Prompt-sensei 开源

本地提示词教练,优化提问,提升 AI 编程效率

Local-first prompt coach for Claude Code and Codex that improves prompts, observes p···

★ 109 2026-08-09
ai-helpers 开源

给 AI 助手装上工具包,少写提示多干活

Developer productivity tools for Claude Code & other AI assistants

★ 121 2026-09-17
crit 开源

给AI代理装个反馈闭环,让每次修改都更懂你

Review AI coding agents' plans, diffs and running apps in the browser. Local-first, ···

★ 1268 2026-08-09
multilspy 开源

用 Python 轻松对接各种语言服务器,快速构建代码智能工具

multilspy is a lsp client library in Python intended to be used to build application···

★ 615 2026-08-09
aider 开源

在终端里用 AI 结对编程,直接改代码并自动提交。

aider is AI pair programming in your terminal

★ 49931 2026-08-09
llm-ls 开源

给任意编辑器接上大模型,代码补全即插即用

LSP server leveraging LLMs for code completion (and more?)

★ 884 2026-09-22
kota 开源

用 Rust 打造的轻量 AI 编码代理,插件化扩展你的开发流程。

A lightweight, highly extensible ai code agent, built in Rust.

★ 101 2026-08-09
oh-my-pi 开源

树莓派装上它,一句话就能指挥小电脑干活

⌥ Coding agent with the IDE wired in. Built by Stencil Labs.

★ 37695 2026-08-09