星标数:74784★ Fork数:5126 《OpenSpec:面向 AI 编程助手的规格驱动开发》
OpenSpec 是一个规格(spec)框架,旨在让人类与 AI 在写代码之前就先就「要做什么」达成一致。它的设计哲学是:灵活而非僵化、迭代而非瀑布式、简单而非复杂、面向棕地项目而不仅是绿地项目、可从个人项目扩展到企业规模。

AI 编码助手很强大,但当需求只存在于聊天记录里时,它的表现难以预测。OpenSpec 增加了一层轻量的规格层:人和 AI 先对齐规格,再开始写代码。整个流程通过命令与 AI 对话完成,例如用 /openspec-explore 探索想法,用 /openspec-propose 生成变更方案,用 /openspec-apply-change 执行任务,最后用 /openspec-archive-change 归档并更新规格。
规格文件本身是纯 Markdown——包含带具体场景的普通需求描述,没有任何需要学习的特殊语法。AI 负责撰写这些规格,你在任何代码被写出来之前先审阅计划。团队场景下,OpenSpec 提供 Stores(目前为 beta):在一个独立仓库中做规划,通过 git push 共享,让整个团队和每个编码代理都能读到同一份事实来源。
主要特点
- 先共识再动手——人在写代码前先与 AI 对齐规格
- 井然有序——每个变更拥有独立文件夹,包含 proposal、specs、design 和 tasks
- 流畅工作——任何产物随时可更新,没有僵化的阶段门禁
- 规格即普通 Markdown——需求配具体场景,无需学习特殊语法
- 跨仓库规划——Stores 让一次变更、一份计划跨越多个代码仓库,共享需求由平台团队维护、产品团队只读引用
- 适配你的工具——通过 skills 支持 30+ AI 助手
快速开始
macOS 或 Linux 终端安装:
curl -fsSL https://openspec.dev/cli/install.sh | sh
Windows PowerShell 安装:
irm https://openspec.dev/cli/install.ps1 | iex
也可以用包管理器(需要 Node.js 22.12.0 或更高版本)或 Homebrew:
npm install -g @fission-ai/openspec@latest
brew install openspec
进入项目目录并初始化:
cd your-project
openspec init
初始化后即可与你的 AI 对话——还不确定要做什么,就从 /openspec-explore 开始;已经知道要做什么,直接 /openspec-propose <what-you-want-to-build>。完整文档见 openspec.dev/docs。
📊 本项目 GitHub 星标数:74784。最后更新:2026-11-11,发布:2026-11-11。项目地址:https://github.com/Fission-AI/OpenSpec
