BAIZE AI RESOURCE

OpenSpec|AI 驱动的规格驱动开发工作流

OpenSpec|AI 驱动的规格驱动开发工作流

面向开发者与团队的开源规格驱动开发工具,通过提案、规格和任务清单让人与 AI 编码助手在动手编码前对齐需求。

OpenSpec|AI 驱动的规格驱动开发工作流

资源介绍

OpenSpec 是一个开源工具,帮助开发者和 AI 编码助手在编写代码前就“要构建什么”达成一致。它通过“规格驱动开发”方法论,将变更拆分为提案、规格和任务清单,让 AI 生成计划、人类审查批准,从而避免 AI 在开发中途跑偏。OpenSpec 包含两部分:一个终端 CLI 工具(openspec)和一组 AI 聊天中的斜杠命令(/opsx:*)。它支持 30+ 主流 AI 工具,并允许通过项目配置、自定义 schema 和共享上下文进行灵活定制。

应用能力

规格驱动开发

通过提案、规格、任务清单等工件,让 AI 与人类在编码前对齐需求,减少返工。

双界面交互

提供终端 CLI(openspec)和 AI 聊天斜杠命令(/opsx:*),适应不同使用习惯。

广泛 AI 工具集成

支持 30+ 主流 AI 编码工具,如 Claude Code、Codex、OpenCode 等,并持续扩展。

灵活定制

支持项目配置、自定义 schema、共享上下文,以及多语言生成工件。

团队协作友好

变更可映射到分支和 Pull Request,支持多 PR 实施和任务清单跟踪。

探索优先模式

提供 /opsx:explore 命令,在提交前与 AI 讨论想法,形成具体计划。

资源配置

应用版本

v1.12.0

运行环境

WindowsmacOSLinux

安装方式

命令安装包管理器安装

依赖环境

Node.js

安装与使用

  1. 安装 OpenSpec CLI:通过 npm、pnpm、yarn、bun 或 Nix 安装,例如 `npm install -g @fission-ai/openspec`。

  2. 初始化项目:在项目根目录运行 `openspec init`,生成 openspec/ 目录和配置文件。

  3. 在 AI 聊天中使用斜杠命令:在支持的 AI 工具(如 Claude Code)中,输入 `/opsx:propose` 等命令,AI 会生成提案和规格。

  4. 审查并批准计划:阅读 AI 生成的提案、规格和任务清单,确认无误后批准。

  5. 实施变更:按照任务清单逐步实现,可跨多个 Pull Request 完成。

  6. 更新规格并归档:变更完成后,更新 specs/ 目录以反映当前状态,并将变更移至 archive/。

使用案例

新功能开发

使用场景开发者想为项目添加一个新功能,但需求模糊。

使用 /opsx:explore 与 AI 讨论想法,形成具体计划;然后使用 /opsx:propose 生成提案和规格,审查批准后实施。

大型代码库改造

使用场景在现有大型代码库中引入 OpenSpec,逐步改进。

参考 existing-projects.md 指南,从关键模块开始,使用规格驱动方式管理变更,避免一次性文档化所有代码。

团队协作开发

使用场景团队多人协作,需要统一变更流程。

将每个变更映射到独立分支和 Pull Request,使用任务清单跟踪进度,通过审查提案确保方向正确。

包含内容

LICENSE-MIT.txt
openspec-source.zip
README-中文安装说明.md
SHA256.txt

常见问题

OpenSpec 是什么?
OpenSpec 是规格驱动开发工具,通过提案、规格、设计与任务等工件,让人与 AI 编码助手在写代码前对齐。
如何安装 OpenSpec?
需先安装 Node.js 20.19.0 或更高版本,再通过 npm、pnpm、yarn、bun 或 Nix 安装;这些命令会下载并执行外部依赖。
OpenSpec 支持哪些 AI 工具?
官方当前说明支持 30+ AI 编码工具;不同工具的命令写法可能不同,应以 openspec init 输出和 Supported Tools 文档为准。
斜杠命令和 CLI 有什么区别?
/opsx:* 等命令在 AI 编码助手中驱动规格工作流;openspec CLI 在终端中负责初始化、更新和项目管理。
许可证有哪些要求?
上游采用 MIT 许可证,允许使用、修改、再分发和商业使用,但副本或实质性部分须保留版权与许可声明;第三方依赖另按各自许可证执行。