同事：“Claude Code都能自动写代码了，还要什么Spec Coding？” 我反问：“屎山代码你来维护？”

处理同事：“Claude Code都能自动写代码了，还要什么Spec Coding？” 我反问：“屎山代码你来维护？”这类问题时，先确认目标场景，再按步骤核对配置或玩法细节。

OpenSpec简介与核心工作流

OpenSpec是一个面向AI编程的规范驱动框架，核心思想是"先对齐需求，再写代码"，目前在Github山已有53k+star。 每次功能变更会先生成提案、需求规格、技术设计和任务清单等规划文档，经人工确认后再让AI实现，让AI编程的结果更加符合预期。

OpenSpec核心的工作流主要包括如下：

1. /opsx:explore：进入探索模式，通过对话方式探讨需求，理清需求再动手。
2. /opsx:propose：生成规划制品，把需求写入规划文档，涵盖proposal+specs+design+tasks。
   1. proposal.md：变更提案，为什么要做和做什么。
   2. pecs/spec.md：需求规格，用结构化格式描述具体需求和验收场景。
   3. design.md：技术设计，描述技术实现方案。
   4. tasks.md：任务清单，列出实现步骤。
3. /opsx:apply：按按清单逐项实现，生成实际代码+tasks进度更新。
4. /opsx:archive：完成后归档存档，将规划文档移入archive目录。

下面是OpenSpec的工作流全景图，能清晰地描述流程及对应流程的产物。

安装及初始化

1. 使用npm命令来安装OpenSpec非常简单，使用如下命令即可安装；

npm install -g @studyzy/openspec-cn@latest

1. 安装完成后进入项目并初始化；

cd your-projectopenspec-cn init --tools opencode

1. 初始化完成后在项目中会创建openspec目录，用于存放规划制品，在OpenCode中还会添加opsx开头的命令；

1. 如果想打开仪表盘查看OpenSpec的变更可以使用如下命令；

openspec-cn view

使用

1. 使用OpenSpec的第一步，通过/opsx-explore命令进入探索模式，主要是通过纯对话的方式来理清需求；

1. 当我们提出需求后，OpenSpec会抛出几个问题，帮助我们确认项目需求的基本方向；

1. 基本方向确定好后，OpenSpec会给我们提供3个技术方案供我们选择；

1. 针对我们选择的技术方案，OpenSpec会提出几个关键设计点让我们选择；

1. 之后OpenSpec会设计好数据模型供我们确认；

1. 然后是几个自然浮现的话题；

1. 接下来是一些实现维度方面的问题；

1. 还有一些实现细节方面的问题；

1. 整个项目需求和技术方案都探讨的差不多了，OpenSpec会把项目的全貌发给我们看下；

1. 看了下没什么问题了，就可用opsx-propose命令生成规范制品了；

/opsx-propose init-project

1. 我这里的博客网站生成的规划制品如下；

1. 接下来就可以使用/opsx-apply命令开始执行任务了；

/opsx-apply init-blog-platform

1. 任务完成会输出任务完成总览；

1. 最后通过/opsx-archive命令来完成归档，此时之前生成的规划文档将移入archive目录。

总结

今天以博客网站的开发为例，给大家介绍了OpenSpec中核心工作流的使用，从需求探讨->规划文档生成->执行编码->归档。整体而言，OpenSpc只是增加了一层轻量的规范（spec）机制，让AI编程的结果更可控、更贴合项目实际，感兴趣的小伙伴可以尝试下它。

项目地址

1. 原版：github.com/Fission-AI/…
2. 中文版：github.com/studyzy/Ope…