标签： OpenSpec

告别 Vibe Coding：Claude Code + OpenSpec + Superpowers 工程化 AI 编程实战

告别 Vibe Coding：Claude Code + OpenSpec + Superpowers 工程化 AI 编程实战

AI 编程工具正在经历从"玩具"到"工程工具"的质变。很多人用 Claude Code 写代码，感觉就是在"凭感觉编程"（Vibe Coding）——代码能跑，但质量全看运气。问题不在工具，而在工作流。

今天介绍一套经过实战验证的组合：Claude Code + OpenSpec + Superpowers，把 AI 编程从"看心情"变成"真工程"。

三件套各自的角色

在建筑行业，盖一栋楼需要三种人：建筑师画蓝图、工程师施工、监理盯质量。AI 编程也一样。

OpenSpec — 建筑师（定义做什么）

OpenSpec 解决的是"AI 不知道你要什么"的问题。它不是简单的需求文档，而是一套结构化的项目规范体系：

  • API 文档（接口长什么样）
  • 架构决策记录 ADR（为什么选这个方案不选那个）
  • 任务列表（先做什么后做什么）

核心思路：先写规范，再写代码。这不是什么新概念，但 AI 编程时代很多人跳过了这一步，直接让 AI 写代码，结果就是反复返工。

Claude Code — 工程师（负责实现）

Claude Code 的角色就是你的搭档工程师。它根据 OpenSpec 定义的规范来编码，不是凭空想象。它能理解整个项目框架，支持代码补全、重构、复杂结构分析。

关键是：有了规范约束，Claude Code 的输出质量会显著提升。 没有规范的 AI 编程就像没有设计图的施工队，想一出是一出。

Superpowers — 监理（保证质量）

Superpowers 是 Claude Code 的技能插件，提供质量保障能力：

  • 测试驱动开发（TDD）
  • 代码审查
  • 风格一致性验证
  • 性能调优建议

代价是会增加 Token 消耗，但这笔投入换来的是可维护的代码。想想看，你是愿意多花 20% 的 Token，还是愿意花 3 个小时 debug AI 写出来的面条代码？

五步落地流程

第一步：安装 Claude Code

macOS / Linux：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

安装后运行 claude 验证并登录。

第二步：安装 OpenSpec 和 Superpowers

OpenSpec 是独立命令行工具，在本地终端安装：

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

Superpowers 是 Claude Code 插件，在 Claude Code 交互界面中安装：

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

安装后重启 Claude Code。

第三步：项目初始化

进入项目目录，运行初始化：

cd /path/to/your-project
openspec init

初始化向导会引导你配置，关键步骤：

  • 集成工具选择 Claude Code
  • 按提示复制初始化提示词到 Claude Code 粘贴

完成后项目会生成：

  • openspec/ 目录（规范文件）
  • AGENT.md（AI 行为指引）
  • CLAUDE.md（Claude Code 配置）

第四步：OpenSpec 工作流

OpenSpec 定义了标准化的三阶段工作流：

阶段一：提案（propose）

/opsx:propose add-dark-mode

AI 会自动生成：

  • proposal.md — 提案概要
  • specs/ — 详细规格
  • design.md — 设计方案
  • tasks.md — 任务分解

每个任务都有明确的输入、输出和验收标准。

阶段二：实施（apply）

/opsx:apply

Claude Code 按照 tasks.md 逐步执行，每完成一个里程碑更新状态。

阶段三：归档（archive）

/opsx:archive

将完成的变更归档到 openspec/changes/archive/，更新文档，保持项目整洁。

第五步：Superpowers 质量保障

在实施阶段，通过 Superpowers 触发质量检查：

/openspec:apply

这会启动 Superpowers 的自动化工作流，包括代码审查、测试验证、风格检查等。

和纯 Vibe Coding 的对比

维度 Vibe Coding OpenSpec 工作流
需求定义 口头描述，模糊 结构化文档，精确
代码质量 看运气 TDD + 自动审查
可追溯性 没有 ADR + 任务记录
团队协作 难以复现 规范即文档
返工率 高 低
Token 消耗 看似少，实际多（反复修改） 看似多，实际少（一次做对）

这套方案适合谁

适合：

  • 需要交付可维护代码的项目
  • 团队协作（规范文档就是最好的沟通工具）
  • 长期迭代的项目（每次变更有记录）

暂时不需要：

  • 一次性脚本
  • 快速原型验证
  • 学习阶段的练手项目

我的补充思考

OpenSpec 的核心价值不是工具本身，而是强制你先想清楚再动手。这一点和传统的软件工程方法论一脉相承——需求分析、设计、编码、测试，AI 只是加速了每个环节，但没有跳过任何一步。

Superpowers 的质量保障能力确实会增加 Token 消耗，但这是值得的投资。AI 编程最大的成本不是 Token 费，而是你花在修复 AI 生成低质量代码上的时间。

最后，这套工作流还在快速演进中。OpenSpec 和 Superpowers 都在积极迭代，建议关注官方更新，及时升级。

工具链接：

Views: 0