### [OpenSpec：为 AI 编程助手打造的规格驱动开发框架，写代码前先对齐需求](https://www.willai.cc/article/4344)

**Published:** 2026-07-26T00:52:45

**Author:** hiyoho

**Excerpt:** OpenSpec：为 AI 编程助手打造的规格驱动开发框架 一、项目简介 OpenSpec 是 Fission AI 开源的一款「规格驱动开发（Spec-Driven Development, SDD）」框架，核心理念是：在写任何一行代码之

![OpenSpec - Spec-Driven Development for AI Coding Assistants](https://admin.hiyoho.com/wp-content/uploads/2026/07/openspec_bg.png)

OpenSpec：为 AI 编程助手打造的规格驱动开发框架

## 一、项目简介

**OpenSpec** 是 Fission AI 开源的一款「规格驱动开发（Spec-Driven Development, SDD）」框架，核心理念是：**在写任何一行代码之前，先让你和 AI 就「要做什么」达成一致**。它为 AI 编程助手补上了一层轻量的规格层（spec layer），把原本只存在于聊天记录里的模糊需求，沉淀成结构化、可评审、可复用的 Markdown 规格文档。截至目前项目已在 GitHub 收获 **62,500+ Stars**，是当前最受欢迎的规格框架之一。

## 二、安装要求与快速上手

**环境要求：**Node.js 20.19.0 或更高版本（同时兼容 pnpm、yarn、bun、nix）。

**全局安装：**

```
npm install -g @fission-ai/openspec@latest
```

**初始化项目：**进入你的项目目录并初始化，OpenSpec 会自动为你的 AI 助手写入配置。

```
cd your-project
openspec init
```

**开始与 AI 对话：**直接在支持的编程助手中使用斜杠命令。

```
# 还没想清楚要做什么？先探索，让 AI 读代码、权衡方案、成型计划
/opsx:explore

# 已经明确需求？直接提出变更提案
/opsx:propose add-dark-mode

# 提案通过后，逐条实施任务
/opsx:apply

# 完成后归档，规格自动更新
/opsx:archive
```

升级只需 `npm install -g @fission-ai/openspec@latest`，再在各项目内运行 `openspec update` 刷新 AI 指令即可。

## 三、核心功能

-   **规格先行、代码后行**：每个变更都会生成独立文件夹，包含 `proposal.md`（为什么做/改什么）、`specs/`（需求与场景）、`design.md`（技术方案）、`tasks.md`（实施清单），人和 AI 先对齐再动手。
-   **纯 Markdown、零学习成本**：规格就是带具体场景（WHEN/THEN）的普通 Markdown，无需学习任何专用语法，AI 负责撰写、你负责评审。
-   **流式而非瀑布**：任何产物随时可改，没有僵硬的阶段闸门（phase gates），支持从探索到实现的自由迭代。
-   **广泛的工具兼容**：通过斜杠命令支持 25+（并持续增长）主流 AI 编程助手，包括 Claude Code、Codex、Cursor 等，不锁定任何 IDE 或模型。
-   **团队级 Stores（Beta）**：把规划放进独立仓库，通过 `git push` 共享，实现跨仓库特性、共享需求、代码未动先立规划——为多团队协作提供单一事实来源。

![OpenSpec Dashboard](https://admin.hiyoho.com/wp-content/uploads/2026/07/openspec_dashboard.png)

OpenSpec 内置仪表盘：可视化查看规格与进行中的变更

## 四、典型使用场景

-   **为老项目做增量特性开发（Brownfield）**：OpenSpec 明确定位「不只是绿地项目」。在成熟代码库里加新功能时，用 `/opsx:explore` 让 AI 先读懂现有代码结构，再权衡最干净的实现路径，避免 AI 凭空乱改。
-   **个人开发者约束 AI「别跑偏」**：单人开发时，规格层能让你和 AI 在单仓库上保持诚实——先评审计划再写代码，杜绝「模糊 prompt → 不可预测结果」的困境。
-   **企业团队跨仓库协作**：一个特性横跨 API 服务、Web 前端和共享库时，用 Stores 把「一个变更、一份计划」共享给三个仓库；平台团队维护规格，产品团队只读引用，让每个编程 Agent 都能读到同一份需求，告别到处漂移的 Wiki。

## 五、推荐理由

体验下来，OpenSpec 最打动我的是它对「轻量」的坚持。同类的 GitHub Spec Kit 更全面但偏重——僵硬的阶段闸门、大量 Markdown、还要配 Python 环境；AWS 的 Kiro 很强却把你锁死在它的 IDE 和 Claude 模型上。OpenSpec 则用一条 `npm install` 就接入你已经在用的工具链，规格全是能随手改的纯 Markdown，真正做到了「有预测性但不繁文缛节」。

官方建议搭配高推理能力的模型（如 Codex、Opus 系列）效果最佳，并注意保持干净的上下文窗口——实施前清理上下文，能显著提升产出质量。对于厌倦了「AI 一顿乱写、结果全靠运气」的开发者，OpenSpec 是一个成本极低、收益明显的习惯升级。MIT 许可，可放心用于商业项目。

## 六、下载地址

-   **GitHub 仓库**：[https://github.com/Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec)
-   **官方网站**：[https://openspec.dev/](https://openspec.dev/)
-   **npm 包**：[@fission-ai/openspec](https://www.npmjs.com/package/@fission-ai/openspec)

* * *

_项目信息：Stars 62,500+ | Forks 4,325 | 主语言 TypeScript | 许可证 MIT | 首次发布 2025-08_

**Tags:** AI, AI Agent, AI开源项目, AI编程, AI编程助手, Claude Code, Codex, Coding Agent, Cursor, MIT许可

**Categories:** 开源项目

---