> ## Content Index
> Fetch the complete content index at: https://www.hubwiz.com/blog/llms.txt
> Use this file to discover other available public pages before exploring further.

# OpenSpec-规范驱动的AI编码流程
- URL: https://www.hubwiz.com/blog/openspec-spec-driven-ai-coding-workflow/
- Published: 2025-10-19T23:05:07.000Z
- Updated: 2025-10-19T23:05:07.000Z
- Description: 我发现了 OpenSpec——一个小型的命令行工具，它能让 AI 编程助手像真正的队友一样工作。无需 API 密钥，无需复杂的设置，只需规范即可。
- Author: admin
- Tags: TOOL, OPENSPEC, #Import 2026-10-14 14:41

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

就这样，我发现了 [OpenSpec](https://github.com/Fission-AI/OpenSpec?ref=hubwiz.com) —一个小型的命令行工具，它能让 AI 编程助手像真正的队友一样工作。无需 API 密钥，无需复杂的设置，只需规范即可。

![](https://www.hubwiz.com/blog/content/images/2025/10/image-107.png)

## 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)](https://medium.com/coding-nexus/openspec-a-spec-driven-workflow-for-ai-coding-assistants-no-api-keys-needed-d5b3323294fa?ref=hubwiz.com)

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