用过 AI 写代码的人都经历过这个场景:把需求一句话甩给 AI,它洋洋洒洒写了很多,逻辑看起来能跑,但越改越乱,三轮之后完全不受控制,最后自己重写。

这个问题有个专业名称:Vibe Coding(随意聊天式编程)。2025 年 AI 编程工具爆发,Vibe Coding 的失控问题也随之成为业界共识。

OpenSpec 就是专门针对这个问题的解药。

什么是 OpenSpec

OpenSpec 是由 Fission-AI 开源的**规范驱动开发(Spec-Driven Development, SDD)**框架,专为 Claude Code 等 AI 编程助手设计,目标是把 AI 从"随意聊天的对话者"升级成"严格遵循规范的协作者"。

GitHub 地址:Fission-AI/OpenSpec

核心理念:先让 AI 写规范,再让 AI 写代码。
在这里插入图片描述

核心工作流

OpenSpec 将每个开发任务分成四个阶段:

Proposal(提案)→ Spec(规范)→ Design(技术设计)→ Tasks(任务分解)→ 实现 → Archive(归档)

三个核心命令控制完整生命周期:

命令 作用
/opsx:propose 提交变更提案——说清楚"做什么、为什么做、验收标准是什么"
/opsx:apply AI 按规范逐步实现代码,上下文精确,减少幻觉
/opsx:archive 归档已完成的规范,形成项目知识库

文件结构

项目根目录/
├── AGENTS.md        # 项目规则(AI 每次会话都会优先读取)
├── project.md       # 项目背景和知识库
├── specs/           # 功能规范文件(实现后的 spec)
└── changes/         # 变更提案(待实现的 proposal)

规范即文档,文档是代码唯一的真相来源。

为什么 SDD 能减少 AI 幻觉

Vibe Coding 出问题的根本原因是上下文模糊:AI 靠猜来填充开发者没说清楚的细节,猜错了就是幻觉,改不完就是翻车。

SDD 的解法是精确化上下文

  1. Proposal 阶段,明确功能边界和验收标准
  2. Spec 阶段,把需求翻译成 AI 可执行的结构化约定
  3. Design 阶段,确定技术实现路径
  4. Tasks 阶段,分解成可独立验证的最小单元

每一步都有文档,AI 按图索骥,不靠猜。所有决策可追溯,团队协作也有依据。

Java 开发者的迁移成本:极低

写 Spring 的人对"先定接口再实现"这套思路有天然感觉:

Java 旧习惯:定义 Interface(契约)→ 各方按契约实现
SDD 新习惯:写 Spec 规范(契约)→ AI 按规范实现

载体变了(Java Interface → Markdown 规范),读它的对象变了(人 → AI),核心思路完全一样。

之前越是写过严格接口设计文档的人,SDD 上手越快。

竞品对比

到 2026 年,SDD 已经成为 AI 编程的标配方向,各大工具都有自己的实现:

工具 SDD 方案
OpenSpec /opsx:propose/apply/archive,开源,主打 Claude Code
GitHub Spec Kit GitHub 官方方案
AWS Kiro AWS 出品
Claude Code Superpowers sdd:* 系列 skills
BMAD 社区流行方案

OpenSpec 的优势是开源、社区活跃,且对 Claude Code 集成最深。


AI 编程的质量瓶颈不在模型,在规范。把 OpenSpec 这套工作流跑通,是 Java 转 AI 开发者提升交付质量最直接的路径之一。

更多 Java 转 AI 实战经验,持续更新在知识星球**「Java 转 AI 实战内参」**,当前 99 元/年。

Sources:

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐