AI 写代码越来越快，但"写什么"这件事从未被认真解决过。 需求活在聊天记录里，AI 靠猜，人靠纠正，反复拉扯。OpenSpec 试图在这之前插入一层：先对齐，再动手。

核心思路

OpenSpec 的逻辑很简单：每个变更都有自己的文件夹，里面放 proposal、specs、design、tasks 四类 artifact，AI 按照这些文档实现，而不是凭聊天记录猜意图。

这套流程叫 Spec 驱动开发（SDD），和测试驱动开发的思路类似——先定义"要什么"，再写实现。

工作流

OpenSpec 通过 slash command 驱动，核心命令链路如下：

/opsx:new <feature-name>   # 创建变更目录
/opsx:ff                   # 快速生成所有规划文档
/opsx:apply                # AI 按 tasks.md 逐项实现
/opsx:verify               # 验证实现是否符合 spec
/opsx:archive              # 归档，更新主 spec

/opsx:ff（fast-forward）是最常用的入口，一次性生成 proposal、specs、design、tasks，跳过逐步确认的繁琐。

每个 artifact 的职责：

• proposal.md — 为什么做，改什么
• specs/ — 需求与场景
• design.md — 技术方案
• tasks.md — 实现清单，AI 逐项执行

与同类工具的差异

	OpenSpec	Spec Kit (GitHub)	Kiro (AWS)
轻量程度	轻	重	中
工具绑定	20+ AI 工具	无限制	仅自家 IDE + Claude
流程刚性	灵活，可随时更新 artifact	阶段门控	阶段门控

安装

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

Workspace

cd your-project
openspec init

初始化后，在 AI 对话中发送 /opsx:new <what-you-want-to-build> 即可开始。

提示

不一定要用 slash command，也可以直接用自然语言描述需求，AI 会识别意图并 引导走 OpenSpec 流程。

例如："我想给博客加一个暗色模式，帮我走一下 OpenSpec 流程"

OpenSpec 官方文档

支持 Cursor、Claude Code、Windsurf、GitHub Copilot 等 20+ 工具。

OpenSpec 官方文档

贡献者: paiad