命令
/opsx:init 初始化 OpenSpec
/opsx:explore 进入探索模式，深入思考想法、调查问题、澄清需求
/opsx:onboard 引导式入门，通过叙述引导完成一个完整的OpenSpec工作流周期
/opsx:archive 在工作流中归档已完成的变更
实战实例：
1. openSpec下载
npm install -g @fission-ai/openspec@latest
2. 项目初始化化
| 指令 | 功能 | 产出 | 示例 |
|---|---|---|---|
| /opsx:init | 初始化 OpenSpec | 项目openspec 目录结构 | /opsx:init |
3. 需求分析
| 指令 | 功能 | 产出 | 示例 |
|---|---|---|---|
| /opsx:explore | 进入探索模式，深入思考想法，调查问题，澄清需求 | 通过代码分析，提供需求实现逻辑 | /opsx:explore 【需求描述】 |
4. **创建变更
| 指令 | 功能 | 产出 | 示例 |
|---|---|---|---|
| /opsx:new | 使用工件工作流(OPSX)创建新变更 | 创建一个新的变更 | /opsx:new comic-search |
接下来，AI会继续给自动生成以下文件，生成过程中会让你确认是否有问题
openspec/changes/comic-search/
├── proposal.md ← 为什么要做这个（空的，我们来填写）
├── design.md ← 如何构建它（空的）
├── specs/ ← 详细需求（空的）
└── tasks.md ← 实现清单（空的）
5. 执行任务
| 指令 | 功能 | 产出 | 示例 |
|---|---|---|---|
| /opsx:apply | 执行任务 | 代码AI自动编写 | /opsx:apply |
接下来IA开始实现tasks.md中的每个任务，你唯一做的就是review代码更改，确认修改即可
8. 变更归档
| 指令 | 功能 | 产出 | 示例 |
|---|---|---|---|
| /opsx:archive | 对确定完成的改动，可以将内容从 Changes 目录归档至Specs目录，让系统保持干净状态 | 归档文档 archive.md | /opsx:archive comic-search |
结论与展望
本文以CMS后台系统的开发需求为例，展示了基于SDD模式的具体开发流程，全程无人工Coding过程，只有代码审核确认过程，从需求描述到测试到上线，一次成功，展示了SDD的强大功能。值得注意的是需求的复杂度以及需求描述的准确性可能对整个过程产生一定的影响，比如代码实现不合理或者AI需求理解有误时，就不可避免的产生Vibe过程，这时候代码和文档会有一些一致性的偏差， 通过/opsx:verify 检测文档和代码的实现一致性，进行文档的更新确认。
OpenSpec 代表了 AI 辅助软件开发的一次重要成熟化演进，虽然 LLM 具备强大的代码生成能力，但缺乏维持长期架构一致性和业务逻辑完整性的内在机制。通过引入轻量级但严格的文件结构和状态机工作流（Proposal -> Apply -> Archive），OpenSpec 成功地将”直觉式编程”的随意性转化为可重复、可审计的工程过程。
对于致力于将 AI 深度整合进核心开发流程的团队而言，OpenSpec 提供了一个低成本、高回报的解决方案。它不仅解决了 Token 上下文限制和幻觉问题，更重要的是，它重新确立了”规格”在开发中的核心地位，代码只是实现的细节，而规格才是系统的灵魂。随着 AI 代理能力的进一步提升，像 OpenSpec 这样能够架起人类意图与机器执行之间桥梁的框架，将成为未来软件工业的基础设施。
