Fission-AI/OpenSpec

项目介绍

OpenSpec 在 AI 编程助手上加了一层规格驱动开发流程。需求不再只留在聊天记录里，而是每个变更单独生成一个目录，包含提案、用纯 Markdown 写的需求与场景、技术设计和任务清单。代码开写前由人审阅计划，写完后 AI 继续按同一批文档推进。

交互通过助手里的斜杠命令完成：/opsx:explore 先梳理思路，/opsx:propose <名称> 生成变更目录，/opsx:apply 执行任务，/opsx:archive 把完成的变更归档并更新规格。不同工具的写法不同，例如 Cursor 和 GitHub Copilot 用 /opsx-propose，Amazon Q 用 @opsx-propose，Codex 用 $openspec-propose，openspec init 会打印所选工具的正确形式。

它面向在已有代码库上使用 AI 助手的个人和团队。README 还介绍了一个 beta 阶段的 Stores 功能，用于把规格放在独立仓库、供跨多个代码仓库的团队共享。

快速使用

前提：一个受支持的 AI 编程助手；如果走 npm 安装，需要 Node.js 22.12.0 或更高版本。

1. 安装 CLI。macOS 或 Linux：

   curl -fsSL https://openspec.dev/cli/install.sh | sh
   

   Windows PowerShell：

   irm https://openspec.dev/cli/install.ps1 | iex
   

   也可以使用 npm install -g @fission-ai/openspec@latest 或 brew install openspec。

2. 在项目目录内初始化：

   cd your-project
   openspec init
   

   这一步会创建 openspec/ 目录，并为所选的助手生成指令和命令。

3. 在助手中执行 /opsx:propose add-dark-mode（或对应工具的写法），生成提案、规格、设计和任务，再用 /opsx:apply 实施。完成后 /opsx:archive 会把变更移到 openspec/changes/archive/ 并更新规格。

完整流程见快速入门和安装选项。

使用约束

• 通过 npm 安装时要求 Node.js 22.12.0+；README 也列出了其他包管理器和 Nix 的安装方式。
• 默认配置只包含 /opsx:explore 和 /opsx:propose；扩展流程（/opsx:new、/opsx:continue、/opsx:ff、/opsx:verify、/opsx:bulk-archive、/opsx:onboard）需要先用 openspec config profile 选择，再执行 openspec update 生效。
• 各工具的斜杠命令写法不同，使用前可查看支持的工具列表。
• OpenSpec 会收集匿名遥测：仅命令名和版本号，不含参数、路径或内容。可通过 openspec config set telemetry.enabled false、OPENSPEC_TELEMETRY=0 或 DO_NOT_TRACK=1 关闭。
• README 建议使用推理能力较强的模型，并在开始实现前清空上下文窗口。
• Stores 仍处于 beta 阶段，不使用它也能完成完整流程。
• 许可证为 MIT。

HotRepo 点评

OpenSpec 在全部语言日榜的采样中持续上升：2026-06-27 为 56,979 stars，2026-09-18 为 69,167，2026-11-03 达到 73,781，并在当天 TypeScript 日榜排第 9。讨论量则很少，这里收录的两条 Hacker News 帖子分别只有 2 分和 1 分，其中一条回复把 1.0 的流程描述为基于动作、能感知项目现有产物的系统。Star 增长与讨论量之间的落差说明关注度很广，但这两条帖子并未形成社区评测。

与 GitHub Spec Kit 这类较重的规格系统相比，项目自身强调可自由迭代、不设硬性阶段门，规格用 Markdown 书写、无需专门语法。对已经在多文件代码库中使用 AI 助手的读者，这是让计划可审阅的轻量做法；代价是产出质量仍取决于模型能力，以及人审阅每份提案的认真程度。