今日语录:
i人是E人的玩具
好了,开始!
事情的起因是我朋友请我给他的公司讲课。他的目标是如何在公司大型项目中应用AI编程。在我介绍之前,他也进行过很多尝试,但是结果不是很理想。所以我就帮他找到了一些解决方案完美的解决了他的问题。
其中有一个非常重要的重要插件OpenSpec,它是它是大型团队AI开发必备。
AI编程实在太爽了(一个人从 0~1 用 Vibe Coding 实在是太爽了。AI 大模型可以帮我用一天时间完成过去一个星期的工作量。)但是呢,以工程化的角度来说,我们大多数人写的程序都没有办法应用在生产当中。更提不上应用在大型的产品当中。
对于初学者来说,从零到1,感觉自己无所不能,但是从 1 到 N 或者是团队协作,就是他们下一阶段遇到的难点。这个时候就要给大家介绍一个新的概念,规范驱动开发。
规范驱动开发是一种以规范为中心的方法论,核心原则是:规范不仅是文档,更是可执行的开发契约。它强调:
- 规范即源码 – 规范文件是系统设计的权威来源
- 设计先行 – 详细设计在编码前完成
- 自动化驱动 – 工具链自动从规范生成代码、测试、文档
- 契约测试 – 确保实现严格遵循规范定义
今天会以 OpenSpec 这个开源规范驱动开发框架为例 给大家介绍和演示。个人开发者也可以使用 OpenSpec, 它可以帮你解决在需求不明确的情况下开发内容不可预测的问题,帮你解决开发大型 to B 项目下协作的问题。
它还有如下几个特点:
OpenSpec 官网 https://openspec.dev/
OpenSpec GitHub 页面 https://github.com/Fission-AI/OpenSpec
它有如下几个特点:
- 单点真实来源 (Single Source of Truth):一份 YAML 规范定义一切,杜绝了“代码改了文档没改”的屎山起源。
- 端到端类型安全:从 API 结构到数据模型,全链路自动生成,让 Bug 在编译阶段就无处遁形。
- AI 高度兼容:它天然就是为 AI 时代设计的。AI 极其擅长处理结构化数据,而 OpenSpec 提供了最完美的上下文边界。
(镜头转场:画面切到终端界面,准备运行 Claude Code)
好,废话不多说。既然我们提到了 Vibe Coding,那我们就用最先进的命令行 AI 工具——Claude Code(来自 Anthropic),来实操演示如何利用 OpenSpec 在几分钟内构建一个生产级别的模块。
(实操环节演示:Claude Code 窗口)
大家看,我现在甚至不需要打开 IDE。
第一步:定义规范。
我直接告诉 Claude:“帮我用 OpenSpec 语法定义一个用户订单系统的 API 规范。”
(动作:在终端输入指令,看到 Claude 快速生成
这时候,OpenSpec 就是我的“设计图”。
我直接告诉 Claude:“帮我用 OpenSpec 语法定义一个用户订单系统的 API 规范。”
(动作:在终端输入指令,看到 Claude 快速生成
.openspec.yaml 文件)这时候,OpenSpec 就是我的“设计图”。
第二步:自动化生成。
我只需要下令:“根据这个规范,生成对应的后端业务逻辑和前端类型。”
(动作:Claude 自动执行 OpenSpec CLI 工具,屏幕上疯狂跳动文件创建的路径)
这就是自动化驱动。代码不是我写的,也不是 AI 瞎编的,而是根据规范自动“长”出来的。
我只需要下令:“根据这个规范,生成对应的后端业务逻辑和前端类型。”
(动作:Claude 自动执行 OpenSpec CLI 工具,屏幕上疯狂跳动文件创建的路径)
这就是自动化驱动。代码不是我写的,也不是 AI 瞎编的,而是根据规范自动“长”出来的。
第三步:契约校验。
如果我尝试修改一个违反规范的字段,你会发现 OpenSpec 的校验工具会立刻报错。
这种契约测试的能力,确保了即便你的 AI 助手偶尔“幻觉”,它也跑不出规范划定的红线。
安装使用
通过 npm 安装
npm install -g @fission-ai/openspec@latest
初始化
在项目目录选择
openspec init
总结
所以你看,从 0 到 1 靠的是 Vibe(灵感),但从 1 到 N 靠的是 OpenSpec 这种工业级的秩序。
Claude Code 给了我们极致的交付速度,而 OpenSpec 给了我们掌控大型项目的底气。这套组合拳,就是现在个人开发者转型“超级开发者”的必经之路。
如果你也想告别毫无章法的开发流程,建议立即尝试 OpenSpec。
如果你已经看到这里,并且本视频也对你有了一点点帮助,麻烦点赞关注,这对我持续创作 AI 内容有很大的帮助。 Piece!
补充
它在处理大型 To B 项目时,有三个杀手锏:
- 强约束性:To B 业务逻辑复杂,OpenSpec 强制你先思考模型和边界,再写代码。
- 多语言协同:无论你的后端是 Java,前端是 React,还是中间件用 Go,一份 OpenSpec 规范可以生成全栈所需的 SDK。
- 零沟通成本:接口定义即文档,不再需要反复确认字段类型,规范就是团队唯一的真相。
现在,我们模拟一个典型的 To B 场景:构建一个带权限控制的“企业级资源审批系统”。
第一步:利用 Claude Code 进行架构映射
我直接对 Claude Code 说:“我要为一个大型 SaaS 平台设计审批流,请按照 OpenSpec 规范,帮我定义资源、角色和多状态流转逻辑。”
(动作:Claude 瞬间生成包含
这就是 设计先行,AI 帮我们把凌乱的业务需求变成了严密的逻辑结构。
我直接对 Claude Code 说:“我要为一个大型 SaaS 平台设计审批流,请按照 OpenSpec 规范,帮我定义资源、角色和多状态流转逻辑。”
(动作:Claude 瞬间生成包含
Security Schemas 和 Complex Objects 的 YAML 规范)这就是 设计先行,AI 帮我们把凌乱的业务需求变成了严密的逻辑结构。
第二步:解决多团队协作冲突
在 To B 开发中,前端最怕后端接口改动。
我现在让 Claude 模拟后端变更:“修改审批状态枚举值,并立刻同步更新前端的 TypeScript 类型定义。”
(PS:Claude 调用 OpenSpec 插件,一键更新所有关联文件)
通过 OpenSpec 的单点真实来源,前后端代码在毫秒级完成同步,彻底告别由于字段不匹配导致的生产事故。
在 To B 开发中,前端最怕后端接口改动。
我现在让 Claude 模拟后端变更:“修改审批状态枚举值,并立刻同步更新前端的 TypeScript 类型定义。”
(PS:Claude 调用 OpenSpec 插件,一键更新所有关联文件)
通过 OpenSpec 的单点真实来源,前后端代码在毫秒级完成同步,彻底告别由于字段不匹配导致的生产事故。
第三步:自动化生成测试契约
To B 客户对稳定性要求极高。我告诉 Claude: “基于 OpenSpec 规范,为所有 API 生成自动化契约测试用例。”
(PS:海量代码也可以稳定使用)
这些测试会自动验证代码实现是否严格遵循了规范契约。如果不符,CI/CD 根本无法通过。
To B 客户对稳定性要求极高。我告诉 Claude: “基于 OpenSpec 规范,为所有 API 生成自动化契约测试用例。”
(PS:海量代码也可以稳定使用)
这些测试会自动验证代码实现是否严格遵循了规范契约。如果不符,CI/CD 根本无法通过。
结论
在 To B 的世界里,“规范”就是生产力。
如果你厌倦了在复杂业务中救火,厌倦了无休止的接口对齐,那么 OpenSpec + Claude Code 就是你的“数字化手术刀”,帮你精准地切开复杂的架构难题。


