OpenSpec-规范驱动的AI编码流程

我使用 AI 编程工具已经有一段时间了——Claude、Cursor，甚至 Copilot。它们速度很快，有时甚至神奇……但它们也喜欢即兴发挥。你要求它们“添加个人资料过滤器”，结果突然就得到了一个半成品，勉强能用的功能。

就这样，我发现了 OpenSpec —一个小型的命令行工具，它能让 AI 编程助手像真正的队友一样工作。无需 API 密钥，无需复杂的设置，只需规范即可。

1、问题：聊天 ≠ 规范

大多数 AI 工具会记住你在聊天中说的话——直到它们忘记为止。一旦上下文重置，你的“计划”就会消失。

所以，AI 最终只能依靠直觉进行编码。而我们最终会重写它生成的一半代码。

OpenSpec 正是为此而生。它提供了一个简单、结构化的工作流程，让 AI 能够准确理解要创建的内容——并且你可以在它编写任何一行代码之前看到大家达成的共识。

2、核心理念

OpenSpec 增加了一个规范驱动的工作流程。

你无需在聊天中解释某个功能，并希望 AI 能够正确理解，而是：

• 撰写（或让 AI 起草）提案。
• 共同审查并调整规范。
• 让 AI 实施已批准的计划。
• 将变更归档，以便更新你的项目规范。

就这样，四个步骤，非常轻量。

3、实际操作

假设我想在我的应用中添加个人资料过滤器——用户可以按角色或团队搜索。

我向我的AI输入以下内容：

创建一个OpenSpec变更提案，用于按角色和团队添加个人资料搜索过滤器。

嘭！它搭建了以下文件夹：

openspec/
 └── changes/
      └── add-profile-filters/
           ├── proposal.md
           ├── tasks.md
           └── specs/profile/spec.md

proposal.md解释了“为什么”， tasks.md列出了“如何”，而 specs/文件夹则准确地显示了哪些地方发生了变化。

4、共同审核

现在我问：

你能为角色和团队过滤器添加验收标准吗？

AI更新了规范，我们反复修改，直到符合我的要求。

对齐后，我运行：

/openspec:apply add-profile-filters

然后，AI 使用已批准的计划生成实际代码——一次生成一个任务。没有随机行为，也没有功能缺失。

5、完成后

测试完成后，我告诉 AI：

/openspec:archive add-profile-filters

这会将所有内容合并回我的主要规范——您的真实来源。所有历史记录都保留在  openspec/changes/ 中，因此不会丢失任何内容。

感觉有点像 Git，但用于规范。

6、另一个示例：添加双因素身份验证

以下是 AI 为双因素身份验证功能创建的内容：

## 新增要求
### 要求：双因素身份验证
系统登录时必须要求使用第二个因素。

#### 场景：需要 OTP
- 当用户提交有效凭证时
- 然后需要进行 OTP 验证在 tasks.md 中：

在 tasks.md 中：

- [ ] 将 OTP 密钥列添加到用户表
- [ ] 添加 OTP 验证端点
- [ ] 在前端创建 OTP 输入组件这不仅仅是代码，而是对齐。

这不是代码，这是对齐。

7、设置花了我 2 分钟

我只需要 Node.js 20.19 及以上版本。然后我运行：

npm install -g @fission-ai/openspec@latest
cd my-project
openspec init

它创建了 openspec/ 文件夹，设置了我的 AI 工具的集成，一切准备就绪。

如果您使用的是 Cursor、Claude Code 或 Copilot，它会自动添加  /openspec:proposal 之类的命令。如果没有，请告诉您的 AI“创建一个 OpenSpec 提案”，它仍然可以正常工作。

8、为什么我喜欢它

我以前总是把我的功能规范保存在 Notion 或随机的 Markdown 文件中。OpenSpec 终于把它们直接链接到了 AI 上。

它不会试图取代你的工作流程，而是对其进行补充。你仍然可以使用你最喜欢的编程助手；它只是阻止它们提供你从未请求过的功能。

简而言之，OpenSpec 有一点非常出色：它帮助人类和 AI 在编写任何代码之前就构建内容达成一致。

• 兼容大多数 AI 编程工具
• 无需 API 密钥
• 将规范和变更分开并进行版本控制
• 几分钟内即可完成设置

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

然后向你的 AI 发出请求：

“创建一个 OpenSpec 提案，用于添加暗黑模式。”

就这样——你的 AI 不再猜测，而是开始按照你的意思进行构建。

如果你一直对 AI 代码工具“变得有创意”感到沮丧，OpenSpec 值得一试。它不会让它们变得更聪明——它只会让它们倾听你的指令。

原文链接：OpenSpec: A Spec-Driven Workflow for AI Coding Assistants (No API Keys Needed)

汇智网翻译整理，转载请标明出处