OpenSpec 是一个用于 AI 编程的规范驱动开发(Spec-Driven Development, SDD)框架。它通过“先写规范再写代码”的方式,让 AI 编码工具(如 Cursor、Copilot、Claude Code)按照明确的需求生成代码,从而减少 AI 乱写代码的问题。 (OpenSpec)
下面给你一份 从安装到实际使用的完整入门教程。
OpenSpec 的核心思想:
先写规范 → 再生成代码 → 再归档规范
这样 AI 写代码时就会严格按照规范执行,而不是根据随意的 prompt。 (GitHub)
典型流程:
- 创建功能变更(Change)
- 生成需求 / 设计 / 任务
- AI 按任务实现代码
- 完成后归档
需要 Node.js ≥ 20.19
检查版本:
claude code 教程或者
安装完成后测试:
进入你的项目目录:
初始化:
项目会生成一个目录:
这里的逻辑:
例如新增 暗黑模式:
会创建:
里面包含:
使用:
AI 会自动生成:
- proposal.md(需求)
- design.md(设计)
- tasks.md(任务列表)
例如 tasks.md:
运行:
AI会按 tasks 一条一条完成代码。
功能完成后:
作用:
- 更新 specs
- 归档 change
- 项目规范同步
例如开发一个 登录功能:
生成:
执行:
系统规范更新。
非常适合:
- AI编程(Cursor / Claude Code)
- 大型项目
- 需要规范开发
- 多人协作
不太适合:
- 小脚本
- 一次性代码
普通方式:
OpenSpec:
优点:
- AI更稳定
- 功能更完整
- 不容易漏需求
💡 一句话总结
OpenSpec = 给 AI 写代码之前先写“产品需求文档”。
如果你需要,我可以再给你:
- OpenSpec + Cursor 完整实战教程(最常见)
- OpenSpec 项目结构详解
- 5分钟学会 OpenSpec 的完整 workflow
这些会比官方文档更容易上手。
发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/275701.html原文链接:https://javaforall.net
