一、前言 什么是OpenSpec 流程化编程工具二、OpenSpec介绍OpenSpec 的威力什么是SDD有SDD 还有其他的DD是什么意思SDD的位置OpenSpec 特点模式介绍切换模型命令 openspec config set profile core / custom目录介绍核心文件介绍三、前置环境安装 ⚙️OpenSpec基于Node.js运行先安装Node环境再全局安装CLI工具。1. Node环境校验node-vnpm-v要求版本≥v20.19版本过低需重装Node。2. 全局安装OpenSpecnpminstall-gfission-ai/openspec3. 验证安装成功openspec--version输出版本号即代表安装完成✅初始化项目npx openspec init会多一些命令和skills用于当前项目使用四、项目实战完整标准工作流探索 → 提案规划 → 代码实现 → 归档沉淀一、/opsx:explore 需求探索前置调研核心作用纯思考、调研、梳理问题不生成任何文件仅做需求/技术预研适合需求模糊场景。语法/opsx:explore [调研描述]使用场景需求不清晰先和AI头脑风暴、梳理边界技术选型、风险评估、现有代码结构分析接手旧项目先梳理模块逻辑、历史坑点示例/opsx:explore 分析现有用户登录模块评估新增短信验证码功能的改动范围与潜在风险执行行为AI 只读项目代码输出分析报告、技术方案对比不会创建 openspec 目录文件仅对话输出。二、/opsx:propose 创建变更提案生成规范图纸核心作用正式发起功能变更自动创建独立变更目录一次性生成全套标准化设计文档是开发的“图纸阶段”。语法/opsx:propose [变更标识] [需求描述]使用场景需求调研完成、确认要开发新功能/修复Bug正式产出规格文档。示例/opsx:propose user-sms-login 给登录模块新增短信验证码登录功能支持60秒倒计时、验证码5分钟有效期自动生成文件目录openspec/changes/user-sms-login/proposal.md需求背景、业务目标、改动范围specs/功能规范、接口定义、入参出参、异常场景design.md技术架构、依赖、数据库/缓存方案tasks.md拆分好的可执行开发任务清单后续apply依据三、/opsx:apply 按规范实现代码落地开发核心作用读取tasks.md任务清单严格按照前面生成的规范文档编写代码不超范围开发。语法/opsx:apply [变更标识]使用场景评审完 proposal、spec、design 文档确认方案无误后执行编码实现。示例/opsx:apply user-sms-login执行行为逐条读取 tasks 任务逐个完成代码编写自动修改对应接口、实体、页面、工具类每完成一项自动在 tasks.md 勾选完成状态不会擅自新增规范外的逻辑约束AI开发边界四、/opsx:archive 归档完成变更沉淀全局规范核心作用功能开发自测完成后将本次变更的规范合并到项目全局主规范归档本次变更目录统一沉淀项目知识库。语法/opsx:archive [变更标识]使用场景功能开发、自测、联调全部完成准备合并代码、收尾迭代。示例/opsx:archive user-sms-login执行行为将本次变更 specs 合并至全局openspec/specs/项目统一规范源把当前变更文件夹移动至openspec/changes/_archived/归档更新项目总文档记录本次功能迭代记录清空活跃变更状态支持下一轮新需求开发完整标准实战流程示例模糊需求先调研/opsx:explore 调研短信登录实现方案确认方案生成全套规范文档/opsx:propose user-sms-login 新增短信验证码登录人工核对、修改spec/design文档后执行编码/opsx:apply user-sms-login自测完成归档沉淀规范/opsx:archive user-sms-login