你是不是也遇到过这种情况？刚开始用像 Claude Code 或 Codex 这样的 AI 编程助手时，因为需求没说清楚，结果 AI 生成的代码根本不是你想要的，白白浪费了好多时间和金钱。

最近Github有人分享了一个叫 OpenSpec 的开源工具，它就是来解决这个问题的。

Github指路：：http://github.com/Fission-AI/OpenSpec

OpenSpec是什么：
OpenSpec 是一个轻量级的、由规范驱动的框架，专为编码助手（coding agents）和命令行界面（CLIs）设计。它提倡一个“规范驱动开发”的理念，意思是在你和 AI 助手真正开始写代码之前，先把要做的东西通过“规范”给固定下来，确保你和 AI的目标完全一致。

简单来说，它帮你把所有的变更提案、要做的任务和规范的修改都统一管理起来。这样，你每次开发的目标都特别清晰，产出的东西也方便回顾和审查。

亮眼的功能：

集成度高：它原生支持像 Claude Code、Cursor、Codex 这些主流 AI 工具的斜杠命令，用起来很顺手。

管理清晰：它会帮你创建结构化的文件夹，把提案、任务和规范更新分门别类放好。

历史可追溯：你每次修改规范，它都会自动生成增量文件，这样所有的变更历史都清清楚楚。

易于维护：它内置了验证和归档功能，保证你的规范格式始终正确，方便长期维护。

兼容性强：它还兼容 AGENTS.md 规范，能和更多的 AI 工具集成。

支持协作：团队里不同的人可以用自己习惯的 AI 工具，同时共享和维护同一套规范。

实现逻辑：

如何安装：

#全局安装
npm install -g @fission-ai/openspec@latest

#确认安装
openspec --version

#初始化OpenSpec,导航到目录
cd my-project

#运行初始化
openspec init

初始化过程：

系统会提示您选择任何原生支持的 AI 工具（例如 Claude Code、CodeBuddy、Cursor、OpenCode 等）；其他助手始终依赖于共享的 AGENTS.md 文件。

选择AI工具后项目中会创建一个新的 openspec/ 目录结构：

openspec/
├── specs/
│   └── auth/
│       └── spec.md           # Current auth spec (if exists)
└── changes/
    └── add-2fa/              # AI creates this entire structure
        ├── proposal.md       # Why and what changes
        ├── tasks.md          # Implementation checklist
        ├── design.md         # Technical decisions (optional)
        └── specs/
            └── auth/
                └── spec.md   # Delta showing additions

开始项目：
 

以一个文件管理系统为例：

一：首先我们先打开OpenSpect为我们自动创建的project文件，填入我们的需求：

二：以通过Cline调用AI模型来帮我们完成项目为例，把下面的内容发给Cline：

1. Populate your project context:
   "Please read openspec/project.md and help me fill it out
    with details about my project, tech stack, and conventions"

2. Create your first change proposal:
   "I want to add [YOUR FEATURE HERE]. Please create an
    OpenSpec change proposal for this feature"

3. Learn the OpenSpec workflow:
   "Please explain the OpenSpec workflow from openspec/AGENTS.md
    and how I should work with you on this project"

三：回答澄清问题继续项目

在运行过程中当AI会问你一些问题，这些问题可以让AI更了解你的需求与目标。

以下就是我尝试运行的实战界面：

开发这个完整的web应用总共花费不到0.5元。之所以成本如此之低，是因为我通过Cline调用了PH8平台的AI模型。该平台提供百万token仅0.5元的超值服务，模型折扣力度大且定价透明。即使选用更高端的Claude-sonnet-4.5模型来完成开发，总费用也只需1.5元。

总之，大家可以看到OpenSpec确实是一个可以规范AI行为的工具，既可以帮我们快速生成符合预期的代码，又可以减少垃圾代码，避免浪费大量token并且难以阅读和维护的情况产生。