登录 注册

OpenSpec （AI规范驱动开发工具）

去点 Star
AI 应用与 AI Agent
74,689
Stars
—
Forks
0
Watchers
—
Open Issues
待补全
许可证
TypeScript
语言
—
创建时间
最近更新

项目能做什么

面向 AI 编程助手的规范驱动开发（SDD）工具与工作流。
来源：基于仓库元数据 · 内容以仓库实际 README 为准

使用说明 查看原始 README 原仓库文档 

{
  "name": "OpenSpec",
  "description": "专为 AI 编程助手设计的规范驱动开发（SDD, Spec-driven development）框架，帮助开发者和团队在让 AI 写代码前先结构化梳理需求、设计和任务。",
  "readme": "## 项目简介\n\nOpenSpec 是一个面向 AI 编程助手的“规范驱动开发（Spec-driven development，简称 SDD）”框架。它的设计理念是：灵活、迭代、简洁，既适用于新项目也支持既有存量项目（Brownfield），并能从个人项目平滑扩展至企业级规模。\n\n通过 OpenSpec，你可以让 AI 在编写具体代码前，先以纯 Markdown 格式生成需求场景、技术方案与实施清单，确认无误后再执行代码改动。\n\n---\n\n## 核心功能\n\n- **标准化的 AI 交互工作流**：\n  - `/opsx:explore`：探索方案，与 AI 讨论实现路径。\n  - `/opsx:propose <name>`：生成变更规范（包括 `proposal.md` 提案、`specs/` 需求规范、`design.md` 技术方案、`tasks.md` 实施清单）。\n  - `/opsx:apply`：让 AI 依照清单逐项编写/实现代码。\n  - `/opsx:archive`：归档已完成变更并更新规范库。\n- **纯 Markdown 规范（Plain Markdown）**：无特殊复杂语法，使用直观的“需求（Requirement）+ 场景（Scenario / WHEN... THEN...）”结构，由 AI 编写、人来把关审核。\n- **OpenSpec Stores（Beta 功能）**：支持跨仓库管理规划。\n  - 支持跨代码库特性（Cross-repo features）：一个规范变更统筹涉及多个代码仓库的代码改动。\n  - 统一需求源：规范独立托管与共享，团队与 AI 代理均可直接读取，避免需求文档脱节。\n  - 先行规划：代码尚未编写前，即可先在 Store 中落地设计计划。\n- **可视化控制台（Dashboard）**：提供直观的项目规范与变更面板。\n\n---\n\n## 适合谁用\n\n- **个人开发者**：约束和校准 AI 编程助手，避免 AI 在单体项目中“盲目写代码”和脱离预期。\n- **工程研发团队**：特性跨越多个代码仓库（例如同时涉及 API、前端、公共库）或需要集中管理需求基线的开发团队。\n\n---\n\n## 安装步骤\n\n### 1. 安装 OpenSpec CLI\n\n- **macOS / Linux** 终端执行：\n  ```bash\n  curl -fsSL https://openspec.dev/cli/install.sh | sh\n  ```\n\n- **Windows** PowerShell 执行：\n  ```powershell\n  irm https://openspec.dev/cli/install.ps1 | iex\n  ```\n\n- **包管理器方式**：\n  - npm（需要 Node.js 22.12.0 或更高版本）：\n    ```bash\n    npm install -g @fission-ai/openspec@latest\n    ```\n  - Homebrew：\n    ```bash\n    brew install openspec\n    ```\n\n### 2. 项目初始化\n\n进入你的目标项目目录并运行：\n\n```bash\ncd your-project\nopenspec init\n```\n\n---\n\n## 配置说明\n\n此部分原文未说明具体配置文件或参数选项，请查看原仓库及官方文档。\n\n---\n\n## 常见问题\n\n此部分原文未说明，请查看原仓库。"
}
原始 README 摘录（英文原文，节选前 3000 字符） 
<p align="center">
  <a href="https://github.com/Fission-AI/OpenSpec">
    <picture>
      <source srcset="assets/openspec_bg.png">
      <img src="assets/openspec_bg.png" alt="OpenSpec logo">
    </picture>
  </a>
</p>

<p align="center">
  <a href="https://github.com/Fission-AI/OpenSpec/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/Fission-AI/OpenSpec/actions/workflows/ci.yml/badge.svg" /></a>
  <a href="https://www.npmjs.com/package/@fission-ai/openspec"><img alt="npm version" src="https://img.shields.io/npm/v/@fission-ai/openspec?style=flat-square" /></a>
  <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" /></a>
  <a href="https://discord.gg/YctCnvvshC"><img alt="Discord" src="https://img.shields.io/discord/1411657095639601154?style=flat-square&logo=discord&logoColor=white&label=Discord&suffix=%20online" /></a>
</p>

<details>
<summary><strong>The most loved spec framework.</strong></summary>

[![Stars](https://img.shields.io/github/stars/Fission-AI/OpenSpec?style=flat-square&label=Stars)](https://github.com/Fission-AI/OpenSpec/stargazers)
[![Downloads](https://img.shields.io/npm/dm/@fission-ai/openspec?style=flat-square&label=Downloads/mo)](https://www.npmjs.com/package/@fission-ai/openspec)
[![Contributors](https://img.shields.io/github/contributors/Fission-AI/OpenSpec?style=flat-square&label=Contributors)](https://github.com/Fission-AI/OpenSpec/graphs/contributors)

</details>
<p></p>
Our philosophy:

```text
→ fluid not rigid
→ iterative not waterfall
→ easy not complex
→ built for brownfield not just greenfield
→ scalable from personal projects to enterprises
```

<p align="center">
  Follow <a href="https://x.com/0xTab">@0xTab on X</a> for updates · Join the <a href="https://discord.gg/YctCnvvshC">OpenSpec Discord</a> for help and questions.
</p>

<!-- TODO: Add GIF demo of /opsx:propose → /opsx:archive workflow -->

## See it in action

```text
You: /opsx:explore
AI:  What would you like to explore?
You: I want dark mode but I'm not sure how to do it cleanly.
AI:  Let me look at your styling setup...
     Cleanest path here: CSS variables + a small theme context,
     with system-preference detection. No new dependencies. Scope it?
You: Yes, let's do it.

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.
```

<details>
<summary><strong>What do the specs actually look
阅读完整原文

项目深度分析 规则生成（AI 未配置）

综合评分 48.8 分。该项目在“个人可实施性”维度得 57 分，“付费可能性”维度得 32.0 分，差异化空间 40.0 分（评分依据见评分卡）。

面向细分需求的二次开发产品

产品构想基于 OpenSpec 的核心能力，聚焦一个更窄的场景（如某平台、某行业）做差异化。
目标用户该细分场景用户
难度/周期中 · 2~6 周
收费模式买断制 / 订阅制 / 广告
竞争风险细分需求规模需验证
依据 AI 推测：基于项目主题标签的判断

封装为在线小工具或 API 服务

产品构想把项目最常用的一个功能做成网页小工具，靠流量变现或按量计费。
目标用户搜索引擎带来的长尾用户
难度/周期低 · 1~3 周
收费模式免费引流 + 增值功能 / API 按量计费
竞争风险同质化竞争，需做好 SEO
依据 AI 推测：基于技术栈与部署特征的判断
以上为规则引擎基于仓库公开数据生成的参考结论，包含推测成分，不构成投资或创业承诺；配置 AI 后可获得更深入的分析。
报告会保存到 个人中心

竞品与相似项目 GitHub Search 真实检索

相似项目数据正在完善中，暂不展示（避免误导）

项目优势与风险

技术成熟度创建时间待补全，最近推送 ，发布过 58 个 Release
社区活跃Star 74,689 / Fork 0 / Issue 0（数据支持，可自行核实）
许可证未检测到（需人工确认）
主要风险上游项目方向可能变化；同赛道竞争者较多（见竞品表）；热度与需求不完全等价

安装与使用

此项目未提供 Docker 镜像，安装步骤以原仓库 README 为准（涉及依赖安装与环境配置，对新手门槛较高）。