OpenSpec 使用教程

OpenSpec 使用教程

OpenSpec 是一个用于 AI 编程的规范驱动开发(Spec-Driven Development, SDD)框架。它通过“先写规范再写代码”的方式,让 AI 编码工具(如 Cursor、Copilot、Claude Code)按照明确的需求生成代码,从而减少 AI 乱写代码的问题。 (OpenSpec)

下面给你一份 从安装到实际使用的完整入门教程


OpenSpec 的核心思想:

先写规范 → 再生成代码 → 再归档规范

这样 AI 写代码时就会严格按照规范执行,而不是根据随意的 prompt。 (GitHub)

典型流程:

  1. 创建功能变更(Change)
  2. 生成需求 / 设计 / 任务
  3. AI 按任务实现代码
  4. 完成后归档

需要 Node.js ≥ 20.19

检查版本:




claude code 教程或者


安装完成后测试:



进入你的项目目录:


初始化:


项目会生成一个目录:


这里的逻辑:

文件夹 作用 specs 当前系统功能规范 changes 新功能计划 AGENTS.md AI工作规则

例如新增 暗黑模式


会创建:


里面包含:



使用:


AI 会自动生成:

  • proposal.md(需求)
  • design.md(设计)
  • tasks.md(任务列表)

例如 tasks.md:



运行:


AI会按 tasks 一条一条完成代码。


功能完成后:


作用:

  • 更新 specs
  • 归档 change
  • 项目规范同步

例如开发一个 登录功能




生成:




执行:




系统规范更新。


命令 作用 openspec init 初始化项目 openspec update 更新 AI 指令 openspec list 查看 changes openspec view 查看规范 /opsx:new 创建 change /opsx:ff 生成规划 /opsx:apply 实现代码 /opsx:archive 归档

非常适合:

  • AI编程(Cursor / Claude Code)
  • 大型项目
  • 需要规范开发
  • 多人协作

不太适合:

  • 小脚本
  • 一次性代码

普通方式:


OpenSpec:


优点:

  • AI更稳定
  • 功能更完整
  • 不容易漏需求

💡 一句话总结

OpenSpec = 给 AI 写代码之前先写“产品需求文档”


如果你需要,我可以再给你:

  • OpenSpec + Cursor 完整实战教程(最常见)
  • OpenSpec 项目结构详解
  • 5分钟学会 OpenSpec 的完整 workflow
    这些会比官方文档更容易上手。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/275701.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月13日 下午3:33
下一篇 2026年3月13日 下午3:33


相关推荐

关注全栈程序员社区公众号