OpenSpec 使用教程

科技前沿 • 2026-03-29 19:10 • 阅读 0

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

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

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

OpenSpec 的核心思想：

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

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

典型流程：

创建功能变更（Change）
生成需求 / 设计 / 任务
AI 按任务实现代码
完成后归档

需要 Node.js ≥ 20.19

检查版本：

或者

安装完成后测试：

进入你的项目目录：

初始化：

项目会生成一个目录：

这里的逻辑：

文件夹作用 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
这些会比官方文档更容易上手。

OpenSpec 使用教程

相关推荐