规范先行,代码后置:让 AI 编程进入工程化时代

126 阅读8分钟

当所有人都在讨论 AI 如何写代码时,我们更关心 AI 写对代码。


从 Vibe Coding 到规范崩溃:AI 编程的"成长烦恼"

2023 年,ChatGPT 让我们第一次体验到 AI 写代码的魔力。一段自然语言描述,几秒钟后,可运行的代码就呈现在眼前。开发者社区为之沸腾。

2024 年,Cursor、Claude Code 等工具将这种体验推向极致。"Vibe Coding"成为流行词——凭感觉写 prompt,AI 立即生成整个功能模块,甚至整个项目。这种"所想即所得"的开发体验,让独立开发者和创业团队惊呼:开发效率提升了 10 倍!

但好景不长。

当你用 Vibe Coding 快速搭建出第一个原型后,问题接踵而至:

  • 上下文丢失:AI 不记得你上次的需求,每次对话都像"失忆"
  • 代码不一致:今天生成的组件和昨天的风格完全不同
  • 无法维护:一周后你自己都看不懂 AI 生成的代码逻辑
  • 团队协作困难:你的 AI 助手和同事的 AI 助手"各说各话"
  • 需求变更灾难:改一个核心需求,整个代码库需要手动重构

这不是工具的问题,而是方法论的缺失

Vibe Coding 本质上是"即兴式编程"——适合快速原型和探索性开发,但在工程化项目中,它就像在没有图纸的情况下建造摩天大楼。你可能盖得很快,但随时可能倒塌。


规范驱动开发(SDD):AI 编程的工程化范式

软件工程有一个古老的智慧:在动手写代码之前,先想清楚要做什么

传统开发中,我们写需求文档、设计文档、API 规范,然后才开始编码。但这些文档常常沦为"形式主义"——写完就被扔进抽屉,代码和文档各自演进,最终背道而驰。

规范驱动开发(Specification-Driven Development, SDD) 颠覆了这种关系:

规范不再服务于代码,而是代码服务于规范。

在 SDD 工作流中:

  1. 规范是单一事实来源:所有开发活动围绕规范展开
  2. 规范是可执行的:精确、完整、无歧义,可以直接生成代码
  3. 代码是规范的表达:需求变更时,更新规范,代码自动重生成
  4. 规范是活的文档:它不会过时,因为它驱动着代码的演进

SDD 在 AI 时代尤为重要,因为:

  • AI 需要明确的上下文:模糊的 prompt 会产生随机结果,精确的规范会产生确定性输出
  • 规范可以版本化和复用:团队可以共享统一的规范,确保 AI 输出一致
  • 规范消除意图与实现的鸿沟:从"你想要什么"到"AI 生成什么",零信息损失

但这里有个致命问题:谁来写这些规范?

写一份完整的软件设计规范,可能需要产品经理、架构师、开发工程师协作数周。这在快节奏的开发环境中,往往是不可接受的成本。

这正是 Crevo 要解决的问题。


Crevo:规范驱动开发的 AI 加速器

Crevo 是一个基于 MCP 协议的 AI 驱动软件设计文档生成服务。它的核心使命很简单:

让规范生成像对话一样自然,让规范驱动开发成为可能。

核心能力:30 分钟生成企业级软件设计规范

使用 Crevo,你只需要:

  1. 描述你的产品想法(200-500 字的自然语言描述)
  2. Crevo 自动生成 7 类专业设计文档
    • 用户故事文档(User Story)
    • 产品需求文档(PRD)
    • 系统架构设计(Architecture)
    • 业务流程设计(Business Flow)
    • API 设计文档(API Design)
    • 数据库设计(Database Design)
    • 开发计划(Development Plan)

为什么是 7 类文档?

这不是为了满足"流程要求",而是为了给 AI 提供全方位的理解维度

文档类型AI 获得的认知代码生成指导
用户故事用户是谁?需要什么?生成以用户为中心的功能逻辑
PRD功能边界、优先级、验收标准确定开发范围和质量标准
架构设计技术栈、分层结构、部署方案选择合适的框架和模式
业务流程状态转换、异常处理生成状态机和错误处理逻辑
API 设计接口规范、数据格式直接生成 RESTful/gRPC 代码
数据库设计数据模型、关系、索引生成 Schema 和 ORM 代码
开发计划任务分解、依赖关系指导开发顺序和里程碑

每一层规范都为 AI 提供不同维度的约束和指导,确保生成的代码符合你的真实意图。


技术创新:不只是"拼接 Prompt"

Crevo 的技术实现远超简单的"调用 GPT 生成文档":

1. 上下文感知生成:让 7 类文档保持完美一致性

Crevo 基于会话机制(Session) 管理整个文档生成流程。当你生成"系统架构设计"时,Crevo 会自动携带之前生成的"用户故事"和"PRD"的上下文,确保技术选型和业务需求完全对齐。

技术实现

  • 完整的 Chat History 保存
  • 跨文档步骤的上下文传递
  • AI 模型自动理解前序文档的约束

2. 多模型协同:为不同文档类型配置最优 AI 模型

不是所有文档都适合同一个 AI 模型:

  • PRD 生成:适合 Claude 3 Opus(更强的逻辑推理能力)
  • 架构设计:适合 GPT-4 Turbo(更深的技术知识)
  • API 设计:适合 Gemini Pro(更好的结构化输出)

Crevo 支持为每个文档步骤独立配置 AI 模型,确保每类文档都由最擅长的"专家"生成。

3. MCP 协议集成:在 Claude Desktop 中无缝生成规范

Crevo 基于 Model Context Protocol (MCP) 实现,这意味着你可以在 Claude Desktop 中直接调用 Crevo:

  1. 在 Claude Desktop 配置 Crevo MCP Server
  2. 对话中直接描述产品需求
  3. Claude 自动调用 Crevo 工具生成文档
  4. 文档生成后,Claude 可以基于这些规范继续生成代码

这是真正的"对话式规范驱动开发"——规范生成和代码生成在同一个工作流中完成。


为什么 Crevo 是 SDD 的"最佳起点"

对比市面上的方案:

方案生成内容问题
手写文档完整但耗时周期长(数周),成本高
ChatGPT 生成单个文档无上下文,文档间不一致
Claude Code 直接编码代码缺乏规范层,无法长期维护
Crevo完整规范体系✅ 快速、一致、可维护

Crevo 的独特价值

  1. 速度:30 分钟 vs. 传统的 2-4 周
  2. 质量:企业级文档模板 + AI 专业知识
  3. 一致性:7 类文档基于同一上下文生成
  4. 可迭代:支持文档更新和断点续传
  5. 工程化:原生支持 MCP 协议,无缝集成 AI 工作流

更进一步:Crevo + CLAUDE.md = 完整的 AI 开发基础设施

在 SDD 社区,有一个流行实践:在项目根目录创建 .ai/CLAUDE.md 文件,定义 AI 助手的行为准则:

# CLAUDE.md

## 开发准则
- 使用 TDD 开发
- 遵循 DDD 架构模式
- 错误处理必须完整
- 代码必须包含注释

## 技术栈
- 后端:Go + Kratos
- 数据库:PostgreSQL
- 缓存:Redis

CLAUDE.md 的作用:告诉 AI "如何做"(编码风格、架构模式)

Crevo 生成的文档:告诉 AI "做什么"(功能需求、接口规范)

完整配置

项目根目录/
├── .ai/
│   ├── CLAUDE.md              ← AI 的"性格和能力"
│   ├── PRD.md                 ← Crevo 生成(做什么)
│   ├── ARCHITECTURE.md        ← Crevo 生成(怎么架构)
│   ├── API_DESIGN.md          ← Crevo 生成(接口规范)
│   └── DB_DESIGN.md           ← Crevo 生成(数据模型)
├── src/
└── tests/

工作流

  1. 用 Crevo 生成完整规范文档
  2. 配置 CLAUDE.md 定义开发准则
  3. 在 Claude/Cursor 中提示:
请阅读 .ai/ 目录下的所有规范文档,
然后生成项目的初始代码框架。
  1. AI 基于规范 + 准则生成高质量代码
  2. 需求变更时,更新 Crevo 生成的规范,代码自动重构

从 Vibe Coding 到 Spec-Driven:这是 AI 编程的必经之路

2023 年,我们惊叹于 AI 能写代码。

2024 年,我们学会用 Vibe Coding 快速原型。

2025 年,我们需要规范驱动开发,让 AI 编程进入工程化时代

Crevo 不是要取代你的 AI 编程工具,而是为它们提供"大脑"——那些精确、完整、可执行的规范。

  • 当 Cursor 问你"想要什么功能"时,你有 Crevo 生成的 PRD
  • 当 Claude 需要理解架构时,你有 Crevo 生成的架构设计
  • 当你需要重构代码时,你只需更新规范,AI 自动重生成

这才是 AI 编程的终极形态:人类专注于意图表达和创造性决策,AI 负责将规范转化为代码。

规范先行,代码后置。

让我们一起进入 AI 编程的工程化时代


资源链接

🔗 官网:crevo.aurakl.ai/zh

📖 文档:crevo.aurakl.ai/zh/docs

💬 社区:加入 Discord 社区 discord.gg/ECXJ5z44

立即注册,获取 100 积分免费试用额度!

原文首发微信公众号:遨睿动态 : 规范先行,代码后置:让 AI 编程进入工程化时代

公众号二维码.jpg

关注微信公众号,发现更多优质内容,关于AI编程,行业洞察,crevo使用技巧,都在这里!